Die Web Site von Sozi ist eine statische Site und wird mit Hilfe von Pelican generiert. Sie hat keinen Online-Editor.
Die Quelldateien der Site sind Text-Dateien in einfacher Markdown-Syntax.
Diese Dateien liegen im Repository der Sozi-website auf GitHub, im Verzeichnis
content/.
Im Verzeichnis content/pages/ liegt die Dokumentation von Sozi.
Die jeweiligen Markdown-Sprachdateien liegen in Unterverzeichnissen – en
für Englisch, de
für Deutsch usw).
Wenn Du mit dem Übersetzen beginnen möchtest, dann empfehlen wir die folgende Vorgehensweise:
- Fork das Repository.
- Erstelle ein Unterverzeichnis für Deine Sprache in
content/pages/
, falls dieses noch nicht existiert. - Finde die Seite, die Du übersetzen möchtest im
en
-Verzeichnis und kopiere sie mit dem gleichen Namen ins Verzeichnis mit Deiner Sprache. - Übersetze die Seite.
- Du kannst, musst aber nicht, eine Vorschau der Seite mit einer eigenen, lokalen Pelican-Installation ansehen.
- Wenn Du mit der Übersetzung zufrieden bist, dann
commit
undpush
Deine Änderungen in Dein GitHub Repository und sende einenpull request
ans offizielle Sozi Repository.
Der Header der übersetzten Markdown-Dateien sollte diese Deklarationen enthalten:
Title
: den Titel der Seite, übersetzt in Deine Sprache.Author
: Autor des Originals und Übersetzer, mit Komma getrennt.Slug
: das Slug der Original-Datei, unverändert.Lang
: den Sprachcode der Übersetzung, z.B. de.Translation
:true
.