Lokales Bearbeiten der Anleitungen¶
Neben den genannten kleinen Ergänzungen freuen wir uns auch jederzeit über Menschen, die sich darauf einlassen, Teil des Teams zu werden und die Anleitungen auch lokal auf ihrem PC zu bearbeiten. Das erfordert etwas technische Vorarbeit und entsprechend größeres Engagement, belohnt jedoch durch die Befriedigung, wesentliche Spuren in diesem wichtigen Werk zu hinterlassen ;-)
Die folgenden Seiten geben einen sehr knappen Überblick über die Vorbereitungen und die Abläufe bei der Arbeit an den GLAREAN-Anleitungen. Wenn Sie an einer Mitarbeit interessiert sind, kontaktieren Sie uns bitte, und wir werden eine schnelle und praktikable Lösung finden.
Hintergrund¶
Die Webseiten dieser GLAREAN-Anleitungen werden mit dem »Static Site Generator« MkDocs sowie einigen speziellen für diesen Zweck entwickelten Anpassungen erstellt. Die angezeigten Seiten werden in Markdown verfasst, einer höchst einfachen Textauszeichnungsform, die - sofern keine besonderen Elemente erforderlich sind, ohne weiteres von jedem zu erlernen ist. Sehen Sie zum Beispiel, wie genau dieser Absatz in der Eingabedatei geschrieben wird - simpel, nicht wahr?:
## Hintergrund
Die Webseiten dieser GLAREAN-Anleitungen werden mit dem »Static Site Generator«
[MkDocs](https://www.mkdocs.org) sowie einigen speziellen für diesen Zweck
entwickelten Anpassungen erstellt. Die angezeigten Seiten werden in
[Markdown](https://markdown.de/) verfasst, einer höchst einfachen
Textauszeichnungsform, die - sofern keine besonderen Elemente erforderlich sind,
ohne weiteres von jedem zu erlernen ist. Sehen Sie zum Beispiel, wie genau
dieser Absatz in der Eingabedatei geschrieben wird - simpel, nicht wahr?:
Um die Anleitungen lokal zu bearbeiten und neue Seiten hinzufügen zu können, müssen Sie einige Tools installieren und einrichten, was aber nur geringes bis mittleres technisches Verständnis erfordert.
Um Ihre Änderungen in die Webseite zu integrieren, benötigen Sie darüber hinaus noch die entsprechenden Berechtigungen im Repositorium, die Sie von den Administratoren erhalten können.