The web site of Sozi is a static site generated with Pelican. It does not provide an online editor where you could edit, preview and publish your contributions.
The source files of the site are text files using the Markdown syntax.
These files are hosted in the repository Sozi-website at GitHub, in the
content/ folder.
The content/pages/ folder contains
the documentation of Sozi.
It is divided into language subfolders (en
for English, fr
for French, etc)
containing Markdown files.
To start translating, we recommend following these steps:
- Fork the repository.
- Add a subfolder for your language in
content/pages/
, if it does not already exist. - If you want to translate a page, find the original English version in the
en
folder and create a new file with the same name in your language folder. - Edit the new file.
- Optionally, you can use Pelican to generate your own copy of the site and preview your modifications.
- When you are satisfied with the result, commit and push your changes to your GitHub repository and send a pull request to the official Sozi repository.
The header of a translated Markdown file should contain the following fields:
Title
: the title of the original page, translated to your language.Author
: comma-separated list of original authors and translators.Slug
: same as the original file.Lang
: the language code of the translation.Translation
: must be set totrue
.