Übernahme einer statischen Website nach Textpattern (TXP)

Verfasser: Norbert Willimsky

Estelldatum: 24.08.2009

Inhalt


1. Einführung


1.1 Grafik statische/ dynamische Website

Grafik statische/ dynamische Website

1.2 Einsatzgebiete von TXP

TXP ist ein kostenloses, intuitiv bedienbares, einfaches CMS. Für CMS-Einsteiger mit kleinen bis mittelgroßen Websites, für Privatleute mit begrenzter Zeit und begrenzten Entwicklungskenntnissen ist es bestens geeignet. Mit geringem Einarbeitungsaufwand erhält man rasch brauchbare Ergebnisse. Die vorhandene Dokumentation in dt. Sprache ist allerdings gering und zum Teil mühsam zu erarbeiten. Deswegen die Idee für dieses Tutorial. Mit TXP können Blogs erstellt werden. Mit TXP können aber auch statische Websites dynamisch gestaltet werden. Das hat den Vorteil, dass eine nach TXP übernommene Website vom Eigentümer selbst gepflegt werden kann. Der Website-Ersteller ist damit aus und vor.


1.3 Ziel und Zielgruppe des Tutorials

Das Tutorial beschreibt, wie eine statische Website nach TXP überführt wird. Auf die Erstellung eines Blogs wird nicht eingegangen. Entsprechend wird das Thema Erstellung von Bausteinen nicht vertieft. Zielgruppe dieses Tutorials sind TXP-Einsteiger, die eine erste Orientierung und eine durchgängige Dokumentation für die Überführung von Websites nach TXP suchen.


1.4 Vorgeschlagenes Vorgehen

Um eine Website nach TXP zu überführen, schlage ich folgendes Vorgehen vor.

Zur Übung und wenn noch keine Domain vorhanden ist, auf lokalem Server arbeiten:

  • Den lokalen Server installieren
  • TXP auf dem lokalen Server installieren
  • Die außerhalb erstellte Website nach TXP übertragen und anpassen

Wenn eine Domain vorhanden ist und die Website auf dem Inet-Server erstellt werden soll:

  • TXP auf dem Inet-Server installieren
  • Die außerhalb erstellte Website nach TXP (im Inet) übertragen und anpassen.
  • Ergebnis: eine mit TXP dynamisch pflegbare Website im Inet

1.5 Anmerkungen des Verfassers

Wertungen und Empfehlungen im Tutorial stellen meine eigene Meinung dar. Meine TXP-Kenntnisse sind nicht allumfassend. Oft gibt es auch mehrere Wege, um ans Ziel zu kommen. Ich beschreibe nur einen hiervon. Die Dokumentation ist bewusst kurz und zum Teil stichwortartig gehalten. Auf eine ausgiebige Beschreibung der Philosophie, Oberfläche, Eingabemöglichkeiten usw. wurde verzichtet. Die TXP-Auszeichnungssprache für Artikelinhalte TEXTILE wird nicht verwendet und nicht erläutert. Das Tutorial bezieht sich auf die TXP-Version 4.0.8.

zum Seitenanfang


2. TXP auf lokalem Server installieren


2.1 XAMPP installieren (einmalig)

  • Voraussetzung: Windows-Session mit admin-Rechten
  • XAMPP herunterladen von http://www.apachefriends.org/de/xampp.html
  • XAMPP installieren nach c:/xampp dh. exe-File ausführen

2.2 DB anlegen (je Website)

  • XAMPP-Control-Panel starten. Darin die Anwendungen APACHE und MYSQL starten.
  • Startseite des lokalen Servers mit http://localhost aufrufen. Darin die Anwendung PHPMYADMIN in linker Spalte anklicken.

MYSQL-DB mit PHPMYADMIN anlegen

  • Lasche 'Rechte' anklicken
  • 'Neuen Benutzer hinzufügen' anklicken
  • Benutzername = db1, Host = localhost, Passwort = db1 erfassen
  • 'Erstelle eine DB mit gleichem Namen und gewähre alle Rechte' ankreuzen
  • ok-Button

