Die Website wird mit Hugo erstellt. Hugo ist ein statischer Site-Generator, der Markdown-Sites und -Vorlagen verwendet, um statische Websites zu kompilieren.
Klonen Sie das Projekt: git clone https://github.com/judaicalink/judaicalink-site.git .
Gehen Sie in das Verzeichnis: cd judaicalink-site .
Installieren Sie Hugo (siehe unten).
Laden Sie einfach die ausführbare Hugo-Datei herunter (aktuell verwendete Version auf dem Server: 0.104.3).
Sie müssen Hugo in Ihren Umgebungsvariablen unter PATH hinzufügen:
Zum Beispiel: C:BenutzerIhrNamehugo_0.31.1_Windows-64bit
Um zu überprüfen, ob die Installation funktioniert hat, können Sie hugo help in die Eingabeaufforderung eingeben. Sie sollten eine Antwort erhalten, die mehrere Befehle enthält, die Hugo ausführen kann.
-> Für detailliertere Anweisungen sehen Sie sich die Anleitung an, die Hugo unter Installationsanleitung für Windows bereitstellt
Gehen Sie in Ihrer Eingabeaufforderung in das Hauptverzeichnis des geklonten Repositorys (wo sich diese README.md-Datei befindet) und führen Sie den Befehl hugo server aus.
Zum Beispiel: C:BenutzerIhrNamejudaicalink-site>hugo server
Anschließend können Sie die Website lokal unter http://localhost:1313 durchsuchen
Ubuntu: sudo apt update && sudo apt install hugo .
Bogen: sudo pacman -S hugo .
Fedora, RedHat: sudo pacman -S hugo
Überprüfen Sie die Installation mit: hugo --version .
Installieren Sie Hugo mit brew brew install hugo .
Überprüfen Sie die Installation mit: hugo --version .
Servieren Sie Hugo mit hugo serve direkt auf Ihrem lokalen Automaten. Es öffnet sich ein Webserver. Überprüfen Sie das Terminal auf Link und Pfad.
Überprüfen Sie auch auf Fehler.
Wenn Sie die Quelle kompilieren und eine Live-Site erstellen möchten, führen Sie einfach hugo aus.
Dadurch werden die static Dateien und der public Ordner generiert.
Wenn Sie die Sites in einem bestimmten Ordner kompilieren möchten, verwenden Sie einfach: hugo -d <your-destination> .
Jetzt können Sie die Seiten mit einem Webserver wie Apache2 oder NGINX bereitstellen.
Kopieren Sie entweder die public und static Ordner in das Bereitstellungsverzeichnis oder fügen Sie die Verzeichnisse in sites-available zur Standortanweisung hinzu.
Vergessen Sie nicht, auch den static Ordner bereitzustellen.
Rufen Sie einfach die neueste Version der Website ab und ziehen Sie sie git fetch und git pull herunter. Dann kompilieren Sie die Site erneut.
Wenn Sie ein Docker-Image erstellen möchten, klonen Sie das Repository und führen Sie docker build -t judaicalink-site . im Stammverzeichnis des Repositorys.
Um das Image auszuführen, verwenden Sie docker run -d -p 80:80 judaicalink-site .
Überprüfen Sie, ob die Markdown-Syntax korrekt ist.
Beobachten Sie die Konsole auf Fehler, wenn Ihre Änderungen nicht wie erwartet angezeigt werden.
Stellen Sie die Site lokal bereit und prüfen Sie, ob Änderungen vorliegen.
Leeren Sie den Cache Ihres Browsers.
Wenn Sie fertig sind, übertragen Sie Ihre Änderungen in Ihr geforktes Repository und senden Sie die Pull-Anfrage.