Installation und Konfiguration von Sculpin in der ServBay-Umgebung

Was ist Sculpin?

Sculpin ist ein PHP-basierter statischer Website-Generator, geeignet für den Aufbau von Blogs, Dokumentationen und anderen statischen Websites. Es verwendet die Twig Template Engine und YAML Front Matter, was die Website-Entwicklung sehr flexibel und leistungsfähig macht.

Schritte zur Installation von Sculpin

In diesem Artikel zeigen wir Ihnen, wie Sie Sculpin in der ServBay-Umgebung installieren und konfigurieren.

Schritt 1: Projektverzeichnis erstellen

Zuerst ein neues Projektverzeichnis im www-Verzeichnis von ServBay erstellen:

cd /Applications/ServBay/www
mkdir servbay-sculpin-app
cd servbay-sculpin-app

Schritt 2: Sculpin-Projekt mit Composer erstellen

ServBay enthält bereits Composer, daher können wir Composer direkt verwenden, um ein Sculpin-Projekt zu erstellen:

composer create-project sculpin/sculpin-blog-skeleton .

Schritt 3: Webserver konfigurieren

1. Neue Website hinzufügen

   Öffnen Sie ServBay, klicken Sie auf den Reiter „Hosts“ und fügen eine neue Website hinzu:

   • Name: My Sculpin Site
   • Domain: servbay-sculpin.local
   • Websitetyp: PHP
   • PHP-Version: Die entsprechende PHP-Version auswählen
   • Website-Root-Verzeichnis: /Applications/ServBay/www/servbay-sculpin-app/output_dev

2. Konfiguration speichern

   Speichern Sie die Konfiguration und starten Sie ServBay neu.

Schritt 4: Sculpin-Website erstellen

1. Abhängigkeiten installieren

   Führen Sie im Projektverzeichnis den folgenden Befehl aus, um die Abhängigkeiten zu installieren:

   composer install

2. Website erstellen

   Führen Sie den folgenden Befehl aus, um die Sculpin-Website zu erstellen:

   vendor/bin/sculpin generate --watch --server

Schritt 5: Lokalen Entwicklungsserver starten

1. Lokalen Entwicklungsserver starten

   Starten Sie den lokalen Entwicklungsserver mit dem folgenden Befehl:

   vendor/bin/sculpin generate --server --watch

2. Entwicklungsserver aufrufen

   Öffnen Sie den Browser und rufen Sie https://servbay-sculpin.local auf, um die lokale Entwicklungsversion der Sculpin-Website zu sehen.

Schritt 6: Sculpin-Website anpassen

1. Inhalte bearbeiten

   Bearbeiten Sie die Markdown-Dateien und Twig-Templates im source-Verzeichnis, um die Inhalte und das Layout Ihrer Website anzupassen.

2. Neue Seite hinzufügen

   Erstellen Sie im source-Verzeichnis neue Markdown-Dateien, um neue Seiten hinzuzufügen. Erstellen Sie beispielsweise eine about.md-Datei:

   ---
   title: "Über uns"
   ---
   
   # Über uns
   
   Dies ist die Über-uns-Seite.

3. Navigationsmenü konfigurieren

   Bearbeiten Sie die Twig-Template-Dateien im source/_layouts-Verzeichnis, um neue Navigationslinks hinzuzufügen.

4. Website neu erstellen

   Führen Sie nach jeder Änderung an den Inhalten oder Templates den folgenden Befehl aus, um die Sculpin-Website neu zu erstellen:

    vendor/bin/sculpin generate

Sculpin zum Erstellen von Websites verwenden

Jetzt, da Sie Sculpin erfolgreich in der ServBay-Umgebung installiert und konfiguriert haben, können Sie damit beginnen, Ihre Website zu erstellen. Hier sind einige häufige Operationen:

Erstellen eines Blog-Beitrags

1. Beitrag erstellen

   Erstellen Sie im Verzeichnis source/_posts neue Markdown-Dateien, um Blog-Beiträge hinzuzufügen. Erstellen Sie zum Beispiel eine Datei 2024-06-06-my-first-post.md:

   ---
   title: "Mein erster Beitrag"
   datum: 2024-06-06
   ---
   
   # Mein erster Beitrag
   
   Dies ist der Inhalt meines ersten Beitrags.

2. Website neu erstellen

   Erstellen Sie die Sculpin-Website mit dem folgenden Befehl neu:

   vendor/bin/sculpin generate

Stil und Skripte anpassen

1. Stil bearbeiten

   Bearbeiten Sie die CSS-Dateien im Verzeichnis source/assets/css, um das Erscheinungsbild der Website anzupassen.

2. Skripte bearbeiten

   Bearbeiten Sie die JavaScript-Dateien im Verzeichnis source/assets/js, um das Verhalten der Website anzupassen.

3. Ressourcen kompilieren

   Führen Sie den folgenden Befehl aus, um die CSS- und JavaScript-Dateien zu kompilieren:

   vendor/bin/sculpin generate

Durch die obigen Schritte haben Sie Sculpin erfolgreich in der ServBay-Umgebung installiert und konfiguriert und können damit beginnen, Ihre Website zu erstellen. Sculpins Flexibilität und Leistungsfähigkeit machen es zur idealen Wahl für den Aufbau statischer Websites.