2.3 TXP installieren (je Website)

  • TXP herunterladen von http://textpattern.com
  • Verzeichnis für Website anlegen unter c:/xampp/htdocs/ mysite
  • TXP-Exe-File ausführen bzw. TXP-Dateien nach c:/xampp/htdocs/ mysite extrahieren (mit rechter Maustaste).
  • Frontend aufrufen: http://localhost/mysite/textpattern-4.0.8
  • Sprache einstellen
  • MYSQL-Benutzer, -Passwort, -DB angeben (vgl. Punkt 2.2)
  • CONFIG.PHP mit einem Editor erstellen und unter c:/xampp/htdocs/mysite/textpattern-4.0.8/textpattern speichern.
  • TXP-Benutzername = admin, TXP-Passwort= admin erfassen
  • Backend aufrufen mit http://localhost/mysite/textpattern-4.0.8/textpattern. Dort Lasche 'Diagnose' anklicken. Das vorhandene Setup-Verzeichnis wird beanstandet.
  • SETUP-Verzeichnis c:/xampp/htdocs/mysite/textpattern-4.0.8/textpattern/setup löschen. In Lasche 'Diagnose' sollte jetzt nichts mehr beanstandet werden.

Falls mehrere TXP-Websites angelegt werden sollen, unter c:/xampp/htdocs neues Verzeichnis für weitere Website anlegen und TXP dorthin extrahieren.

zum Seitenanfang


3. TXP auf Inet-Server installieren


3.1 TXP installieren (je Website)

TXP extrahieren

  • TXP auf ein beliebiges Verzeichnis extrahieren. Vorschlag: Verzeichnis-Name = Website-Name. Beispiel: c:/mysite

Dateien mit FILEZILLA auf Server übertragen

  • In FILEZILLA Server, Benutzer, Passwort eingeben. Bei meinem Provider erhalte ich diese Daten aus der Maske des FTP-Tools des Providers.
  • Mit dem FILEZILLA-Explorer das lokale Verzeichnis mysite/textpattern-4.0.8 auf das Server-Root-Verzeichnis kopieren. Der Kopiervorgang dauert bei mir ca. eine Minute.
  • Die TXP-Website ist dann unter http://mydomain/mysite/ textpattern-4.0.8 aufrufbar.
  • Tipp: das Verzeichnis mydomain/mysite/textpattern-4.0.8 als Startverzeichnis für die (Sub-)Domain beim Provider festlegen. Damit entfallen nachträgliche Pfadkorrekturen in TXP z.B. bei Bildern.

DB auf Server anlegen

  • DB-Name, -Benutzer, -Passwort auf Server eingeben. Bei meinem Provider wird die DB mit einem Tool des Providers erstellt.
  • Tipp: für alle Eingaben auf dem Server Kleinschreibung benutzen.

TXP installieren

  • Frontend-Adresse: http://mydomain/mysite /textpattern-4.0.8
  • Backend-Adresse: http://mydomain/mysite /textpattern-4.0.8/textpattern
  • Die unter Punkt 2.3 ab 'Frontend aufrufen" beschriebenen Aktionen durchführen. Die lokalen Angaben im Text sind dabei durch die Backend-Adresse auf dem Inet-Server zu ersetzen.

Wichtige Einstellungen

  • Auf den Ordnern für Bilder und Files müssen die Schreibrechte vollständig vorhanden sein (dh. CHMOD=777). Die Schreibrechte werden in FILEZILLA mit rechter Maustaste/ Dateiattribute eingestellt. Je Ordner müssen alle Haken gesetzt sein.
  • In administration/ einstellungen/ veröffentlichen den Produktionsstatus auf 'live' setzen. Damit werden Fehlermeldungen nur in dringendsten Fällen ausgegeben.

zum Seitenanfang


4. Übernahme einer statischen Website nach TXP


4.1 Kurzbeschreibung TXP-Oberfläche und TXP-Objekte

Frontend, Backend

Das Frontend ist die Website, wie sie der Aufrufende zu Gesicht bekommt.
Das Backend ist die CMS-Oberfläche, mit der die Website und ihre Inhalte gepflegt werden.

  • Bsp. Frontend-Adresse lokaler Server:
    http://localhost/mysite/textpattern-4.0.8
  • Bsp. Backend-Adresse lokaler Server:
    http://localhost/mysite/textpattern-4.0.8/textpattern
  • Bsp. Frontend-Adresse Inet-Server:
    http://mydomain/mysite/textpattern-4.0.8
  • Bsp. Backend-Adresse Inet-Server:
    http://mydomain/mysite/textpattern-4.0.8/textpattern

TXP-Menüpunkte/ Laschen

Es gibt 3 Hauptmenüpunkte in TXP:
Inhalt, Präsentation, Administration.

