MkDocs_MiSTer
https://MiSTer-devel.github.io/MkDocs_MiSTer/
MiSTer FPGA Documentation built in Material for MkDocs.
Useful resources
- https://www.markdownguide.org/tools/mkdocs/ - Good guide on how to use markdown in mkdocs.
- https://www.mkdocs.org/user-guide/writing-your-docs/ - MkDocs reference
Software used
- https://squidfunk.github.io/mkdocs-material/ - The static site generator used for this documentation site. (MIT License)
- https://github.com/byrnereese/mkdocs-minify-plugin - Minify plugin used. (MIT License)
- https://github.com/datarobot/mkdocs-redirects - Redirects plugin used. (MIT License)
- https://github.com/soulless-viewer/mkdocs-video - Embedded video plugin used. (MIT License)
- https://github.com/timvink/mkdocs-git-revision-date-localized-plugin - Git revision date plugin used. (MIT License)
- https://github.com/Guts/mkdocs-rss-plugin - RSS plugin used. (GPL 3.0 License)
Instructions for deploying a local environment
Prerequisites:
- Python 3
- Pip
Make sure you update python 3 and update pip. Then, cd into the root folder of this repo and install the requirements:
pip install -r requirements.txt
Deploy to local server from that root folder:
mkdocs serve
And it should give you a weburl in the terminal to go to --> http://127.0.0.1:8000
Note: video files are stored in a separate branch named videos. This is to make it easier to clone quickly with the command git clone --depth 1 https://github.com/MiSTer-devel/MkDocs_MiSTer.git. Thanks to @agg23 for the suggestion.
Credits
Huge thanks to @tofukazoo (Jorge González) for helping me with the initial GitHub automation, lots of conceptual brainstorming, important early-stage debating, and finally the motivation and encouragement to get this project going!
Thanks to @Kitrinx, @sentientsix, @alanswx, @MiSTerAddons, @Tonurics, @theypsilon, and many more for so much help and advice with the content written and with the initial layout!
Thanks to @hewhoisred for supplying art and giving expert UI design and aesthetics advice!
Thanks to Conrad Fenech for the logo design!
Thanks to @sorgelig (Alexey Melnikov) for all of his amazing hard work on the MiSTer FPGA project that we all are so happy to enjoy!