Documentation
The pages you are seeing at this moment right now is hosted on the JCM-Docs github repository. It is powered by Material for Mkdocs and uses the Markdown format for writing.
Adding new pages#
To add a new page, simply add a new markdown (.md) file in the relevant location within the docs
folder.
The navigation tree of this site is located in the nav
section within the mkdocs.yml
in the root folder.
As such, you also need to modify the relevant section in the yml to make your new page accessible in the navigation menu.
Custom pages#
Custom HTML templates (Like the Homepage we have) can be inserted by putting an ordinary html file to the overrides
folder. Then, add the following to the top of the markdown pages you want to apply to:
You can also dynamically insert html content as Mkdocs uses Jinja as its templating engine.
For an example, see:
docs/index.md
andoverrides/home.html
docs/nerds/neojcm/neojcm.md
andoverrides/neojcm.html
docs/players/blocks/index.md
andoverrides/blocks.html