'Inhalt' hat die Unterpunkte:
Kategorien, Verfassen, Artikel, Bilder, Dateien, Links, Kommentare

'Präsentation' hat die Unterpunkte:
Sektionen, Seitenvorlagen, Bausteine, Stilvorlagen

'Administration' hat die Unterpunkte:
Diagnose, Einstellungen, Benutzer, Protokolle, Plugins, Import

Die für dieses Tutorial relevanten Menüpunkte sind fettgedruckt und werden genauer erläutert.

Präsentation - Sektion (section)

Eine Website besteht aus einzelnen Webseiten. Oberstes Objekt für eine Webseite in TXP ist die Sektion. Der Sektion ist immer eine Seitenvorlage und eine Stilvorlage zugeordnet. Die Standard-Sektion ist die erste Seite einer Website, die sogenannte Frontpage.

Präsentation - Seitenvorlage (page)

Die Seitenvorlage entspricht der HTML-Datei einer herkömmlichen Website. In der Seitenvorlage können TXP-Tags verwendet werden.

Präsentation - Stilvorlage

Die Stilvorlage entspricht der CSS-Datei einer herkömmlichen Website.

Präsentation - Baustein (form)

Bausteine und Artikel sind die zentralen Objekte in TXP. Im Artikel erfasst man den Inhalt bzw. Text, der auf der Webseite ausgegeben werden soll (laufende Erfassung). Im Baustein wird das Layout des Artikels festgelegt (einmalige Erfassung). Es gibt unterschiedliche Bausteintypen. Die hier relevanten Typen sind misc und article. Der Bausteintyp 'misc' ist für Code-Schnipsel gedacht, die nur an einer Stelle - nämlich im Baustein - gepflegt werden sollen. Der Bausteintyp 'article' ist für die Ausgabe und das Layout von Artikeln gedacht.

Inhalt - Artikel (article)

Im Artikel erfasst man den Inhalt bzw. Text, der auf der Webseite angezeigt werden soll. Ein Artikel kann mit HTML-Elementen oder in der TXP-eigenen Auszeichnungssprache TEXTILE formatiert werden.

Inhalt - Bilder

  • Bilder müssen nach TXP hochgeladen werden.
  • Den Pfad eines hochgeladenen Bildes erhält man unter inhalt/ bilder/ tags/ xhtml. Beispiel: http://mydomain/mysite /images/1.gif

TEXTILE

TEXTILE ist eine Auszeichnungssprache für Artikelinhalte in TXP. Sie wird in diesem Tutorial nicht verwendet bzw. erläutert.

TXP-Tags

TXP-Tags sind TXP-spezifische Elemente, die bestimmte DB-Aktionen ausführen z.B. einen Baustein ausgeben, eine Artikelliste sortieren, einen Titel anzeigen usw. Es gibt Elemente mit nur einem öffnenden Tag und Elemente mit einem öffnenden und schließenden Tag. TXP-Tags können in Seitenvorlagen und Bausteinen verwendet werden. Eine Tag-Liste samt Attributen und Beispielen in dt. Sprache findet man unter http://textpattern.kbbu.de/tags/


4.2 Die Übernahme nach TXP: Schritt-für-Schritt

Voraussetzungen

  • Tipp: DB-Namen: User, Passwort, DB gleich benennen z.B. db1
  • Tipp: TXP-Namen: User, Passwort gleich benennen z.B. admin
  • Eine lauffähige Website muss vor der TXP-Übernahme vorhanden sein.
  • Kopie des Website-Verzeichnisses auf Festplatte erstellen. Mit diesem dann arbeiten. Z.B. bei copy and paste oder bei Sicherungen von TXP-Dateien.
  • Tipp: Keine Code-Änderungen in TXP-Seitenvorlagen vornehmen, sondern nur TXP-Ersetzungen wie z.B. Baustein-Aufrufe.

Vorhandene Objekte löschen (sofern löschbar)

Mit der TXP-Installation wird eine Beispiel-Website mitgeliefert. Die Löschung der zugehörigen Objekte bleibt dem Website-Ersteller überlassen. Ich bevorzuge die Löschung aus Gründen der Transparenz bei der späteren Wartung.

  • Unter Lasche 'Inhalte': Artikel, Bilder, Links, Kommentare, Kategorien löschen (in dieser Reihenfolge)
  • Unter Lasche 'Präsentation': Sektionen, Seitenvorlagen, Bausteine löschen (in dieser Reihenfolge)

