just-the-docs
gutenberg
just-the-docs | gutenberg | |
---|---|---|
17 | 107 | |
7,029 | 12,710 | |
1.6% | 1.3% | |
8.4 | 8.3 | |
10 days ago | 4 days ago | |
SCSS | Rust | |
MIT License | 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.
just-the-docs
-
Gojekyll – 20x faster Go port of jekyll
I think GitHub Pages only supports a whitelist of plugins, so you might have some more difficulties solving it well without any plugins. I use Netlify for my site, which does support arbitrary plugins.
One quick way to make it faster is to include that "_includes/nav.html" only in a nav.html, and then use an iframe to load that on every page, or something like that.
Anyway, I'm not the first to notice this it seems, although even "twice as fast" would still be quite slow: https://github.com/just-the-docs/just-the-docs/issues/1323
-
Having the rules and mechanics easily accessible in a webpage/site.
If it can help, there was a commenter earlier who suggested trying out a Doc-style github page that you can easily fork. It also has its own built-in search. Comment here. Github page here.
-
Looking for advice: does any one use GitHub/GitClassroom to store and mange their course content?
So the basic idea is I use the Jekyll site generator (which is already built into GitHub pages, but you can also install locally), and this is the theme I use: https://just-the-docs.github.io/just-the-docs/
- Is legit to use Github pages for non-coding purposes?
- Keep your diagrams updated with continuous delivery
-
Open Source Like
That's certainly an option. Games like Liminal Horror and Into the Dungeon Revived host versions on GitHub. You can then render it to a GitHub.io page using something like Just the Docs.
-
Compiling findings to website
The pages are written in markdown and the site has an in-built search feature. I am using the https://github.com/just-the-docs/just-the-docs jekyll theme.
-
Atlassian Patch Critical Confluence Hardcoded Credentials Bug
The only people that like confluence have Stockholm syndrome. I'd argue that a wiki is the old people way of thinking. In most orgs a wiki is where data goes to die but some asshole keeps throwing data in there to appease some other asshole. I rather search slack, https://github.com/just-the-docs/just-the-docs, project boards in github, anything is better than confluence and I couldn't agree more that confluence search is the biggest piece of shit ever, it's worse than useless, it wastes your time.
-
Ask HN: What do people use for documentation sites these days?
https://pmarsceill.github.io/just-the-docs/
Especially if you're already familiar with Jekyll. Bonus points for being able to deploy on GitHub Pages!
-
Tags-based documentation build (contextual documentation)
You can use 'Just the Docs' (https://github.com/pmarsceill/just-the-docs) for documentation - it's a Jekyll-based theme for documentation and has built-in search.
gutenberg
-
Building static websites
Case study 3: Zola
-
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.
What are some alternatives?
Read the Docs - The source code that powers readthedocs.org
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.
jekyll-theme-chirpy - A minimal, responsive, and feature-rich Jekyll theme for technical writing.
Nikola - A static website and blog generator
Docusaurus - Easy to maintain open source documentation websites.
Sapper - A lightweight web framework built on hyper, implemented in Rust language.
jekyll-docker - ⛴ Docker images, and CI builders for Jekyll.
Rocket - A web framework for Rust.
jekyll-theme-hamilton - A minimal and beautiful Jekyll theme best for writing and note-taking.
hakyll - A static website compiler library in Haskell