--- title: "Tutorial - Installation und Konfiguration von Cecil, einem Static Site Generator (SSG) in PHP" description: "Erfahren Sie, wie Sie mit Cecil Ihre statische Website mithilfe einer modernen Template-Engine erstellen (Jamstack)" url: https://docs.ovhcloud.com/de/guides/web-cloud/web-hosting/static-website-installation-cecil lang: de lastUpdated: 2026-06-08 --- # Tutorial - Installation und Konfiguration von Cecil, einem Static Site Generator (SSG) in PHP ## Ziel Dieses Tutorial zeigt Ihnen, wie Sie [Cecil](https://cecil.app/) installieren und konfigurieren können. Es ist eine in PHP geschriebene Anwendung, die statische Webseiten generieren und verwalten kann. Eine im Wesentlichen aus statischen Seiten bestehende Website garantiert Ihren Besuchern eine bessere Ladezeit und eine höhere Sicherheit. Ohne dynamischen Inhalt sind Ihre Seiten robuster gegen Cyber-Angriffe. Das Erzeugen von statischen Seiten erlaubt mehr Freiheiten bei der Seiten-Erstellung. Sie sparen auch Zeit, da Sie nicht bei Null anfangen müssen. **In diesem Tutorial wird erläutert, wie Sie mit Cecil Ihre statische Website mit einer modernen Template-Engine (Jamstack) erstellen können.** :::warning OVHcloud stellt Ihnen Dienstleistungen zur Verfügung, für deren Konfiguration und Verwaltung Sie die alleinige Verantwortung tragen. Es liegt somit bei Ihnen, sicherzustellen, dass diese ordnungsgemäß funktionieren. Wenn Sie Schwierigkeiten haben, die Schritte in diesem Tutorial durchzuführen, empfehlen wir, einen [spezialisierten Dienstleister](https://partner.ovhcloud.com/de/directory/) zu kontaktieren oder Ihre Fragen in der OVHcloud Community zu stellen. Leider können wir Ihnen für administrative Aufgaben keine weitergehende technische Unterstützung anbieten. Weitere Informationen finden Sie am [Ende dieser Anleitung](#go-further). ::: ## Voraussetzungen - Sie verfügen über ein [OVHcloud Webhosting](https://www.ovhcloud.com/de/web-hosting/) mit SSH-Zugang. Über diesen Zugriff können Sie eine oder mehrere Alternativlösungen online installieren, ergänzend zu den Webhosting-Standarddiensten. - Sie sind mit der Befehlszeileneingabe vertraut. - Sie können Ihre Dateien per FTP mit einem Client wie [FileZilla](/de/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) übertragen. - Ihre DNS-Zone ist konfiguriert, damit Ihr Domainname (oder Subdomain) auf Ihr Webhosting weitergeleitet wird. Dies ist insbesondere nützlich, wenn Sie mehrere [Webseiten](/de/guides/web-cloud/web-hosting/multisites-configure-multisite.md) auf Ihrem Webhosting einrichten möchten. - Sie haben [Composer](https://getcomposer.org/) installiert, mit der Datei `composer.phar` im Wurzelverzeichnis Ihres Webhostings oder im Zielordner Ihres Domainnamens. ## In der praktischen Anwendung Ein [Webhosting](https://www.ovhcloud.com/de/web-hosting/) ermöglicht es, Domains oder Subdomains auf den darin enthaltenen Webseiten zu deklarieren. Eine Domain oder Subdomain ist erforderlich, um Ihre mit **Cecil** erstellte Website bereitzustellen. Um Ihnen bei der Einrichtung einer Domain oder Subdomain auf einer der Webseiten Ihres Webhostings zu helfen, konsultieren Sie unsere Seite „[Mehrere Webseiten auf einem Webhosting einrichten](/de/guides/web-cloud/web-hosting/multisites-configure-multisite.md)“. ### Erstellen Sie das Verzeichnis für Ihre Dateien Sobald Sie sich über SSH auf Ihrem Webhosting eingeloggt haben, erstellen Sie ein Root-Verzeichnis mit dem folgenden Befehl: ```sh mkdir mystaticwebsite ``` Ersetzen Sie `mystaticwebsite` durch den Ordnernamen Ihrer Wahl (ohne Akzente und Leerzeichen). Wechseln Sie anschließend zu diesem Ordner: ```sh cd mystaticwebsite ``` Ersetzen Sie `mystaticwebsite` durch Ihren Ordnernamen. ### Download Laden Sie in dem Verzeichnis, das Sie gerade erstellt haben, Cecil herunter: ```sh curl -OL https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` ### Installation Starten Sie die Cecil-Installation mit dem folgenden Befehl: ```sh php cecil.phar new:site ``` Tragen Sie die angeforderten Informationen ein: - Titel Ihrer Webseite - Eine _Baseline_ für Ihre Webseite - URL Ihrer Seite (Beispiel: `https://mywebsite.ovh`) - Eine Beschreibung Ihrer Seite ![Cecil-Installation](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil01.png) Nachdem Sie diese Informationen eingegeben haben, können Sie die Website mit dem folgenden Befehl bereitstellen: ```sh php cecil.phar build ``` Wenn Sie den Inhalt des Verzeichnisses anzeigen, finden Sie dort das Verzeichnis `_site`. Dieses Verzeichnis enthält alle HTML-Dateien und _Assets_: ![Cecil-Installation](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil02.png) Sie können nun das Ergebnis sehen, indem Sie Ihren Domainnamen aufufen: ![Cecil-Installation](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil03.png) #### Konfiguration des Domainnamens Um die Ergebnisse in Ihrem Browser anzuzeigen, muss Ihr Domainname auf das Verzeichnis `_site` verweisen, das Sie bei der Installation von **Cecil** erstellt haben. Wenn Ihr Domainname oder Subdomain bei OVHcloud gehostet wird, konsultieren Sie unsere Anleitungen zu der [DNS-Konfiguration](/de/guides/web-cloud/domains/dns-zone-edit.md) und zur Einrichtung einer [Webseite auf Ihrem Webhosting](/de/guides/web-cloud/web-hosting/multisites-configure-multisite.md). ### Ihre Webseite konfigurieren Allgemeine Informationen zu Ihrer Website können Sie in der Datei `config.yml` konfigurieren: ```sh nano config.yml ``` Ersetzen Sie die Standardinformationen durch Ihre eigenen, und speichern Sie die Datei. ![YAML-Konfigurationsdatei](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil04.png) ### Neue Seite erstellen Sie können Webseiten mithilfe von Dateien im Markdown-Format erstellen. Diese Seiten können angepasst werden. **Cecil** enthält [Twig](https://twig.symfony.com/), die Template Engine, die standardmäßig für das [Symfony](https://symfony.com/) Framework verwendet wird. Ordner und Dateien sind wie folgt organisiert: - `assets`: Enthält Grafiken, Audio, Video, JavaScript und Formatvorlagen (CSS, Sass). - `layouts`: Enthält Templates. - `pages`: Enthält Markdown-Dateien. - `_site`: Verzeichnis, in dem sich die generierten Dateien befinden und auf das der Domainname verweist. - `static`: Enthält alle statischen PDF-Dateien. #### Erstellen einer Markdown-Datei in der Befehlszeile Geben Sie im Stammverzeichnis der Seite den folgenden Befehl ein: ```sh php cecil.phar new:page mypage.md ``` Ersetzen Sie `mypage` durch den Namen Ihrer Seite. Anschließend wird im Stammverzeichnis `/pages` die Datei `mypage.md` erstellt. ![Cecil-Installation](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil05.png) #### Statische Dateien generieren Geben Sie im Stammverzeichnis den folgenden Befehl ein: ```sh php cecil.phar build ``` Ihre Datei befindet sich im Ordner `_site/mypage/`: ![Cecil-Installation](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil06.png) Sie können sie auf dem Server öffnen, indem Sie die URL Ihrer Seite gefolgt von `/mypage/` eingeben: ![Browserergebnis](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil07.png) ### Passen Sie Ihre Website-Dateien an #### Auf dem Server arbeiten Markdown-Dateien können direkt auf dem Webhosting-Server bearbeitet werden. Mit einem OVHcloud [Webhosting](https://www.ovhcloud.com/de/web-hosting/) mit SSH-Zugang (**ab dem Angebot Pro**) können Sie [GNU nano](https://nano-editor.org/), [vi](https://ex-vi.sourceforge.net/) oder [vim](https://www.vim.org/) verwenden. Die Screenshots dieses Tutorials wurden unter **GNU nano** erstellt. Bearbeiten Sie die Datei `mypage.md` im Verzeichnis `pages`, indem Sie im Stammverzeichnis den folgenden Befehl eingeben: ```sh nano pages/mypage.md ``` Ersetzen Sie `mypage` durch den Namen Ihrer eigenen Seite. ![Datei in GNU nano bearbeiten](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil08.png) Fügen Sie Zeilen mithilfe der Markdown-Syntax hinzu: ![Inhalt zur Datei hinzufügen](/images/assets/screens/other/web-tools/terminal/static-website-installation-cecil09.png) Löschen Sie die Dateien im Cache mit dem folgenden Befehl: ```sh php cecil.phar clear ``` Erstellen Sie Ihre Seiten neu (_build_), nachdem Sie Ihre Datei gespeichert haben: ```sh php cecil.phar build ``` Kehren Sie dann zu Ihrer Seite zurück, um das Ergebnis zu sehen: ![Seite aktualisiert](/images/assets/screens/other/browsers/web-pages/static-website-installation-cecil10.png) #### Arbeitsumgebung ändern Wenn Sie es vorziehen, Ihren gewohnten Code-Editor zu verwenden, melden Sie sich mit einem FTP-Client auf Ihrem Server an, um die Dateien auf Ihren Computer zu übertragen: ![FileZilla Download](/images/assets/screens/other/web-tools/filezilla/cecil-folder.png) Sie können nun die Dateien in Ihrer I.D.E. bearbeiten: ![Anzeige in Visual Studio-Code](/images/assets/screens/other/web-tools/vscode/static-website-installation-cecil12.png) Laden Sie einfach Ihre veränderten oder neuen Dateien auf den Server und führen Sie _build_ aus, um Ihre Seiten online zu stellen. ### Die erstellte Seite zum Menü Ihrer Seite hinzufügen Um diese neue Seite zum Website-Menü hinzuzufügen, ändern Sie manuell den Header der `.md`-Datei, indem Sie die folgende Zeile hinzufügen: ```sh menu: main ``` ### Fazit **Cecil** ist ein Tool, mit dem eine statische Site aus _Markdown_ -Dateien erstellt werden kann. Diese Markup-Sprache ist einfacher zu implementieren als HTML. Die Organisation von Markdown-Dateien bestimmt die Hierarchie Ihrer Webseiten. Die Verwendung einer Template Engine, die in der Web-Entwickler-Community weit verbreitet ist, ermöglicht es Ihnen, viele Quellen im Internet zu finden, um eine professionell aussehende Benutzeroberfläche zu entwerfen. ## Weiterführende Informationen [](#) [Dynamischen Inhalt auf einer statischen Webseite hinzufügen, die mit Cecil erstellt wurde](/de/guides/web-cloud/web-hosting/static-website-installation-cecil-api-call.md) [Offizielle Webseite von Cecil](https://cecil.app/) [Hilfe zum Markdown-Format](https://www.markdownguide.org/) [Verwendung von FileZilla](/de/guides/web-cloud/web-hosting/ftp-filezilla-user-guide.md) Kontaktieren Sie für spezialisierte Dienstleistungen (SEO, Web-Entwicklung etc.) die [OVHcloud Partner](https://partner.ovhcloud.com/de/directory/). Treten Sie unserer [User Community](https://community.ovhcloud.com/) bei.