Vorneweg: Alle Frage zu diesem Thema bitte ausschließlich an mich bitti hier im Forum oder auf dem Chatserver !!!
Grund der Projektenstehung: Anhaltender Mangel (bzw nichtvorhandensein) an/von deutschen Anleitungen für Xiaomi Geräte sowie dem MIUI System
Projektgrundlage: Mkdocs
Wer kann mitmachen: Alle die einen Github Account haben und bereit sind sich in die Markdown "Sprache" einzulesen (wird u.a. auf Github für README's genutzt)
Kenntnisse von Jekyll sind von Vorteil (Wer Github Pages nutzt hat Sie schon)
Ausführlich:
Wer mithelfen will für das kommende MIUI8 sowie den bereits veröffentlichten Xiaomi Geräte deutsche Anleitungen zu schreiben, kann dies am ca mogen Mittag tun.
Benötigt wird nur ein Github Account sowie Grundkenntnisse der Markdown "Sprache" .
User die schon etwas mehr Kenntnisse mit Github haben können das unten verlinkte Repo auch clonen und die Änderungen mit einem Editor Ihrer Wahl machen (z.B. Atom) und anschließend einen Push Request erstellen.
Bitte für jede größere Änderung einen eigenen Push Request erstellen.
Preview:
Live: https://docs.miui-germany.de/
Source: https://github.com/MIUI-GER/docs-miui8
Wer fragen hat kann sie via PM an mich , hier im Thread als Antwort oder im docs Kanal auf dem Chatserver (Google/Github oder Gitlab Account erforderlich zum Login) stellen.
Technisches:
Die einfache Änderung über ein Github Repo wird durch die vor Längerer Zeit durchgeführte Umstellung unseres Servers von Hiawatha auf Caddy ermöglicht. :
1. Der Webserver überprüft alle 60min das Github Repo auf eine Änderung.
2. Gabs eine Änderung, wird die Geänderte Datei heruntergeladen und der Jekyll Befehl zum generieren der HTML Version gestartet.
3. Die generierten html Dateien werden vom mkdocs Prozess in den unter https://docs.miui-germany.de/ erreichbaren Ordner kopiert.
Aufbau:
/index.md -> Startseite
/miui/Miuiversion/*.md -> Wird zu /miui(miuiversionsnummer)/* -> z. B. /miui8/*
/geräte/Gerätename/*.md -> Wird zu /Gerätename/* -> z.B. /mi1/*
Hinweise:
Alle Dateien müssen die .md Endung besitzen.
Änderung an den Dateien im _Layout oder _data Ordner nur nach vorheriger Absprache (betrifft vorwiegend die Einträge des Header Menüs sowie der Sidebars)
Infos zu den Formatierungsmöglichkeiten des Jekyll Styles: http://idratherbewriting.com/documentation-theme-jekyll/