deprecated; docs were moved to be in-tree in the haccfiles instead
This repository has been archived on 2024-01-30. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
schweby 86d787a2d4
acme: init & add info about .lego
this serves mostly as reminder that .lego exists
2022-01-26 18:31:19 +01:00
content acme: init & add info about .lego 2022-01-26 18:31:19 +01:00
sass initial proof of concept 2022-01-05 22:10:25 +01:00
static initial proof of concept 2022-01-05 22:10:25 +01:00
templates display subsections in index.html 2022-01-06 17:14:59 +01:00
.gitignore initial proof of concept 2022-01-05 22:10:25 +01:00
.gitlab-ci.yml initial proof of concept 2022-01-05 22:10:25 +01:00
config.toml documentation's documentation 2022-01-05 23:48:25 +01:00
Readme.md documentation's documentation 2022-01-05 23:48:25 +01:00

Markdown docs with zola.

Zola is a static site generated written in Rust (which you'll notice since sometimes it panics).

To run the site locally:

zola serve

Directory Layout

All the important stuff goes into content. If you create subdirectories, make sure you remembered to also create an _index.md file for it (if in doubt, just copy the one at content/_index.md); otherwise pages in there won't work.

templates is not for site templates, but specifies how markdown files should be turned into html. If an autogenerated link broke, you'll probably have to change something in there. sass and static do exactly what they sound like.

It usually shouldn't be necessary to change config.toml, but if it is, here is the list of all available options.

File Layout

Markdown files start with a frontmatter that should look something like so:

+++
title = "blåhaj"
taxonomies.categories = [ "flausch" ]
+++

[actual markdown goes here]

The frontmatter is TOML; the taxonomies.* keys are special and can be used to aggregate posts if enabled in config.toml (currently that's only the case for categories, though). See also the list of all available keys.

Please don't repeat the page's title in markdown, otherwise it'll appear twice in the html.