Menu Ordering

[nuxt-themes]

Menu Ordering

[Atinux]

This is indeed something to consider, I thought we had categoriesPosition.

I think the easiest way would be to have a sidebar option in settings.json, what do you think @benjamincanac ?

[pi0]

I would also like to know your ideas regarding naming convention for ordering. It has advantage that visually ordering is visible in file-explorer and it should be also easy to implement:

• Always sort by file name
• Remove \d+\. prefix for generating title and url

Benefit of sidebar options we have full control over menu rendering and can also hide some pages that only internally need reference

[Atinux]

I like the idea of naming convention but I also believe that using prefix with 1.my-file.md will lead to same issues:

• Adding a file in-between will lead to renaming a bunch of files
• We need to support inside content a way to rename the slug to remove the prefix, might be possible with a hook

Regarding hiding some pages, I worked on a draft option directly that works well, we could also support it with filename too: 02.not-done.draft.md for example.

I would vote for convention over configuration for sure, only thing to know is how hard would it be to implement 😀

[pi0]

Adding a file in-between will lead to renaming a bunch of files

Well this is also implied by having position prop since adding a new file requires updating all positions for disired orderer

We need to support inside content a way to rename the slug to remove the prefix, might be possible with a hook

Yeah either a hook or even rumtime method (like normalizeSlug) might do the trick to reemove prefix. Only need a way to ensure content are sorted since i think content module currently does not do this

Regarding hiding some pages, I worked on a draft option directly that works well, we could also support it with filename too: 02.not-done.draft.md for example.

Nice idea for draft flags! Reminder maybe we should consider _* ignore pattern?

[Atinux]

I thought about the _* pattern but then it may be more confusing with the prefix

[Atinux]

This could be nice to explore in order to remove the position attribute for pages, do you mind taking a look at how it is achievable @farnabaz ?

[farnabaz]

I looked at Docus and Content module, the implementation of both draft and order convention seems straightforward.
Documents can modify using content:file:beforeInsert hook. Thedraft and position can extract from file name and slug should update.

For now Docus use document path for fetch them on _.vue.

// https://github.com/nuxtlabs/docus/blob/main/theme/pages/_.vue#L44-L45
 const path = `/${app.i18n.locale}/${params.pathMatch || 'index'}`
 const [document] = await $content({ deep: true }).where({ path }).fetch()

With this changes fetching document with path will be hard work and dir + slug should be used.

const dir = `/${app.i18n.locale}`
const slug = params.pathMatch || 'index'
const [document] = await $content({ deep: true }).where({ dir, slug }).fetch()

[Atinux]

Using dir + slug looks good to me :)