Einleitung¶
Sie können das Dokumentationssystem auch lokal ohne Docker oder LXD erstellen, wenn Sie möchten. Wenn Sie sich jedoch für dieses Verfahren entscheiden, beachten Sie, dass Sie bei viel Python-Codierung oder lokaler Verwendung von Python am sichersten eine virtuelle Python-Umgebung erstellen, die hier beschrieben wird. Dadurch bleiben alle Ihre Python-Prozesse voneinander geschützt, was zu empfehlen ist. Wenn Sie sich für diese Vorgehensweise ohne die Python Virtual Environment entscheiden, sollten Sie sich darüber im Klaren sein, dass Sie damit ein gewisses Risiko eingehen.
Prozedur¶
-
Klonen Sie das Repository docs.rockylinux.org:
git clone https://github.com/rocky-linux/docs.rockylinux.org.git -
Nach Abschluss des Vorgangs wechseln Sie in das Verzeichnis docs.rockylinux.org:
cd docs.rockylinux.org -
Klonen Sie nun das Dokumentations-Repository mit folgendem Befehl:
git clone https://github.com/rocky-linux/documentation.git docs -
Installieren Sie als Nächstes die requirements.txt-Datei für mkdocs:
python3 -m pip install -r requirements.txt -
Starten Sie abschließend den mkdocs-Server:
mkdocs serve
Zusammenfassung¶
Dies bietet eine schnelle und einfache Möglichkeit, eine lokale Kopie der Dokumentation ohne Docker oder LXD auszuführen. Wenn Sie sich für diese Methode entscheiden, sollten Sie unbedingt eine virtuelle Python-Umgebung einrichten, um Ihre anderen Python-Prozesse zu schützen.
Author: Lukas Magauer
Contributors: Steven Spencer, Ganna Zhyrnova