MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YAML configuration file. Start by reading the introductory tutorial, then check the User Guide for more information.
Based on our record, MiddleMan should be more popular than MkDocs. It has been mentiond 11 times since March 2021. We are tracking product recommendations and mentions on various public social media platforms and blogs. They can help you identify which product is more popular and what people think of it.
Most of the Static Site Generators default to generating blog from markdown, which is not feasible for company websites etc. For such projects I like Middleman (https://middlemanapp.com) which provides layouts/partials and things like haml templates. - Source: Hacker News / 8 months ago
I've done similar with Middleman, and I'm 99% sure you could set this up with Pelican if you wanted. It sounds like the site generation workflow is the issue rather than the tool. Source: 12 months ago
I use middleman[^1] + bulmaCSS + FontAwesome but host on github using the `github.io` domain and upload podcasts to "archive.org"[^2]. The reason I choose this setup is because I want the content to survive as much as possible, hence open source technology and "free & long lived" hosting were requirements. [^1]: https://middlemanapp.com/ [^2]: https://archive.org/. - Source: Hacker News / over 1 year ago
Thanks u/Draegan88, but what's Middleman got to do with app architecture & design/ERD/schema design? Source: over 1 year ago
A simple middleman app consumes the data and builds a static export that runs standalone (just HTML, CSS and some JS files). That gets FTP'd/released to the webserver. Source: over 2 years ago
I'm a software engineer, and before getting my rM2, I kept all of my notes in Markdown format. They're under source control (git), and I use mkdocs to build them into a static website. I have a CI pipeline set up so that whenever I push changes to my notes to GitHub/Gitlab/Sourcehut, they are automatically built and published to my site. Source: about 1 year ago
Starlette is a web framework developed by the author of Django REST Framework (DRF), Tom Christie. DRF is such a solid project. Sharing the same creator bolstered my confidence that Starlette will be a well designed piece of software. - Source: dev.to / over 3 years ago
GatsbyJS - Blazing-fast static site generator for React
GitBook - Modern Publishing, Simply taking your books from ideas to finished, polished books.
Jekyll - Jekyll is a simple, blog aware, static site generator.
Doxygen - Generate documentation from source code
Hugo - Hugo is a general-purpose website framework for generating static web pages.
Docusaurus - Easy to maintain open source documentation websites