> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Theme

> Gestalten Sie das Aussehen Ihres Blogs mit Liquid-Vorlagen.

![Der Theme-Editor des Blogs mit den Theme-Dateien, dem Code und einer Live-Vorschau](https://www.notifuse.com/docs/assets/screenshots/theme_editor.png)

## Theme-Dateien

Jedes Theme besteht aus 8 Dateien:

| Datei             | Zweck                           |
| ----------------- | ------------------------------- |
| `home.liquid`     | Vorlage der Startseite          |
| `category.liquid` | Übersichtsseite einer Kategorie |
| `post.liquid`     | Seite eines einzelnen Beitrags  |
| `header.liquid`   | Gemeinsamer Header als Partial  |
| `footer.liquid`   | Gemeinsamer Footer als Partial  |
| `shared.liquid`   | Wiederverwendbare Komponenten   |
| `styles.css`      | Eigenes CSS                     |
| `scripts.js`      | Eigenes JavaScript              |

## Vorlagen mit Liquid

Themes verwenden die Vorlagensyntax von [Liquid](https://shopify.github.io/liquid/):

```liquid
<h1>{{ workspace.blog_title }}</h1>

{% for post in posts %}
  <article>
    <h2>{{ post.title }}</h2>
    <p>{{ post.excerpt }}</p>
  </article>
{% endfor %}
```

## Verfügbare Variablen

### Global (alle Seiten)

```liquid
{{ workspace.id }}
{{ workspace.name }}
{{ workspace.blog_title }}
{{ workspace.logo_url }}
{{ workspace.icon_url }}
{{ base_url }}
{{ current_year }}
{{ theme.version }}
```

### Kategorien

```liquid
{% for category in categories %}
  {{ category.id }}
  {{ category.slug }}
  {{ category.name }}
  {{ category.description }}
{% endfor %}
```

### Beiträge (Startseite und Kategorieseiten)

```liquid
{% for post in posts %}
  {{ post.id }}
  {{ post.slug }}
  {{ post.category_slug }}
  {{ post.title }}
  {{ post.excerpt }}
  {{ post.featured_image_url }}
  {{ post.published_at }}
  {{ post.reading_time_minutes }}

  {% for author in post.authors %}
    {{ author.name }}
    {{ author.avatar_url }}
  {% endfor %}
{% endfor %}
```

### Einzelner Beitrag (Beitragsseite)

```liquid
{{ post.title }}
{{ post.content }}
{{ post.excerpt }}
{{ post.featured_image_url }}
{{ post.published_at }}
{{ post.reading_time_minutes }}

{% for toc in post.table_of_contents %}
  {{ toc.id }}
  {{ toc.level }}
  {{ toc.text }}
{% endfor %}

{{ category.name }}
{{ category.slug }}
```

### Seitennummerierung

```liquid
{{ pagination.current_page }}
{{ pagination.total_pages }}
{{ pagination.has_next }}
{{ pagination.has_previous }}
{{ pagination.total_count }}
{{ pagination.per_page }}
```

### Newsletter-Listen

```liquid
{% for list in public_lists %}
  {{ list.id }}
  {{ list.name }}
  {{ list.description }}
{% endfor %}
```

## Nützliche Filter

| Filter                 | Beschreibung                               | Beispiel                                                              |
| ---------------------- | ------------------------------------------ | --------------------------------------------------------------------- |
| `date`                 | Datum formatieren                          | `{{ post.published_at \| date: "%B %d, %Y" }}`                        |
| `truncate`             | Länge einer Zeichenkette begrenzen         | `{{ post.excerpt \| truncate: 150 }}`                                 |
| `truncatewords`        | Anzahl der Wörter begrenzen                | `{{ post.excerpt \| truncatewords: 25 }}`                             |
| `upcase` / `downcase`  | Groß- und Kleinschreibung ändern           | `{{ category.name \| upcase }}`                                       |
| `capitalize`           | Ersten Buchstaben großschreiben            | `{{ author.name \| capitalize }}`                                     |
| `strip_html`           | HTML-Tags entfernen                        | `{{ post.content \| strip_html }}`                                    |
| `escape`               | HTML-Entitäten maskieren                   | `{{ post.title \| escape }}`                                          |
| `url_encode`           | Für URLs kodieren                          | `{{ post.title \| url_encode }}`                                      |
| `default`              | Ersatzwert                                 | `{{ post.featured_image_url \| default: "/images/placeholder.jpg" }}` |
| `size`                 | Länge eines Arrays oder einer Zeichenkette | `{{ posts \| size }}`                                                 |
| `first` / `last`       | Erstes oder letztes Element                | `{{ categories \| first }}`                                           |
| `sort`                 | Array sortieren                            | `{{ posts \| sort: "published_at" }}`                                 |
| `reverse`              | Array umkehren                             | `{{ posts \| reverse }}`                                              |
| `where`                | Array filtern                              | `{{ posts \| where: "category_id", "news" }}`                         |
| `map`                  | Eigenschaft auslesen                       | `{{ posts \| map: "title" }}`                                         |
| `join`                 | Array-Elemente verbinden                   | `{{ post.tags \| join: ", " }}`                                       |
| `split`                | Zeichenkette aufteilen                     | `{{ "a,b,c" \| split: "," }}`                                         |
| `replace`              | Text ersetzen                              | `{{ post.title \| replace: "-", " " }}`                               |
| `append` / `prepend`   | An Zeichenkette anhängen oder voranstellen | `{{ post.slug \| prepend: "/" }}`                                     |
| `plus` / `minus`       | Rechenoperationen                          | `{{ pagination.current_page \| plus: 1 }}`                            |
| `times` / `divided_by` | Rechenoperationen                          | `{{ post.reading_time_minutes \| times: 60 }}`                        |

## Partials

### Include (teilt den Gültigkeitsbereich der übergeordneten Vorlage)

```liquid
{% include 'header' %}
{% include 'footer' %}
```

### Render (isolierter Gültigkeitsbereich)

```liquid
{% render 'shared', widget: 'newsletter' %}
{% render 'shared', widget: 'categories' %}
```

Der Name der Vorlage muss in Anführungszeichen stehen: Wie in Shopify Liquid 5.11 werden `{% render variable %}` und `{% snippet %}` nicht unterstützt. Liquid verhält sich in Themes wie in E-Mail-Vorlagen, mit denselben [Unterschieden zu Shopify Liquid](https://www.notifuse.com/de/docs/features/templates.md#differences-from-shopify-liquid).

## Theme-Versionen

Themes sind versioniert:

![Versionen eines Blog-Themes: ein Entwurf v2, aus dem Standard-Theme erstellt, und v1 live](https://www.notifuse.com/docs/assets/screenshots/theme_versions.png)

- Es kann immer nur eine Version veröffentlicht sein
- Eine veröffentlichte Version ändert sich nie: Wenn Sie Ihre Änderungen daran speichern, entsteht eine neue Entwurfsversion
- Das Speichern eines Entwurfs aktualisiert diesen Entwurf
- Nicht veröffentlichte Versionen sind Entwürfe

## Vorschaumodus

Eine Vorschau nicht veröffentlichter Themes erhalten Sie, wenn Sie `?preview_theme_version=X` an eine beliebige Blog-URL anhängen:

```
https://blog.example.com/?preview_theme_version=5
https://blog.example.com/category/slug?preview_theme_version=5
```

Die Vorschau umgeht den Cache und erfordert eine Anmeldung.
