Das Open Source Admin-Handbuch der Linuxfabrik

Der seit 2020-12-01 auf https://docs.linuxfabrik.ch verfügbare kleine Admin-Leitfaden ist keine umfassende Einführung in Linux, sondern hilft uns selbst, viele Aufgabenstellungen nach „Best Practice“-Manier zu lösen. Im Dezember werden wir wie bei einem Adventskalender symbolisch jeden Tag ein Türchen öffnen und ein weiteres Kapitel hinzufügen. Have fun!

Wie haben wir das gemacht?

Die Inhalte werden in der für uns gewohnten Umgebung direkt im Arbeitsfluss mittels Sublime und vim in rst-Dateien erfasst. „rst“ steht für „reStructured Text“ und bezeichnet eine Seitenbeschreibungssprache ähnlich zu Markdown, die jedoch wesentlich vielseitiger ist. Die einzelnen Content-Schnipsel finden dann Verwendung in unserem Blog, unserem internen Wiki, dem Admin-Handbuch, in „Powerpoints“ (die wir auch mit rst erstellen) usw. Für das Admin-Handbuch und unser Wiki nutzen wir Sphinx und das Theme „readthedocs“. Sphinx wandelt die rst-Dateien in HTML um, die dann auf dem Webserver abgerufen werden können.