Skip to main content

Struktur des Theme-Pakets

Ein Theme ist ein Ordner mit dieser Struktur. Erforderlich sind lediglich die Dateien theme.json und templates/page.html.twig .

my-theme/
├── theme.json                 the theme manifest (required)
├── templates/
│   ├── page.html.twig         every topic page (required)
│   ├── base.html.twig         a shared page frame the others extend
│   ├── portal.html.twig       the portal page
│   ├── search.html.twig       the search results page
│   └── partials/              smaller templates that others include
│       └── header.html.twig
├── assets/                    stylesheets, scripts, images and fonts
│   ├── css/main.css
│   ├── js/theme.js
│   └── img/logo.svg
└── i18n/                      translations of the theme's own text
    ├── en.json
    └── de.json

Ordner unter templates/ und assets/ können beliebige Namen haben und beliebig tief verschachtelt sein.

Erstellen Sie die ZIP-Datei

Komprimieren Sie den Inhalt des Theme-Ordners, nicht den Ordner selbst, sodass sich die Datei theme.json ganz oben in der ZIP-Datei befindet.

  • macOS: Öffne den Theme-Ordner, wähle den gesamten Inhalt aus und klicke auf Komprimieren.

  • Windows: Öffnen Sie den Ordner Themes, wählen Sie den gesamten Inhalt aus und wählen Sie Senden an > Komprimierter (ZIP-)Ordner.

Wenn Sie den Ordner selbst komprimieren, akzeptiert Paligo das Theme zwar weiterhin, zeigt jedoch eine Warnung an. Befinden sich die Dateien in mehr als einer Ordnerebene, wird der Upload abgelehnt.

Dateien, die Ihr Computer hinzufügt, werden ignoriert und müssen nicht entfernt werden: __MACOSX-Ordner, .DS_Store, Dateien, die mit ._ beginnen, Thumbs.db und desktop.ini. Das Gleiche gilt für .git-Ordner sowie die Dateien .gitignore, .gitattributes, .gitkeep und .gitmodules.

Grenzen

Grenzwert

Wert

Größe der ZIP-Datei

20 MB

Größe der Dateien nach dem Entpacken

100 MB

Anzahl der Dateien und Ordner in der ZIP-Datei

5,000

Zulässige Dateiformate

Ein Theme darf nur Dateien mit folgenden Dateiendungen enthalten:

.twig .css .js .json .svg .png .jpg .jpeg .webp .woff2 .ico .txt .md .map

Wenn die ZIP-Datei Dateien anderer Dateitypen enthält, wird der gesamte Upload abgelehnt. Ein Theme darf niemals .php-Dateien enthalten.

Ebenfalls abgelehnt werden: symbolische Links, zwei Dateien mit demselben Pfad sowie Pfade, die mit / oder einem Laufwerksbuchstaben beginnen oder die ... enthalten