So funktioniert dieses Handbuch

Das Handbuch ist eine statische Website: Jeder Artikel wird bereits vor der Veröffentlichung in vollständiges HTML umgewandelt. Dadurch bleibt der Client klein, die erste Seite lädt schnell und die Inhalte funktionieren auch bei deaktiviertem JavaScript.

Architektur

Hugo übernimmt Routen, Markdown, Inhaltsverzeichnisse, Sitemaps, Sprachvarianten und Metadaten. Das Projekt verwendet weder React noch Astro oder eine Komponentenbibliothek. Die Templates liegen in layouts/, die Styles in assets/css/main.css und die Artikel in den Sprachordnern unter content/.

Sprachvarianten

Englisch ist die Standardsprache und hat kein URL-Präfix. Russisch liegt unter /ru/, Deutsch unter /de/. Alle Übersetzungen teilen sich einen translationKey. Deshalb öffnet der Sprachumschalter denselben Artikel in der gewählten Sprache statt nur die Startseite.

Was im Browser läuft

Eine kleine Vanilla-JavaScript-Datei erfüllt zwei Aufgaben: Sie merkt sich das helle oder dunkle Farbschema und durchsucht einen lokalen JSON-Index. Navigation, Artikel und Sprachwechsel funktionieren auch ohne sie.

Inhalte aktualisieren

Bearbeiten Sie die passende Markdown-Datei in content/en, content/ru oder content/de. Legen Sie bei neuen Artikeln Varianten mit demselben relativen Pfad und translationKey an; Hugo verknüpft die Übersetzungen und erzeugt die passenden hreflang-Metadaten.