manuel.kiessling.net
MkDocs
Our great sponsors
manuel.kiessling.net | MkDocs | |
---|---|---|
5 | 114 | |
2 | 18,257 | |
- | 1.6% | |
4.6 | 9.0 | |
about 2 months ago | 6 days ago | |
HTML | Python | |
GNU General Public License v3.0 or later | BSD 2-clause "Simplified" License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
manuel.kiessling.net
-
Ask HN: Could you show your personal blog here?
https://manuel.kiessling.net
Some personal favorites:
Applying The Clean Architecture to Go applications (2012):
https://manuel.kiessling.net/2012/09/28/applying-the-clean-a...
Object-orientation and inheritance in JavaScript: a comprehensive explanation (2012):
https://manuel.kiessling.net/2012/03/23/object-orientation-a...
Why developing software without tests is like driving a car without brakes (2011):
https://manuel.kiessling.net/2011/04/07/why-developing-witho...
Tutorial: Single Page Applications with a Serverless Backend and Infrastructure as Code (2021):
https://manuel.kiessling.net/2021/05/02/tutorial-react-singl...
-
Ask HN: Share Your Personal Site
https://manuel.kiessling.net
Covers topics on architecting, building, deploying and running software and systems for the web based on open source tools with lean methodologies.
-
Design of This Website
Sorry, that's not minimalism. gwern.net isn't either; I'd call that "brutalism" instead.
THIS is minimalism: https://manuel.kiessling.net
Precisely in the sense of "NOT a lot going on at all times". Just the content, presented pleasently.
And importantly, it's not only minimalism in look-and-feel, but also technically: even a long post with an embedded image like https://manuel.kiessling.net/2021/05/02/tutorial-react-singl... weighs in at under 200 KiB. Loads in under 3 seconds even on "slow 3G" in Chrome. 362 milliseconds via my office's wifi.
Also, no JavaScript. Nothing moves or jumps. Perfectly usable and consumable in a CLI browser like Lynx.
All of that without looking brutalist.
-
Technical blogging in the era of Stack Overflow
It’s also a great extension of a CV, at least I see my https://manuel.kiessling.net blog that way.
-
Small B Blogging (2018)
I have a very oldschool "FTP webspace" with Ionos (from 1&1) - it's really just your run-of-the-mill static website hosting package, basically unchanged since the late nineties.
Well, it surely changed a lot under the hood from the provider's perspective, I assume, but from the user's perspective, it works as it has always worked: you have a domain, you have an (S)FTP account, you upload your static HTML/CSS files, et voilá, you have a homepage/blog.
I create my HTML/CSS locally using Hugo. The source for my homepage and its blog posts can be seen at https://github.com/manuelkiessling/manuel.kiessling.net.
Super simple, no headaches, no downtimes. Less than 4 bucks per month.
I do depend on Ionos, of course, but as it's only HTML and CSS, it with every web site hosting solution on the planet.
I also depend on Hugo, of course, but Hugo is open source, and I've even stored the Hugo binaries for different platforms locally.
My homepage is at https://manuel.kiessling.net/.
MkDocs
- I am stepping down from MkDocs
-
Alternatives to Docusaurus for product documentation
MkDocs is BSD-2-Clause licensed and has a vibrant community; GitHub Discussion is used for questions and high-level discussion, while the Gitter/Matrix chat room is used to discuss less complex topics. These communities provide essential resources and support.
- Ask HN: Tips to get started on my own server
-
Enhance Your Project Quality with These Top Python Libraries
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.
-
Top 5 Open-Source Documentation Development Platforms of 2024
MkDocs is a popular static site generator designed explicitly for building project documentation. Its minimalist approach, flexibility, and ease of use have made it a favorite among developers and ideal for non-technical users.
-
5 Best Static Site Generators in Python
MkDocs is a popular static site generator specifically designed for project documentation. It is built on Python's Markdown processing engine and comes with a clean and responsive default theme. MkDocs is easy to configure, and its simplicity makes it an excellent choice for quickly creating documentation for your projects.
-
Creating a knowledge base website for work, do I need a database or can it be only front end designed?
Take a look at https://www.mkdocs.org
- MdBook – Create book from Markdown files. Like Gitbook but implemented in Rust
-
Examples with Github Pages?
I was thinking about using MkDocs, its usually used for documentation but I don't see why it couldn't be used for a normal wiki aswell. Since It's markdown you can just customize it like if it were a wiki, and a wiki doesn't really need backend stuff so I don't see a problem with it
What are some alternatives?
Tufte CSS - Style your webpage like Edward Tufte’s handouts.
sphinx - The Sphinx documentation generator
gwern.net - Site infrastructure for gwern.net (CSS/JS/HS/images/icons). Custom Hakyll website with unique automatic link archiving, recursive tooltip popup UX, dark mode, and typography (sidenotes+dropcaps+admonitions+inflation-adjuster).
pdoc - API Documentation for Python Projects
commento - A fast, bloat-free comments platform (Github mirror)
DocFX - Static site generator for .NET API documentation.
beepb00p - My blog!
Hugo - The world’s fastest framework for building websites.
breckyunits.com - Breck Yunits' Blog
Docusaurus - Easy to maintain open source documentation websites.
digital-gardeners - Resources, links, projects, and ideas for gardeners tending their digital notes on the public interwebs
BookStack - A platform to create documentation/wiki content built with PHP & Laravel