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.