||10 months ago|
|content||10 months ago|
|sass||11 months ago|
|static||11 months ago|
|templates||11 months ago|
|.gitignore||11 months ago|
|.gitlab-ci.yml||11 months ago|
|Readme.md||11 months ago|
|config.toml||11 months ago|
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:
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.
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.
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.