Hallo,
wenn man an der Doku mitarbeiten möchte evtl. noch folgendes.
Die Infos auf https://github.com/contao/docs sind in erster Linie dazu gedacht die gesamte Doku lokal nachzubilden bzw. seine Änderungen dann auch direkt sehen/testen zu können bevor man diese einreicht.
Hierzu muß dann zunächst hugo installiert sein. Also die entsprechenden binaries laden und im Anschluß im jeweiligen OS System Pfad einbinden. Die hugo Befehle sind dann global verfügbar ( Alternativ gibt es auch node wrapper hierzu - z.B.: https://www.npmjs.com/package/hugo-bin ).
Auf das angesprochene Makefile ist man nicht zwingend angewiesen sollte "make" nicht installiert sein. Man kann auch die im Makefile enthaltenen hugo Befehle selbst ausführen:
Code:
cd page
hugo server --cleanDestinationDir --environment manual --destination ../build/manual
Grundsätzlich ist dies nicht notwendig ( aber hilfreich ) um an der Doku mitarbeiten zu können.
Letztlich benötigt man lediglich einen GitHub Account dazu. Im Anschluß kann man die Markdown files z.B. auch direkt in GitHub ( https://github.com/contao/docs/tree/master/docs ) bearbeiten ( für kleinere Typo Korrekuren geht das sicherlich ). Nach dem Speichern wird der Pull Request angestoßen. GitHub erstellt dann autom. einen fork des Contao docs repository im eigenen Account mit einem neuen branch ala "patch-1".
Das docs Team kann diese Änderungen dann einsehen und gegebenenfalls akzeptieren. Falls das Team hierzu Anmerkungen macht oder Änderungen verlangt könnt Ihr diese dann in dem branch ( e.g hier z.B. patch-1) eures fork machen. Ist der Pull Request dann geschlossen könnt ihr den temporären branch dann löschen ( oder das ganze fork repository ).
Optional könnte man sich den fork auch clonen und dann lokal mit der IDE der Wahl arbeiten. Hierzu muß dann aber git installiert sein und entsprechende Kenntnisse im Umgang mit git vorhanden sein.
Lesezeichen