NAME

blazetheme - eine Einführung in die BlazeBlogger Theme-Erstellung/-Modifizierung


BESCHREIBUNG

Dieses Dokument versucht, eine kurze Einführung zu liefern für die Kreierung eines neuen Themes oder die Modifizierung eines existierenden Themes für Deine BlazeBlogger Website.

BlazeBlogger Theme Struktur

Um es möglichst einfach zu machen, BlazeBlogger Themes zu ändern, bestehen BlazeBlogger-Themes nur aus zwei Teilen: der Template-Datei in .blaze/theme/ und einem korrespondierenden Stylesheet im .blaze/style/ Verzeichnis. So ist es möglich, zwischen verschiedenen Stiles zu wechseln (z.B. zwischen hellem und dunklem Stil), ohne die Template-Datei anzupacken.

Eine Template-Datei kreieren

In der Template-Datei ist das Seitenlayout beschrieben. Der Code ist HTML (oder XHTML, das ist gleichgültig) mit einigen Platzhaltern, die durch passende Daten ersetzt werden. Die meisten Platzhalter sind einfache HTML-Kommentare mit reservierten Strings. Beachte: Der Case ist nicht wichtig, aber der komplette Platzhalter muss in einer Zeile stehen.

Für ein Beispiel siehe die mitgelieferte (default) Template-Datei.

Liste der Head Platzhalter

Dies sind die Platzhalter, die üblicherweise in der HEAD-Section eines HTML/XHTML-Dokuments auftauchen.

<!-- content-type -->

Der Content-Type META tag.

<!-- generator -->

Der Generator META tag.

<!-- date -->

Der Date META tag.

<!-- stylesheet -->

Der Stylesheet LINK tag.

<!-- rss -->

Der RSS feed LINK tag.

<!-- page-title -->

Der aktuelle Seitentitel, üblicherweise im TITLE element verwendet.

Liste der Body Platzhalter

Dies sind die Platzhalter, die üblicherweise in der BODY-Section eines HTML/XHTML-Dokuments auftauchen.

<!-- title -->

Der Blog-Titel, siehe blog.title in der BlazeBlogger Konfigurationsdatei. Du kannst diesen Platzhalter ebenfalls im TITLE element verwenden.

<!-- subtitle -->

Der blog title, siehe blog.subtitle in der BlazeBlogger Konfigurationsdatei.

<!-- name -->

Der User-Name, siehe user.name in der BlazeBlogger Konfigurationsdatei.

<!-- e-mail -->

Die e-mail-Adresse des Users, siehe user.email in der BlazeBlogger Konfigurationsdatei.

<!-- year -->

Das aktuelle Jahr.

<!-- tags -->

Die Liste der tags.

<!-- archive -->

Die Liste der Monate.

<!-- pages -->

Die Liste der Seiten.

<!-- posts -->

Die Liste der neuesten Blog-Artikel.

<!-- content -->

Der Hauptinhalt (z.B. Artikel- oder Seiten body, Artikel listing etc.).

%root%

Der relative Pfad zum root-Verzeichnis des Blogs; kann in Links verwendet werden. Beachte: Dies ist einer von den zwei Platzhaltern, die im Artikel-/Seiten body auftauchen können und dort berücksichtigt/umgesetzt werden.

%home%

Der relative Pfad zur Home-Seite (index) des Webauftritts; kann in Links verwendet werden. Beachte: Dies ist einer von den zwei Platzhaltern, die im Artikel-/Seiten body auftauchen können und dort berücksichtigt/umgesetzt werden.

Ein Stylesheet kreieren

Das Stylesheet ist eine einfache CSS-Datei (CSS 2.1 ist empfohlen, aber nicht unbedingt erforderlich) von denen die meisten Teile in der Theme-Datei eingeführt wurden. Die wenigen, die von blaze-make(1) produziert werden, sind im Folgenden beschrieben.

Für ein Beispiel sieh Dir das mitgelieferte (default) Stylesheet an.

Liste der obligatorischen Klassen

post

H2 Element, welches den Seiten-/Artikel-Titel enthält.

section

DIV Element, welches den Namen der aktuellen Section (z.B. monatliches Archiv, tag-Liste etc.) enthält.

information

DIV Element, welches zusätzliche Informationen zum Artikel, z.B. das Veröffentlichungsdatum, den Namen des Autors und die Liste der tags enthält.

date

SPAN Element, welches das Veröffentlichungsdatum enthält.

author

SPAN Element, welches den Artikel-Autor enthält.

tags

SPAN Element, welches die Liste der tags enthält.

previous

DIV Element, welches den Link zur Seite mit älteren Artikeln enthält.

next

DIV Element, welches den Link zur Seite mit neueren Artikeln enthält.

more

A Element, welches den `Read more' (Alles lesen) Link enthält.


DATEI

.blaze/theme/

BlazeBlogger Themes Verzeichnis.

.blaze/style/

BlazeBlogger Stylesheets Verzeichnis.


SIEHE AUCH

blaze-config(1), blaze-make(1).


AUTHOR

Written by Jaromir Hradilek <jhradilek@gmail.com> Übersetzt von Hans Fährmann <BlazeBlogger>

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

A copy of the license is included as a file called FDL in the main directory of the BlazeBlogger source package.