boost
MkDocs
Our great sponsors
boost | MkDocs | |
---|---|---|
8 | 111 | |
21 | 18,123 | |
- | 1.8% | |
1.5 | 9.0 | |
12 months ago | 3 days ago | |
C++ | Python | |
Boost Software License 1.0 | 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.
boost
- Full-Text Search has been added to the boost website. It looks into all the Boost libraries and their documentation.
-
The New Boost Website Goes Beta
But there is also another reason, before there is any change to the status quo in terms of boost.org we must have the prolonged open beta where things not only get finished but every Boost stakeholder such as library authors, maintainers, contributors, users, mailing list subscribers, and so on have the opportunity to see it, ask questions, and open issues.
We do not control boost.org, and putting this on a subdomain imputes an authority for decision-making we don't have. Building it on some temporary domains, then presenting it as a choice is the only approach compatible with Boost values.
-
Is it just me or is the quality of the Boost API docs just.. kind of terrible? Like compare it to cppreference (very good) or Qt docs (also great).
Not at all. There is no "they", the Boost Libraries is just a collection of individual libraries that each have their own author or maintainer, usually unpaid (although the C++ Alliance has changed that somewhat). The only funding that "Boost" gets is from running the C++Now conference, and some of that pays for the hosting of boost.org.
-
Boost down?
Though the links within it seem to be to boost.org and therefore fail to be resolved. Well I can manually replace them with https://www.boostcpp.org/ like:
- New Boost.Unordered containers have BIG improvements!
-
Ask HN: What Happened to Boost.org?
Oh wow, it behaves incorrectly...when I visit http://boost.org/ or https://... it shows spam on my side, whereas when I visit https://www.boost.org/ it works as expected.
-
Why I support GCC-rs
If you wondered why Boost headers look like hell that's because once your library ends up being popular, you're kinda stuck supporting quirky compilers -- either yourself, or accepting patches for it.
MkDocs
- 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
-
MkDocs Publisher as an alternative for official Obsidian publish.
For last few months, I was developing a set of plugins for MkDocs, that allows you to use GitHub Pages or GitLab Pages as a cheaper alternative to official Obsidian publish. Story behind this tool started quite long time a go, when I was using Nikola (static site tool for blogging) and Obsidian as a post editor. When Nikola stopped working for me on Apple Silicon (due to some problems with one of Python library) I started to look for a new tool. I couldn't find anything good enough and just started to work on my own plugin. From the first idea to current implementation, I build 5 plugins packed as a single Python library. As for Obsidian part, project currently supports:
-
Site-wide Protest, Introducing leagueoflinux.org, and Poll for What to do Next with r/leagueoflinux
The site is built using MkDocs and themed with MkDocs-Material. Being markdown-based, porting over the webpages from the subreddit wiki was fairly painless, and on some pages I've already been able to extend their capabilities with in-line images, buttons and more modern special formatting tools.
-
Ask HN: What is the best product documentation you’ve ever seen?
Visual Studio App Center has excellent documentation: https://learn.microsoft.com/en-us/appcenter/distribution/cod.... It's comprehensive and well structured.
If you're looking for a system that looks as good, mkdocs (https://www.mkdocs.org/) with the mkdocs-material theme (https://squidfunk.github.io/mkdocs-material/) can get you quite close!
-
Knowledge base system choice
I would also look at https://www.mkdocs.org for organising documentation esp if you are used to 'readthedocs' manuals.
What are some alternatives?
sphinx - The Sphinx documentation generator
pdoc - API Documentation for Python Projects
DocFX - Static site generator for .NET API documentation.
Hugo - The world’s fastest framework for building websites.
Docusaurus - Easy to maintain open source documentation websites.
BookStack - A platform to create documentation/wiki content built with PHP & Laravel
Read the Docs - The source code that powers readthedocs.org
mdBook - Create book from markdown files. Like Gitbook but implemented in Rust
Wiki.js - Wiki.js | A modern and powerful wiki app built on Node.js
VuePress - 📝 Minimalistic Vue-powered static site generator
mkdocs-material - Documentation that simply works
Pycco - Literate-style documentation generator.