Installation und Konfiguration von Kirby in der ServBay-Umgebung

Was ist Kirby?

Kirby ist ein flexibles und leistungsfähiges, dateibasiertes Content-Management-System (CMS) zum Erstellen verschiedener Arten von Websites. Kirby benötigt keine Datenbank und verwendet stattdessen das Dateisystem zur Speicherung der Inhalte, was es sehr leichtgewichtig und einfach zu deployen macht.

Schritte zur Installation von Kirby

In diesem Artikel zeigen wir Ihnen, wie Sie Kirby 4.2 mit Composer in der ServBay-Umgebung installieren und konfigurieren.

Schritt 1: Projektverzeichnis erstellen

Erstellen Sie zuerst ein neues Projektverzeichnis im www Verzeichnis von ServBay:

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

Schritt 2: Kirby-Projekt mit Composer erstellen

ServBay hat Composer bereits integriert, sodass wir Composer direkt verwenden können, um das Kirby-Projekt zu erstellen:

composer create-project getkirby/starterkit .

Schritt 3: Webserver konfigurieren

1. Neue Website hinzufügen

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

   • Name: My Kirby Site
   • Domain: servbay-kirby.local
   • Website-Typ: PHP
   • PHP-Version: 8.2
   • Webseiten-Wurzelverzeichnis: /Applications/ServBay/www/servbay-kirby-app

2. Konfiguration speichern

   Speichern Sie die Konfiguration.

Schritt 4: Kirby konfigurieren

1. Inhaltsverzeichnis erstellen

   Im Projektstammverzeichnis wurde das content Verzeichnis bereits durch das Kirby Starterkit erstellt.

Schritt 5: Kirby starten

1. Kirby aufrufen

   Öffnen Sie Ihren Browser und gehen Sie zu https://servbay-kirby.local, dort sehen Sie die Standard-Willkommensseite von Kirby.

Schritt 6: Kirby Panel installieren (optional)

Wenn Sie das Admin-Panel von Kirby verwenden möchten, können Sie es durch folgende Schritte installieren:

1. Kirby Panel aufrufen

   Öffnen Sie Ihren Browser und gehen Sie zu https://servbay-kirby.local/panel, dort sehen Sie die Installationsseite des Kirby Panels.

2. Administrator-Konto erstellen

   Folgen Sie den Anweisungen zur Erstellung eines Administrator-Kontos, geben Sie Benutzername, Passwort und E-Mail-Adresse ein und klicken Sie auf „Account erstellen“.

Erstellung von Websites mit Kirby

Nachdem Sie Kirby erfolgreich in der ServBay Umgebung installiert und konfiguriert haben, können Sie es nun zur Erstellung Ihrer Website verwenden. Hier sind einige häufige Tätigkeiten:

Erstellung von Seiten und Inhalten

1. Seiten erstellen

   Erstellen Sie neue Seitendirektiven im content Verzeichnis. Beispielsweise eine about Seite:

   mkdir content/about
   echo "Title: About Us\n----\nThis is the about page." > content/about/about.txt

2. Vorlagen bearbeiten

   Erstellen oder bearbeiten Sie Vorlagendateien im site/templates Verzeichnis. Beispielsweise eine about.php Vorlage:

   <!-- site/templates/about.php -->
   <h1><?= $page->title() ?></h1>
   <p><?= $page->text() ?></p>

Navigationsmenü konfigurieren

1. Vorlagen bearbeiten

   Bearbeiten Sie die Hauptvorlagendatei im site/templates Verzeichnis, z.B. default.php, um ein Navigationsmenü hinzuzufügen:

   <!-- site/templates/default.php -->
   <nav>
     <ul>
       <?php foreach ($site->children()->listed() as $item): ?>
         <li>
           <a href="<?= $item->url() ?>"><?= $item->title() ?></a>
         </li>
       <?php endforeach ?>
     </ul>
   </nav>

Anpassung von Stilen und Skripten

1. Stile hinzufügen

   Erstellen Sie eine CSS-Datei im assets/css Verzeichnis und verlinken Sie sie in der Vorlagendatei. Beispielsweise style.css:

   /* assets/css/style.css */
   body {
     font-family: Arial, sans-serif;
   }

   Verlinken Sie die CSS-Datei in der Vorlagendatei:

   <!-- site/templates/default.php -->
   <link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">

2. Skripte hinzufügen

   Erstellen Sie eine JavaScript-Datei im assets/js Verzeichnis und verlinken Sie sie in der Vorlagendatei. Beispielsweise script.js:

   // assets/js/script.js
   document.addEventListener('DOMContentLoaded', function() {
     console.log('Hello, Kirby!');
   });

   Verlinken Sie die JavaScript-Datei in der Vorlagendatei:

   <!-- site/templates/default.php -->
   <script src="<?= url('assets/js/script.js') ?>"></script>

Durch die obigen Schritte haben Sie Kirby erfolgreich in der ServBay Umgebung installiert und konfiguriert und können mit der Erstellung Ihrer Website beginnen. Die Flexibilität und das dateibasierte System von Kirby machen es zu einer idealen Wahl für die Erstellung verschiedenster Arten von Websites.