This is the official Baguette website repository.
Go to file
southerntofu c3f38f3a12 Update README with contribution instructions 2020-03-29 21:25:56 +02:00
content Added a multilingual blog 2020-03-29 20:44:15 +02:00
sass Styling corrections, translations everywhere! 2020-03-29 21:16:51 +02:00
static Do some SASS-fu and import water.css for semantic markup styling 2020-03-29 19:17:37 +02:00
templates Styling corrections, translations everywhere! 2020-03-29 21:16:51 +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 with contribution instructions 2020-03-29 21:25:56 +02:00
config.toml Styling corrections, translations everywhere! 2020-03-29 21:16:51 +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

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