Naming conventions

Pagegen uses the file or directory name to determine the final page title, URL and optionally menu sort order. The page path is used to create the final page URL.

Note

Name syntax: <sort order>_<title>[.extension]
Example: 020_About us.html

Warning

The following names are reserved for Pagegen use, and cannot be used:

  • /sitemap.txt
  • /sitemap.xml
  • /assets

Title

The page title will become the file or directory name without the sort order or extension (unless overridden using Title header, see below). The title can contain any legal file name character, except a period(.).

Sort order

Pages are sorted in the menu by listing them alphabetically, to override the default sort files and directories can be prefixed by integers followed by an underscore. The sort prefix will be stripped from the title and URL.

Tip

A good practice is to use increments of 10 when setting the sort prefix (010_, 020_, 030_ etc.). This means an item can be added in the sequence with for instance 011_ without having to rename all items.

Extension

An extension is optional and is left as is. Directory index files can also have extensions.

Page URLs

The page URL will be the path from the content directory to the file, converted to lower case. Where sort prefix is removed and all characters that are not a-z, 0-9, dash(-), underscore(_) or period(.) are replaced with dash(-), file extensions are kept, if they are present.

Name Title URL
content/Fruit juice Fruit juice /fruit-juice
content/fruit juice+ice Fruit juice+ice /fruit-juice-ice
content/0001_Fruit juice Fruit juice /fruit-juice
content/0001_Fruit juice.html Fruit juice /fruit-juice.html
content/002_Fruit juice/index.html Fruit juice /fruit-juice/