marx-software.de

Inhalte werden in Markdown erstellt.

ShortCodes

Reichen die Möglichkeiten von Markdown nicht aus, können durch das erstellen eigener ShortCodes Erweiterungen geschaffen werden. Mit diesen Erweiterungen sollte die meisten Anwendungsfälle abgedeckt werden können.

Vorschau

Läuft das CMS im DEV-Modus (Achtung, dies wird für den produktiven Betrieb nicht empfohlen), können sie durch das Anhängen von ?preview an die URL den Preview Modus aktivieren. Dieser bewirkt, dass auch nicht veröffentlichte Inhalte angezeigt werden.

Meta-Attribute

Neben den im Folgenden vorgestellten reservierten Attribute, können auch beliebige Attribute definiert werden. Die dann im Template-Code zu Verfügung stehen.

Title

title: Der Titel des Blogartikels.

Rendertemplate

Das Template, welches zum rendern dieser Seite verwendet werden soll.

template: blog-entry.html

Auszug / Zusammenfassung definieren

Der Auszug des Inhaltes wird überall dort verwendet, wo mit der Query- oder NodeList-Function in Templates gearbeitet wird.

excerpt: In diesem Blogartikel geht es um.

Sichtbarkeit einstellen

Im Standard gilt einen Seite als veröffentlicht, sobald sie angelegt wurde.

published: false

Veröffentlichen ab einem bestimmten Datum

publish_date: 2023-12-01

Nicht mehr Veröffentlichen ab einem bestimmten Datum

unpublish_date: 2023-12-31

Werden Menüs mittels der Navigation-Funktion erzeugt, können über diese Attribute geregelt werden, ob einen Seite im Menu auftaucht, an welcher Position sie auftaucht und welchen Titel sie hat.

Sichtbarkeit im Menu

menu:
    visible: true/false

Position im Menu

Die Menüeinträge werden nach Position aufsteigend sortiert angezeigt angezeigt, sollte kein Position-Attribute vergeben worden sein, gilt der Standard 1000. Tritt der Fall ein, dass Positionen mehrfach belegt sind, werden diese alphanumerisch sortiert.

menu:
    position: 50

Title im Menu

Für den Fall, dass der Wert im title-Attribute zu lang und somit nicht für das Menu geeignet ist, kann dieser einfach überschrieben werden.

menu:
    title: Kurzer Menutitel

Redirects

Über das Redirect-Attribute können Seiten zum redirect auf externe URLs verwendet werden.

redirect:
    status: 301
    location: https://google.de

Content-Type

Über das setzten des Content-Types können auch andere textbasierte Formate erzeugt werden. Standard Content-Type ist text/html und muss nicht explizit angegeben werden.

content:
    type: "application/json"

Views

Über Views (type: view) können können Queries direkt in den Meta-Daten angegeben werden und mittels ${page.items} im Template verarbeitet werden.

template: views/test.html
type: view
content:
  query:
    from: "/"
    excerpt: 250
    order_by: title
    order_direction: asc
    conditions: 
      - name: where
        operator: =
        key: template
        value: content.html