Bei Löschung beachten:

  • Mindestens eine Seitenvorlage und eine Stilvorlage müssen immer vorhanden sein.
  • Übergeordnete Objekte können erst gelöscht werden, wenn keine untergeordneten mehr vorhanden sind.

CSS-, HTML-Dateien übernehmen

Meine Websites haben überlicherweise zwei CSS-Dateien (struktur.css, layout.css) und je Webseite eine HTML-Datei. Diese überführe ich folgendermaßen nach TXP.

  • TXP-Stilvorlage: eine Stilvorlage in TXP (z.B. namens stilvorlage) aus beiden CSS-Dateien erstellen (copy und paste).
  • TXP-Seitenvorlagen: je HTML-Datei eine Seitenvorlage erstellen. HTML jeweils in eine neue Seitenvorlage übernehmen (copy and paste). Tipp: Seitenvorlagen so benennen wie die HTML-Dateien.
  • TXP-Sektionen: je Seitenvorlage eine Sektion erstellen. Zugehörige Seitenvorlage und die Stilvorlage zuordnen. Alle Checkboxen auf ‚nein' setzen. Standard-Sekton ist die erste Webseite (Frontpage) der Website. Ihr muss die Seitenvorlage mit dem Inhalt der index.html zugeordnet werden. Tipp: Sektionen so benennen wie die HTML-Dateien.
  • Tipp: Vor Menüpunkt-Wechsel Änderungen immer speichern. Sie gehen sonst verloren.

TXP-Tags in Seitenvorlagen einfügen

  • Link zur CSS-Datei:

(ersetzt die bisherigen Links auf CSS-Dateien)
(Wichtig! TXP-Tag im Head der Seitenvorlage, vor dem event. vorhandenen style-Element anbringen)

<txp:css format="link" />

  • Hauptnavigation der Website:

(ersetzt die bisherige Navi)
(Wichtig! Mit dem Sektionstitel wird die Schreibweise für einen Menüpunkt auf der Maske festgelegt)

Navi auf Frontpage:
<ul>
    <li> <span id="high"> menüpunkt1 </span> </li>
    <li> <txp:section link="1" title="1" name="menüpunkt2" /> </li>
</ul>

Navi auf anderer Seite:
<ul>
    <li> <txp:link_to_home> menüpunkt1 </txp:link_to_home> </li>
    <li> <span id="high"> menüpunkt2 </span> </li>
</ul>

  • misc-Bausteine z.B. Baustein mysite-footer:

<p> Letzte Aktualisierung: August 2009 </p>

  • Aufruf misc-Bausteine in Seitenvorlage:

(ersetzt den bisherigen Code)

<txp:output_form form="mysite-footer" />

Tipp: Vorgehen beim Einfügen der TXP-Tags
1. Einfügen der TXP-Tags in Seitenvorlage der ersten Seite.
2. Danach Kopiervorlage mit allen vorhandenen TXP-Tags erstellen.
3. TXP-Tags sukzessive in alle Seitenvorlagen einfügen.

