website-integration

Ein paar kleine Konventionen ermöglichen es Sitecake, sich in jede handgebaute Website einzufügen, ohne Ihre Arbeitsweise zu ändern. Sie schreiben weiterhin einfaches HTML — Sitecake lernt lediglich, welche Teile bearbeitbar sind.

Website-Struktur

Sobald Sie das Sitecake-Archiv heruntergeladen und entpackt haben, sieht es so aus:

sitecake/
sitecake.php

Der Ordner sitecake/ enthält den CMS-Code und die Konfiguration. sitecake.php ist der Einstiegspunkt zum Bearbeiten. Sitecake allein ist nicht funktionsfähig — Sie brauchen mindestens eine Indexseite mit mindestens einem bearbeitbaren div, um mit dem Bearbeiten zu beginnen.

sitecake/
sitecake.php
index.html

Mit einer Indexdatei und einem bearbeitbaren div darin können Sie neue Inhalte hinzufügen: Überschriften, Text, Listen, Videos …

<!DOCTYPE html>
<html>
  <head></head>
  <body>
    <div class="sc-content"></div>
  </body>
</html>

Sobald Sie sich bei http://ihredomain.com/sitecake.php anmelden, etwas Inhalt hinzufügen und auf Veröffentlichen klicken, enthalten Ihre Dateien auf dem Server:

files/
images/
cms-backup/
cms-temp/
sitecake/
sitecake.php
index.html

Sitecake hat diese Ordner automatisch erstellt:

files/ — zum Speichern hochgeladener Dateien (z. B. PDFs)
images/ — zum Speichern hochgeladener Bilder
cms-backup/ — Backups. Nach jeder Veröffentlichung erstellt Sitecake einen Schnappschuss aller Dateien und speichert Kopien in einem datumsbeschrifteten Ordner, was ein Rollback ermöglicht.
cms-temp/ — für Entwürfe, laufende Uploads und Log-Dateien

Bestimmte Dateien ausschließen

Wenn Ihre Website Verzeichnisse oder Dateien enthält, die nicht von Sitecake verwaltet werden sollen, erstellen Sie eine Datei .scignore im Stammverzeichnis Ihrer Website und listen Sie diese auf, eine pro Zeile.

Standardmäßig prüft Sitecake nur .html-, .htm-, .php- und .php5-Dateien (dies kann über die Konfiguration geändert werden).

framework-dir/
wordpress/
some-file-not-managed-by-sitecake.php
some-file-not-managed-by-sitecake.html
subfolder/some-file-not-managed-by-sitecake.html

Seitenstruktur

Die CSS-Klasse sc-content, die einem HTML-Tag hinzugefügt wird, macht dieses Tag zu einem Wrapper für bearbeitbaren Inhalt. Bestehender Code innerhalb des Wrappers wird zum Ausgangsinhalt, sobald Sitecake lädt.

Sitecake unterstützt derzeit diese Inhaltstypen:

h1-h6 — Überschriften
p — Absatz
ul — ungeordnete Liste
img — Bild
a — Links (innerhalb von p, h1-h6 oder ul)
sc-gallery — Mehrbild-Galerie mit Lightbox auf veröffentlichten Seiten
Video — eingebettetes YouTube / Vimeo
sc-map — eingebettete Google Maps
Datei — hochgeladenes Dokument mit Download-Link
HTML — ein roher HTML-Block

Es gibt zwei Arten von sc-content-Containern:

Basis-Container sc-content — einfach bearbeitbare Teile einer Webseite.
Wiederhol-Container sc-content-name — Inhalt, der sich über Seiten hinweg wiederholt. Einmal bearbeiten, und Sitecake synchronisiert die Änderung überall.