FU-Übersetzung schreitet gut voran, Web-SRD läuft

Ich habe ja kürzlich schon einmal von unserer Übersetzung von FU berichtet. Die Arbeit geht gut voran und wir haben inzwischen alle Kapitel komplett rohübersetzt und Kapitel 1-4 (von 7) auch schon lektoriert.

Das Ding ist also komplett lesbar, wenn auch noch nicht komplett feinüberarbeitet. Daher habe ich auf Github ein Pre-release erstellt, um mal einen Meilenstein zu setzen.

Außerdem habe ich nebenbei an der Website für das Online-SRD (System Reference Document) gearbeitet. Ich habe mich ein bisschen von den SRDs von Fate Core/FAE und Lite inspirieren lassen und eine Site mit dem statischen Generator Hugo und dem Material docs-Theme erstellt, die sich (hoffentlich) responsiv an alle möglichen Geräte wie Smartphone, Tablet, Desktop anpasst. Wer Darstellungsfehler findet, darf sie gerne hier in den Kommentaren melden (oder mit Github-Account als Issue im Projekt anlegen).

Die ersten vier Kapitel sind schon eingepflegt und können bequem online gelesen werden.

Wer mehr zum technischen Kram (Git, Hugo und Themes) hören will, liest weiter, ansonsten springt direkt zur Seite!


Die Site wird über GithubPages (in einem eigenen Branch) gehostet und ist so direkt mit dem Repository des Übersetzungsprojekts verknüpft.

Das Web-SRD-Projekt war für mich eine ganz gute Lernerfahrung, denn mit GithubPages hatte ich noch nicht gearbeitet und jetzt weiß ich auch mit Subtree-Pushing umzugehen, um einzelne Verzeichnisse (das Ausgabeverzeichnis “public” der Website) selektiv von einem Branch (meinem Entwicklungsbranch “hugo”) in einen anderen zu pushen (den Standard-GithubPages-Branch “gh-pages”), nämlich aus dem hugo-Branch heraus mit:

git subtree push --prefix public origin gh-pages

Wer Hugo schon ein bisschen kennt und nicht weiß, wieso ein geklontes Theme-Repository nicht ins eigene Projekt gepusht wird (der Ordner ist leer), hier ein Tipp, für den ich auch eine Weile gebraucht habe: Repositories innerhalb anderer Repositories werden nicht einfach so übernommen. Es gibt aber die Möglichkeit, auch hier etwas mit Git zu zaubern - man bewegt sich in des Themes-Unterverzeichnis des Projekts und fügt dort das Unter-Repository als Submodul ein (den existieren Theme-Ordner falls nötig erstmal wieder löschen), fügt den neuen Ordner dann zum Projekt hinzu und pusht alles hoch:

git submodule add git@github.com:themeautor/themename.git
git add themes/themename
push origin

So wird eine .gitmodules-Datei angelegt, die die Informationen zu diesem Submodul enthält.
Wenn man das Projekt nun (z.B. am Zweitrechner) auscheckt, wird der Ordner dort aber erstmal noch leer sein. Um die Daten aus dem externen Theme-Repository tatsächlich ins Projekt zu bringen, muss man das Submodul noch initiieren und dann updaten, um die Daten auf den eigenen Rechner zu holen:

git submodule init
git submodule update

Jetzt ist es erstmal geschafft. Deine Hugo-Site benutzt jetzt immer das Theme in der Version (bzw dem Commit), in der du es zuerst als Submodul hinzugefügt hast. Das ist gut, denn so können Änderungen des Autors am Theme nicht potentiell deine Website kaputtmachen, wenn es Konflikte gibt. Aber was, wenn es Updates vom Autor gibt, die du für dich übernehmen willst? Ganz einfach, die kann man sich nun direkt von “Upstream” holen (mit dieser Zeile gleich für alle eventuell vorhandene Submodule gleichzeitig):

git submodule foreach git pull origin master

The Powered By FU logo is © Nathan Russell and is used with permission.

Teilen Kommentare
comments powered by Disqus