search

lukasgeiter / mkdocs-awesome-pages-plugin

An MkDocs plugin that simplifies configuring page titles and their order
MIT License
472 stars 36 forks source link

Support <title>: <file.md|directory> a la nav in arrange? #14

Closed vicaya closed 4 years ago

vicaya commented 4 years ago

.pages.arrange is a convenient layout overriding mechanism. It'd be great if you can make it work a little more like the nav directive. e.g.

arrange:
  - Home: README.md
  - Background: background-materials-directory

The first form (<title>: <file.md>) is identical to nav. The second form would save us from having to create a .pages file with a title directive just to override the directory title.

andrzejwp commented 4 years ago

+1 on this

timvink commented 4 years ago

+1 :). Helps to separate content (nav) from config (rest of mkdocs.yml). Ideally I would just copy/paste the nav section to .pages

ash-g-1337 commented 4 years ago

+1

lukasgeiter commented 4 years ago

Hi everyone! I've just released v2.3.0 which brings the nav attribute to the .pages file. Like you've suggested, it works the same way as the one from mkdocs.yml, allowing you to specify titles, add links and more. See the updated README for details.

timvink commented 4 years ago

Awesome, thanks!