mdBook
gutenberg
Our great sponsors
mdBook | gutenberg | |
---|---|---|
100 | 106 | |
16,669 | 12,673 | |
2.8% | 1.9% | |
8.6 | 8.3 | |
13 days ago | 4 days ago | |
Rust | Rust | |
Mozilla Public License 2.0 | MIT 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.
mdBook
- Doks – Build a Docs Site
-
Ask HN: How do you organize software documentation at work?
I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.
-
Outline: Self hostable, realtime, Markdown compatible knowledge base
My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)
(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)
-
Ask HN: Best tools for self-authoring books in 2023?
If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.
- Early performance results from the prototype CHERI ARM Morello microarchitecture
- FLaNK Stack for 4th of July
- MdBook – A command line tool to create books with Markdown
- MdBook Create book from Markdown files. Like Gitbook but implemented in Rust
-
MdBook – Create book from Markdown files. Like Gitbook but implemented in Rust
Interesting enough there seems to be an open PR for that: https://github.com/rust-lang/mdBook/pull/1918
gutenberg
-
Replatforming from Gatsby to Zola!
So after shopping around a bit I found a simple, dependency-less static site generator called Zola. The lack of dependencies sounded very attractive after all the headaches trying to update my Gatsby modules. I wanted to give Zola a try and see what tradeoffs I would need to make coming form a React-based framework to this Rust-based generator.
-
Ask HN: What's the simplest static website generator?
I think you're thinking about Zola: https://github.com/getzola/zola
But yes, if I were to recommend something, it'd be Zola given that there's just one executable that you need to run and there's absolutely no setup required.
-
Ask HN: Looking for lightweight personal blogging platform
If I were to start again from scratch, I'd likely use Zola as SSG (https://www.getzola.org/)
- Zola – Single binary static site generator
- Zola
-
Ask HN: So, static website generators and hosting in 2023/24. What's out there?
I've used Zola (https://github.com/getzola/zola) for a static project homepage a few years ago to showcase examples with a simple description and a wasm app embedded in the page, it worked perfectly for me and the docs was clear on how to use it. It was very easy to set up along with a GitHub action to automatically update the wasm binaries when needed. It is definitely a tool I keep in my mental toolbox as a good default.
- Zola: Your one-stop static site engine
-
Gojekyll – 20x faster Go port of jekyll
I'm currently learning https://www.getzola.org/.
It's more manual than idy like but it's gonna be for a small personal and work website so I don't mind much.
It's super fast.
Doesn't seem to fit your use casr but still.
-
The right way to build a dynamic personal website for a physics student?
(Note: that list is overwhelming; you don't need to go through it. Order by popularity and look at the top 3-5 at most. Hugo, Jekyll, Gatsby... Personally I'm using Zola [ https://www.getzola.org/ ] for a couple of sites, but that's just me.)
What are some alternatives?
gitbook - The open source frontend for GitBook doc sites
Hugo - The world’s fastest framework for building websites.
MkDocs - Project documentation with Markdown.
eleventy 🕚⚡️ - A simpler site generator. Transforms a directory of templates (of varying types) into HTML.
Wiki.js - Wiki.js | A modern and powerful wiki app built on Node.js
Nikola - A static website and blog generator
bookdown - Authoring Books and Technical Documents with R Markdown
Rocket - A web framework for Rust.
obsidian-releases - Community plugins list, theme list, and releases of Obsidian.
Sapper - A lightweight web framework built on hyper, implemented in Rust language.
Docusaurus - Easy to maintain open source documentation websites.
hakyll - A static website compiler library in Haskell