Go to https://jomjol.github.io/AI-on-the-edge-device-docs to use it.
This repo contains the documentation for the AI-on-the-Edge-Device Project.
- You can edit any
*.md
document in the docs folder. - Then create a Pull Request for it to merge it into the
main
branch (or edit it directly in themain
branch if you have the required rights). - When it got merged, the Github Actions will re-generate the documentation and place it in the
gh-pages
branch. This branch automatically gets populated to the public Documentation Site
Each page has a link on its top-right corner Edit on GitHub
which brings you directly to the Github editor.
- Add a new
*.md
document in the docs folder. - Add the filename to the docs/nav.yml at the wished position in the Links section.
Each parameter which is listed in the configfile in the main project repo
has its own description page in the folder param-docs/parameter-pages
(grouped by the config sections).
Those pages can be edited as needed.
The script concat-parameter-pages.py
in param-docs
should be run whenever one of the pages changed.
This happens automatically in the Github action.
It then concatenates all pages into the single ../docs/Parameters.md
which gets be added to the mkdocs
documentation.
The script generate-template-param-doc-pages.py
should be run whenever a new parameter gets added to the config file.
It then checks if there is already page for each of the parameters.
- If no page exists yet, a templated page gets generated.
- Existing pages do not get modified.
If the parameter is listed in expert-params.txt
, an Expert warning will be shown.
If the parameter is listed in hidden-in-ui.txt
, a Note will be shown.
Boxes can be shown using the admonition extension.
!!! Note
I am a note
Make sure to have 4-whitespace Intents!
Possible types: attention, caution, danger, error, hint, important, note, tip, and warning
See https://python-markdown.github.io/extensions/admonition/
To test it locally:
-
Clone this repo
-
Install the required tools (See also .github/workflows/build-docs.yaml):
pip install --upgrade pip pip install mkdocs mkdocs-gen-files mkdocs-awesome-pages-plugin mkdocs-material pymdown-extensions
-
In the main folder of the repo, call
mkdocs serve
(and keep it running). This will locally generate the documentation. You can access it under http://127.0.0.1:8000/AI-on-the-edge-device-docs/Any change to the files will automatically be applied.