daux.io/docs/01_Features/Navigation_and_Sorting.md
2017-11-08 21:49:30 +01:00

1.5 KiB

Navigation

The navigation is generated automatically with all pages that end with .md or .markdown

You can have as many sub levels as you wish.

By default, a folder will have no index page. if you wish to have one defined all you need to do is add an index.md file to the folder. For example, /docs/02_Examples has a landing page for that section since there exists a /docs/02_Examples/index.md file.

Sorting

To sort your files and folders in a specific way, you can prefix them with a number and underscore, e.g. /docs/01_Hello_World.md and /docs/05_Features.md. This will list Hello World before Features, overriding the default alpha-numeric sorting. The numbers will be stripped out of the navigation and urls. For the file 6 Ways to Get Rich, you can use /docs/_6_Ways_to_Get_Rich.md

You might also wish to stick certain links to the bottom of a page. You can do so by prefixing the file name with a '-', e.g. a new file /docs/-Contact_Us.md will always appear at the bottom of the current list. Weights can also be added to further sort the bottom entries. e.g. /docs/-01_Coming.md will appear before /docs/-02_Soon.md but both will only appear after all positive or non-weighted files.

It works the same for files prefixed with +.

Page order priorities are like this:

  • + in front of the filename and numbers in front
  • + in front of the filename
  • The index page
  • Numbers in the front
  • Pages without prefix
  • - in front of the filename and numbers in front
  • - in front of the filename