This is the official Baguette website repository.
Go to file
southerntofu 88dd168707 Date formats are localized and i18n has simple macros 2020-03-30 01:14:14 +02:00
content Removed summary markup in the post 2020-03-29 22:08:44 +02:00
sass Support pagination for the blog 2020-03-29 22:08:09 +02:00
static Do some SASS-fu and import water.css for semantic markup styling 2020-03-29 19:17:37 +02:00
templates Date formats are localized and i18n has simple macros 2020-03-30 01:14:14 +02:00
.gitignore First commit 2020-03-29 17:26:12 +02:00
LICENSE Initial commit 2020-03-29 11:23:58 -04:00
README.md Update README 2020-03-29 22:10:38 +02:00
config.toml Date formats are localized and i18n has simple macros 2020-03-30 01:14:14 +02:00

README.md

dnsmanager-website

Prototype for a dnsmanager homepage

Blog

Create a new article

Create a new folder in the content/blog/YEAR/ folder. index.md is the English version, with the extension prefixed by the language code for translations.

Each post has some TOML metadata attached. This is called a frontmatter, and the available variables are described in the Zola documentation:

+++
title = "My article"
date = 2020-03-29
+++

My article!

Post summaries

The post summary is taken from the first part of the article. If you add a <-- more --> tag, everything before that will be treated as the post summary.

Translations

How to add a new language

Adding a language is not hard, but it takes a few steps. The example here takes fr as language code for french translations, just replace it with your own language.

In config.toml:

  • declare the language in the languages variable: {code = "fr", rss = true}
  • translate the basic template strings in the translations section:
[translations.fr]
source = "Source de cette page"
readmore = "Lire la suite"

Now you can translate the Markdown pages in the content folder. The translated page should have the language code before the .md extension, like index.fr.md. The homepage is translated from content/_index.md, and some common parts (such as the navigation bar) are located in the content/_common folder.

Warning: don't forget to copy the placeholder section file for year-folders in the blog, otherwise no article will appear on your language's blog. You can safely copy content/2020/_index.md to, say, content/2020/_index.fr.md.

TODO

If something is missing for you, please open an issue.

  • blog
    • basic blog
    • pagination
    • summaries
  • i18n
    • pages
    • blogposts
    • other strings in the templates