Diese Anleitung beschreibt die verschiedenen Möglichkeiten, das Hadron Skeleton zu installieren und leitet dich durch die Installation des Skeletons für eine neue Grav Seite.
Das Hadron Skeleton kann auf verschiedene Arten installiert werden.
Es gibt grundlegend zwei Methoden, das Skeleton zu installieren: via Git oder als ZIP-Datei. Beide Methoden haben ihre Vor- und Nachteile, je nachdem, wie du das Skeleton verwenden möchtest. Zudem gibt es verschiedene Varianten, wie du das Skeleton installieren kannst, je nachdem, ob du das Skeleton bearbeiten oder nur verwenden möchtest.
Wenn du das Skeleton mit Git bearbeiten möchtest, ist das einfachste, das Repository zu klonen. So kannst du einfach Updates und Änderungen aus dem Original-Repository ziehen. Es gibt verschiedene Varianten, je nachdem, was du mit dem Skeleton machen möchtest:
Wenn du ein neues Repository basierend auf diesem Skeleton erstellen möchtest, kannst du den Nutze diese Vorlage Knopf auf der GitHub Repository Seite verwenden. Dies erstellt ein neues Repository in deinem Account basierend auf dem Skeleton. Du wirst jedoch keine Updates aus dem Original-Repository ziehen können.
Dies ist der empfohlene Weg, wenn du eine neue Seite basierend auf diesem Skeleton entwickeln möchtest und nicht planst, zum ursprünglichen Skeleton beizutragen oder Updates daraus zu ziehen.
Um ein neues Repository basierend auf diesem Skeleton zu erstellen, klicke auf den Nutze diese Vorlage Knopf auf der GitHub Repository Seite. Du wirst aufgefordert, einen Repository-Namen und eine Beschreibung einzugeben. Danach hast du eine aktuelle Kopie des Skeletons in deinem Account. Du kannst nun das Repository auf deinen Computer klonen und mit der Entwicklung deiner Seite beginnen.
Siehe Punkt 1.3, wie du das Repository auf deinen Computer klonen kannst (mit Grav)
Durch das forken dieses Repositorys erstellst du eine verknüpfte Kopie des ursprünglichen Repositorys in deinem eigenen GitHub Account. Auf diese Weise kannst du Änderungen am Skeleton vornehmen und sie in dein eigenes Repository pushen. Du kannst dann eine neue Seite erstellen, indem du dein Fork als Skeleton verwendest. Dies ist der empfohlene Weg, wenn du zum ursprünglichen Skeleton beitragen oder Updates daraus ziehen möchtest.
Um das Repository zu forken, klicke auf den Fork Knopf auf der GitHub Repository Seite. Du hast nun eine Kopie des Skeletons in deinem Account. Du kannst das Repository auf deinen Computer klonen und mit der Entwicklung deiner Seite beginnen.
Siehe Punkt 1.3, wie du das Repository auf deinen Computer klonen kannst (mit Grav)
Das direkte Klonen des Repositorys erstellt eine lokale Kopie des Skeletons auf deinem Computer. Dies ist nur empfohlen, wenn du das Skeleton ausprobieren oder Änderungen daran vornehmen möchtest, ohne zum ursprünglichen Repository beizutragen oder Updates daraus zu ziehen. Wenn du lieber eine neue Seite basierend auf dem Skeleton erstellen möchtest, verwende eine der oben genannten Methoden.
Um das Repository direkt zu klonen, verwende die folgenden Befehle:
cd /deine/seite/
git clone https://github.com/getgrav/grav.git .
rm user/ -rf
git clone https://github.com/Crabston/grav-skeleton-hadron.git user
bin/grav installDu kannst auch unseren modifizierten Grav Core mit zusätzlichen Funktionen verwenden:
cd /deine/seite/
git clone https://github.com/Crabston/grav.git .
git clone https://github.com/Crabston/grav-skeleton-hadron.git user
bin/grav installWenn du Git nicht verwenden möchtest, kannst du das Skeleton als ZIP-Datei herunterladen und manuell installieren. Es gibt zwei verschiedene Versionen des Skeletons:
Wenn du das Skeleton mit Abhängigkeiten herunterlädst, erhältst du eine ZIP-Datei, die den Grav Core, Plugins und Themes enthält, die zum Ausführen des Skeletons erforderlich sind. Dies ist der einfachste Weg, um mit dem Skeleton zu beginnen, da du alles hast, was du zum Ausführen benötigst.
Um das Skeleton mit Abhängigkeiten herunterzuladen, gehe zur Releases Seite und lade die neueste Version herunter. Du kannst dann die Datei in das Root-Verzeichnis deines Servers entpacken.
Um dieses Paket manuell zu installieren, ersetzt du im Grunde den Standard user Ordner durch das Skeleton. Lade dazu die ZIP-Version dieses Repositorys herunter und entpacke sie unter /deine/seite/grav/. Benenne dann den Ordner in user um.
Wenn bereits ein user Ordner vorhanden ist, sichere ihn an einem sicheren Ort, lösche ihn (wenn sich keine benutzerdefinierten Inhalte darin befinden, die du behalten möchtest) oder ersetze seinen Inhalt durch die Dateien im entpackten Ordner.
Du solltest nun alle Skeleton-Dateien unter /deine/seite/grav/user/ haben.
Dieses Skeleton ist ein modulares Komponente für Grav, die Grav, mehrere Plugins und Themes erfordert, um zu funktionieren. Wenn du dieses Skeleton als Teil eines vorgefertigten Pakets von GetGrav.org oder GitHub Releases herunterlädst, solltest du alles haben, was du zum Starten benötigst.
Nach der Installation des Skeletons kannst du mit der Entwicklung/ Bearbeitung deiner Seite beginnen.
