The content of the Preside documentation is our number one priority. This chapter deals with how the documentation content is organised and written and should provide a thorough reference for anyone wishing to contribute to the content of the docs.
The documentation system is largely based on the Grav static CMS. This system uses folders to represent pages, and markdown files within those folders to provide the page content.
All of the source files for this documentation can be found in the
/docs folder of the public repository; i.e. https://github.com/pixl8/Preside-Documentation/tree/master/docs
For more information on how the folder structure and various page types work, see [[docs-structure]].
The system uses markdown files to provide the bulk of the documentation.
In addition to plain markdown, we are also using the popular YAML front matter format to provide additional meta data for our pages (such as category tagging) and Python Pygments to provide syntax highlighting.
For more information on our "Preside-flavoured" Markdown, see [[docs-markdown]].
Documentation pages that provide pure reference material (i.e. internal Preside reference material) are 100% auto-generated and non-editable.