Bilder hochladen und Pfade anpassen

  • Alle Bilder unter inhalt/ bilder hochladen.
  • Pfade sukzessive in Seitenvorlagen und Stilvorlage anpassen.
  • Bei Vorder- und Hintergrundbildern (img, background url) den vollständigen Pfad eingeben. Bsp: url(http://mydomain/mysite/images/4.gif). Die Bildnummer aus inhalt/ bilder entnehmen. Den Pfad aus inhalt/ bilder/ tags/ xhtml/ tag-erstellen entnehmen.

article-Bausteine je Seitenvorlage erfassen

Der Website-Pfleger soll Texte, die vorher in der HTML-Datei standen, in TXP-Artikeln pflegen können. Deswegen müssen bestimmte HTML-Inhalte in TXP-Artikel überführt werden (cut and paste). Die zugehörigen Bausteine und Baustein-Aufrufe müssen in TXP erstellt bzw. in die Seitenvorlagen eingefügt werden. Je pflegbarer Website bzw. je Artikel muss ein eigener Baustein erfasst werden. Folgende Tätigkeiten sind jeweils durchzuführen:

  • article-Baustein erfassen: es soll nur der Artikel-Inhalt ausgegeben werden (kein Titel, Autor usw.). Das erreicht man mit folgendem Baustein-Code:

<txp:article id="n" />
<txp:body />
<txp:article />

Tipp: auf die korrekte Artikelnr achten bzw. diese vorausdenken (wird hochgezählt).
Tipp: zur leichteren Auffindbarkeit bei Vorhandensein vieler Bausteine ein führendes Kürzel im Baustein-Name verwenden. Bsp: xy-baustein

  • Baustein-Aufruf in Seitenvorlage einfügen:

<txp:output_form form="mysite-baustein1" />

  • Artikel erfassen: relevanter Inhalt aus Seitenvorlage in Artikel-Inhalt überführen (cut and paste). Im Artikel die HTML-Formatierung beibehalten (kein TEXTILE verwenden). Wichtig: Zuordnung des Artikels zur richtigen Sektion nicht vergessen.

4.3 Rechte anlegen

Hinweis: ab diesem Abschnitt wird zwischen dem Admin und weiteren Nutzern unterschieden. Mit der Entscheidung für eines der beschriebenen Rechte entscheidet man sich auch für eine der u.g. Vorgehensweisen.

Ziel sollte sein, dass der Website-Pfleger die Artikel, nicht aber das Seitenlayout ändern kann. Hierfür ist das Autor-Recht sinnvoll. Die Handhabung damit ist aber umständlich, da der Autor nur eigene Artikel pflegen darf. Eine Alternative ist das Redakteurs-Recht.

Recht einräumen

  • Unter administration/ benutzer/ rechte die Rechte für weitere Nutzer z.B. den Website-Pfleger anlegen.
  • Das Login-Passwort wird beim Speichern der Rechte von TXP an die Mailadresse des Nutzers verschickt.

Tipp: bei Einrichtung von Rechten für weitere Nutzer, die eigene Mailadresse wg. Passwortversand angeben. Damit kann sich der Admin als weiterer Nutzer z.B. für Testzwecke oder für die Artikel-Erfassung einloggen.
Einschränkung: Der Passwortversand funktioniert beim lokalen Server unter Umständen nicht!

Vorgehensweise bei Vergabe des Autor-Rechts

  • Nach Durchführung von ‚article-Baustein erfassen' und ‚Baustein-Aufruf einfügen' dem Website-Pfleger das Autor-Recht einräumen.
  • Danach als Website-Pfleger einloggen und die Artikel erfassen (s.o.)

Tipp: bei Artikelerfassung immer eine vorgegebene Reihenfolge einhalten z.B. alphabetisch.
Tipp: abschließend die Artikel-IDs mit den IDs in den Bausteinen synchronisieren.

Vorgehensweise bei Vergabe des Redakteurs-Rechts

  • Nach Durchführung von ‚article-Baustein erfassen' und ‚Baustein-Aufruf einfügen' die Artikel erfassen (s.o.)
  • Danach dem Website-Pfleger das Redakteurs-Recht einräumen.

Vorteil: einfache Handhabung, da alles durch Admin erledigbar.
Nachteil: mit Redakteurs-Recht kann auch das Seitenlayout geändert werden!

zum Seitenanfang


5. Legende


5.1 Abkürzungen und Definitionen

TXP = Textpattern
CMS = Content Management System
DB = Datenbank
Inet = Internet
XAMPP = Software mit MYSQL, PHP für Installation eines lokalen Servers
Website = Webauftritt bestehend aus mehreren Webseiten
Webseite = Einzelne Maske einer Website
Frontend = Website, wie sie der Aufrufende zu Gesicht bekommt
Backend = CMS-Oberfläche, mit der die Website samt Inhalte gepflegt wird


5.2 Konventionen

db1 = Platzhalter für DB-Name, -Benutzer, -Passwort
mysite = Platzhalter für Website-Name
mydomain = Platzhalter für Domain-Name
admin = Platzhalter für TXP-Benutzer und -Passwort
n = Platzhalter für eine Zahl
mysite-footer = Platzhalter für misc-Bausteinname
mysite-baustein1 = Platzhalter für einen article-Bausteinname
menüpunkt1, 2 = Platzhalter für Menüpunkt-Name


5.3 Adressen

http://www.andreas-kalt.de/webdesign/textpattern/ :
Tutorials und Beiträge. Sehr brauchbar.
http://textpattern.kbbu.de/ :
Deutscher TXP-Blog. Brauchbar.
http://textpattern.kbbu.de/tags/ :
TXP-Tag-Liste auf Deutsch. Sehr brauchbar.

Druckversion herunterladen

zum Seitenanfang