To fix a bug or add something new to this repository, you need to open a pull-request. Also, on every page of the site, there is an edit icon (pencil) to the right of the header.

• Put assets, custom HTMLs, scripts, and stylesheets to shared until they're language-specific
• Keep the navigation structure the same for all languages* so the language selector can work properly

After creating a new document, add it to the nav: block in the language-specific mkdocs.yml.

Documents are written in Markdown. Material for Mkdocs and Mkdocs docs might help you showing what blocks are supported.

All images, videos, and other assets must be uploaded to the assets folder.

We have some custom macros to embed "gifs" and videos.

To embed a "gif" (autoplayable silent MP4 video), use:

{{ gif("/assets/example-gif-file-name.mp4") }}

To embed a video, use:

{{ video("/assets/example-video-file-name.mp4") }}

To embed a Flipper Zero screenshot, use:

{{ screenshot("/assets/example-screenshot.png") }}

The screenshot should be 128*64 PNG with transparent background.

You can run mkdocs server locally and render changes on the fly while editing.

1. brew install yq rsync

2. Install mkdocs insiders version if you have a token:

   pip3 install git https://${GH_TOKEN}@github.com/squidfunk/mkdocs-material-insiders.git

   pip3 install mkdocs-macros-plugin mkdocs-git-revision-date-localized-plugin mkdocs-smart-meta-plugin

OR onstall public version

pip3 install mkdocs-material mkdocs-macros-plugin mkdocs-git-revision-date-localized-plugin mkdocs-smart-meta-plugin

3. Run python3 ./serve.py being in the root directory
4. Proceed to http://localhost:8000

P.S. If you use publoc version of mkdocs the live preview might look a bit different to production, because we use mkdocs-material-insiders version.

TODO

TODO