Site-Dokumentation

Inhalt

    1. Inhalt
  2. Einführung
    1. Technischer Hintergrund
    2. Inhalt und Gestaltung
  3. Schnellstart
  4. Erläuterungen - Schritt für Schritt
    1. Eins
      1. Programmatischer Teil:
      2. Textlicher Teil (Artikeltext):
    2. Zwei
    3. Drei und Schluss
      1. Schluss
    4. Distribution
  5. Weiterführende Seiten
    1. Vorlagen
    2. Verwaiste Links
    3. Administratives
    4. Verwendete Direktiven

Einführung

Technischer Hintergrund

dev.coidoarchitects.de verwendet das wiki-Kompilierungswerkzeug ikiwiki, um die gesamte Site dev.coidoarchitects.de in Form statischer HTML-Dokumente, zu erzeugen.

Als Eingabewerkzeug dient ein Textfeld im Browser in das sämtliche Inhalte, wie Titel, Überschriften und Textabschnitte, sowie auch Angaben zu einzelnen programmatischen Aufrufen als einfacher Text eingegeben werden.

Diese Form der Erstellung und Bearbeitung erfordert eine kurze Zeit der Gewöhnung, da nah an der Programmatik des Systems gearbeitet wird. Somit erscheint, neben den einzupflegenden textlichen Inhalten, zum Teil auch die spezifische Syntax einiger Aufrufe zur Eingabe direkt im Textfeld, was im Umgang damit eine gewisse Genauigkeit erfordert.

Die Vorteile dieser Arbeitsweise liegen in der Möglichkeit, im Hintergrund, das System auf genau das zu zuschneiden, was benötigt wird, dies erhöht die Übersicht bei der Arbeit mit Inhalten und gleichzeitig die Effizienz, da auch auf alle weiteren bereits vorliegenden Funktionen des Systems zu jeder Zeit, je nach nach Bedarf und Kenntnis, zugegriffen werden kann. Zudem ist es möglich auch wesentliche Erweiterungen des Systems um ein vielfaches schneller zu entwickeln und bereitzustellen, als dies mit monolithischen Systemen möglich ist.

Nicht zuletzt bedeutet die nach der Erstellung bzw. Bearbeitung eines Artikels erfolgende Bereitstellung der Inhalte in Form statischer HTML-Dokumente, dass jeder Seitenaufruf unmittelbar erfolgt, ohne dass diese Inhalte zunächst noch vom Server generiert werden müssen.
Diese Arbeitsweise belässt den gesamten Spielraum der Zeit vom einzelnen Seitenaufruf bis zur Darstellung der Seite im Browser beim Browser selbst. Dies bedeutet Zeit für die Ausführung von Skripten und Stilvorlagen. Durch diesen Zeitvorteil können Benutzer auch eine Site mit modernen, technisch anspruchsvollen Darstellungen, Abläufen und Inhalten ebenso schnell wie eine lokal ausgeführte Anwendung betrachten.

Inhalt und Gestaltung

Neben der Texteingabe wird für das Hinzufügen von weiteren für eine Seite gewünschter nicht textlicher Inhalte, wie z. B. Bildern und anderen Medienformaten, eine Funktion zum hochladen der gewünschten Dateien verwendet. Diese Dateien werden in die zu erstellende resp. zu bearbeitende Seite im Augenblick der Kompilierung (sprich: Seitenerstellung) integriert.

Die für die visuelle Gestaltung und die Seitenerstellung sowie die korrekte Strukturierung der Inhalte und Seiten der gesamten Site notwendigen programmatischen Befehle werden durch Einbindung und Anpassung verschiedener Vorlagen mittels kurzer Texteinträge aufgerufen.

Um die Erstellung und Bearbeitung der Inhalte einer Seite (so wie sie im Browser angezeigt werden soll) einfach zu halten, werden einzelne inhaltlichen Elemente (der eigentliche Artikel, Verweise auf andere Artikel, Navigation, Skripte für dynamische Inhalte) grundsätzlich als getrennte Elemente behandelt. Sie sind somit - auch für die Arbeit an einer umfangreichen einzelnen Seite - nicht im Blick, dies erleichtert die Übersicht.

Alle Arbeitsschritte erfolgen ausschließlich über den Browser. Es sind keine zusätzlichen Werkzeuge erforderlich.

Keine Sorge, bereits nach der ersten selbst erstellten Seite erscheint dies wesentlich einfacher - das ist das Schöne .-) Und es ist keinesfalls erforderlich alle Möglichkeiten und Abläufe des Systems zu verstehen. Um einzelne Seiten zu erstellen und damit auch komplexeste und technisch anspruchsvolle Sites zu erzeugen, genügt es die drei folgenden Arbeitsschritten zu lernen und auszuführen.

Schnellstart

In der Adresszeile des Browsers die Adresse aufsuchen, unter der der Artikel erstellt werden soll, z. B.:

http://dev.coidoarchitects.de/projekte/gewerbe/

Namen des zu erstellenden Artikels (ohne Sonderzeichen und Leerzeichen) anhängen und Eingabetaste drücken:

http://dev.coidoarchitects.de/projekte/gewerbe/neubau

Über den Verweis 'Attachments' durch Klick auf 'Choose files' gewünschte Bild-Dateien hochladen. Die Dateien sollten keine Sonderzeichen oder Leerzeichen enthalten.

Im Textfeld über der aktualisierten Datei-Übersicht in der Zeile [[!meta title="" sortas=""]] den Anzeige-Titel der Seite (Leerzeichen und Sonderzeichen sind hier erlaubt) und eine Sortierungsnummer eingeben:

[[!meta  title="Neubau" sortas="001"]]

In der Zeile mit dem vorgegebenen Eintrag [[!tag projekte/gewerbe]] weitere 'tags' zur Anzeige der Seite in anderen Sektionen eingeben:

[[!tag projekte/gewerbe projekte/wettbewerbe]]

Die 'tags' folgen der Konvention der Adressen im Browser.

In die Vorlage der Übersichtsdarstellung [[!template id=mauerstein BILD="" ...]] den Namen des gewünschten Bildes und Texte für Titel (Bildüberschrift), Kopfzeile und Schlagzeile eingeben. Sofern die Schlagzeile umgebrochen werden soll, den umgebrochenen Teil als Umbruch eingeben:

[[!template  id=mauerstein

BILD="Neubau_1" TITEL="Gewerbe"
KOPFZEILE="Neubau"
SCHLAGZEILE="Grundsteinlegung" UMBRUCH="Richtfest"]]

In die Zeilen mit den Vorlagen für die einzelnen Bilder der Galerie [[!template id=g-img BILD="" ...]] den Namen des gewünschten Bildes, Angaben zu Breite und Höhe und Quelle des verwendeten Bildes. Bei Bedarf die die Zeile der Vorlage duplizieren, nicht verwendete Vorlagen entfernen:

[[!template  id=g-img BILD="Neubau1" B="1136" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau_1" B="935" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau2" B="712" H="700" QUELLE=""]]

Quellenangaben sind optional.

In den Zeilen #Schlagzeile, Textzeile und Textabsatz die gewünschten Texte eingeben. # legt die Größe der Schlagzeile fest, eine Leerzeile erzeugt einen Absatz:

#Grundsteinlegung
Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.
Consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Der erste Absatz wird im Layout als Unterzeile zur Schlagzeile behandelt, alle weiteren Absätze als Absätze.

Achtung! Alle programmatischen Aufrufe im Textfeld wie z.B.

[[!if  test="included()" ...

müssen unverändert belassen werden.

Save Page klicken. Das System erzeugt die erstellte Seite und kompiliert alle Seiten, die die Übersichtsdarstellung der neuen bzw. bearbeiteten Seite enthalten, neu.

Fertig!

Erläuterungen - Schritt für Schritt

Eins

Um eine neue Seite für dev.coidoarchitects.de zu erstellen, wird über den Browser auf der bestehenden Site die Kategorie aufgesucht, zu der eine Seite hinzugefügt werden soll. Zur Erstellung einer neuen Seite, die im Abschnitt Projekte der Kategorie Gewerbe hinzugefügt werden soll ist dies z.B. Projekte/Gewerbe.

Dort wird in der Adressleiste des Browsers der für die neue Seite gewünschte Name hinter der angezeigten Adresse (nach dem letzten Schrägstrich) eingegeben, z.B. wird http://dev.coidoarchitects.de/projekte/gewerbe durch 'neubau' ergänzt dadurch zu http://dev.coidoarchitects.de/projekte/gewerbe/neubau. Nach Betätigung der Eingabe-Taste wird damit das Textfeld für die Erstellung der Seite 'neubau' angezeigt.

Achtung! In der Adresszeile sind für diesen Vorgang ausschließlich Zahlen und Buchstaben des englischen Alphabetes sowie Bindestrich und Unterstrich erlaubt - keine Leerzeichen, keine Sonderzeichen! Entsprechend sollte der Name für die zu erstellende Seite gewählt werden.

Im angezeigten Textfeld sind bereits einige der benötigten Anweisungen eingegeben, die für eine Erstellung der Seite an dieser Stelle der Site vorgesehen bzw. zugelassen sind:

[[!pagetemplate  template=gallerypage.tmpl]]
[[!meta   title="" sortas=""]]
[[!tag  projekte/gewerbe]]
[[!if   test="included()"
...
[[!template id=mauerstein

BILD="" TITEL="Gewerbe"
KOPFZEILE=""
SCHLAGZEILE=""]]

...
[[!template  id=g-start]]
[[!template  id=g-img BILD="" B="" H="" QUELLE=""]]
[[!template  id=g-img BILD="" B="" H="" QUELLE=""]]
[[!template  id=g-img BILD="" B="" H="" QUELLE=""]]
[[!template  id=g-ende]]
#Schlagzeile
Textzeile
Textabsatz
[[!template  id=m-start]]
[[!inline  pages="tagged(projekte/gewerbe) and !*.* and !*/sidebar" archive=yes show=0 raw=yes sort="title mtime" reverse=yes]]
[[!template  id=m-ende]]
...]]

Auf den ersten Blick wirkt die reine Textform anspruchsvoll, aber es ist wesentlich einfacher als es erscheint. Und tatsächlich beinhaltet dieser kurze Textblock nach der Bearbeitung alles, was zur Erstellung der vollständigen Seite und zu ihrer korrekten Einbindung in die gesamte Site benötigt wird.

Die Erläuterungen zu den Arbeitsschritten am Textblock sind in zwei Abschnitte unterteilt, einen technisch programmatischen, in dem die grundlegenden Einträge für Navigation, und inhaltliche Bestückung vorgenommen werden, sowie einen textlichen, in dem der Artikeltext der Seite eingegeben und die Seite abgespeichert und im System integriert wird.

Programmatischer Teil:

Innerhalb der Aufrufe [[...]] werden Elemente wie Titel, Namen der verwendeten Dateien etc. abgefragt.

Die programmatischen Bestandteile in doppelten eckigen Klammern [[]] gefolgt von ! und der Bezeichnung des Aufrufs der Reihe nach:

Der erste Aufruf bleibt unverändert. Er legt fest mit welcher Gestaltungsvorlage die Seite erstellt wird.

[[!pagetemplate  template=gallerypage.tmpl]]

Der Metatitel der Seite sowie die Kennnummer für ihre Einsortierung auf den Übersichtsseiten und der Startseite werden eingetragen. 'Neubau' wird hier der Titel der Seite, und für eine flexiblere spätere Sortierung kann eine Nummer vergeben werden, hier '001':

[[!meta  title="Neubau" sortas="001"]]

Es folgt die Auszeichnung der zu erstellenden Seite über den 'tag'-Eintrag.

[[!tag  projekte/gewerbe]]

Das jeweils vorgegebene 'tag' sorgt für die standardmäßig für diese Sektion vorgesehene Auszeichnung, um die Seite auf den zugehörigen Übersichtsseiten (und wiederum diesen übergeordneten Seiten) anzeigen zu lassen. Soll die zu erstellende Seite zusätzlich in einer anderen Sektion angezeigt werden, kann eine zusätzliche Auszeichnung eingetragen werden, z.B. um die Seite zusätzlich in der Übersicht der Sektion 'Wettbewerbe' anzeigen zu lassen:

[[!tag  projekte/gewerbe projekte/wettbewerbe]]

Anmerkung: Der Teaser einer Seite wird in den Übersichten grundsätzlich nur einmal angezeigt, unabhängig davon, wieviele verschiedene Auszeichnungen sie enthält. Auf dem Übersichtsteil der Seite selbst, wird diese grundsätzlich nicht angezeigt. Es entstehen keine Dopplungen.

Die zusätzlichen sichtbaren programmatischen Elemente wie z.B.

[[!if   test="included()"

sind für die korrekte Seitenerstellung und Verlinkung notwendige Befehlsschritte und müssen erhalten bleiben.

Zu verwendende inhaltliche Vorlagen stehen ebenfalls in doppelten eckigen Klammern, gefolgt von '!template' sowie der Angabe der ID der Vorlage:

\[[!template id=... ]]

Dahinter finden sich die Abfragen der für die Verwendung der Vorlage notwendigen Einträge. Für die erste Vorlage ist die ID 'mauerstein' bereits vorgegeben. Diese Vorlage erzeugt eine Übersichtsdarstellung, den Teaser, der Seite, welche vom System als einzelner 'Mauerstein' auf der Startseite und allen weiteren Seiten verwendet werden kann. Diese Einbindung erfolgt automatisch. Die weiteren für diese Vorlage benötigten Einträge werden nun für das zu verwendende Bild, den Titel (über dem Übersichtsbild), die Kopfzeile (über der Schlagzeile) und die Schlagzeile selbst vorgenommen. Sofern die Schlagzeile umgebrochen werden soll, wird der umgebrochene Teil als Umbruch eingegeben:

[[!template  id=mauerstein

BILD="Neubau_1" TITEL="Gewerbe"
KOPFZEILE="Neubau"
SCHLAGZEILE="Grundsteinlegung" UMBRUCH="Richtfest"]]

Achtung: Die Einträge in programmatischen Aufrufen müssen jeweils zwischen den Anführungszeichen stehen, und und zwischen den Einträgen muss jeweils mindestens ein Leerzeichen stehen. Einträge, die auf Dateien, z.B. Bilddateien, verweisen dürfen keine Leerzeichen enthalten. Bei Dateienamen, die ein oder mehrere Leerzeichen enthalten, ersetzt das System diese automatisch durch Unterstrichen - diese Unterstriche müssen im Eintrag mit eingegeben werden.

Variation: Der Titel (Bildüberschrift) und die Kopfzeile können alternativ in Rot gesetzt werden. Hierfür wird an den vorgegebenen ID-Eintrag einfach '-rot' angehängt.

[[!template  id=mauerstein-rot BILD="Neubau_1"

TITEL="Gewerbe"
KOPFZEILE="Neubau"
SCHLAGZEILE="Grundsteinlegung" UMBRUCH="Richtfest"]]

Als nächstes werden die Bilddaten eingegeben:

Die Aufrufe für die Galerievorlage stehen am Anfang und am Ende der Bild-Aufrufe und bleiben unverändert:

[[!template  id=g-start]]
...
[[!template  id=g-ende]]

Dazwischen werden die Einträge für die in der Gallerie zu zeigenden Bilder vorgenommen. Drei entsprechende Aufrufe für diese Vorlagen sind im Textfeld bereits vorgegeben. Die Einträge können bei Bedarf dupliziert werden. Nicht verwendete Aufrufe müssen vollständig aus dem Textfeld gelöscht werden.

Es können neben Bildern auch Textinhalte sowie von externen Quellen eingebettete Video oder Video-Playlists eingepflegt werden. Wir dein entsprechendes Pagetemplate geladen sind die hierfür benötigten Aufraufe für diese Vorlagen bereits enthalten.

Generell können alle im Verzeichnis TEMPLATES enthaltenen Vorlagen mit dem Prefix "g-" an dieser Stelle verwendet und mit den entsprechenden Inhalten bzw. Parametern befüllt werden.

Als erster Eintrag bei Bildern erfolgt der Name des Bildes. Dies ist der Name der hochzuladenden Datei ohne Dateiendung, als Format ist intern JPG vorgegeben.
Es empfiehlt sich das für das Bild verwendete Seitenverhältnis als Namen zu verwenden und gegebenenfalls um eine fortlaufende Nummer zu ergänzen, wenn mehrere Bilder verwendet werden sollen. Grundsätzlich ist die Vergabe der Namen jedoch frei. Dopplungen wiederum sind nicht erlaubt.

Sofern die Bilder in der doppelten Auflösung von 1400 Pixel Höhe vorliegen oder in einfacher Auflösung mehr als 700 Pixel aufweisen, werden alle benötigten Skalierungen ebenso wie eine kleinere Auflösung von 280 Pixel (bzw. 588 Pixel für 'Aktuell) Breite für die Übersichtsdarstellung automatisch generiert und zur Seitenerstellung bereitgestellt.

Als nächstes wird die Breite des Bildes in Pixel angegeben, diese sollte 1204 Pixel (entsprechend der Seitenbreite) nicht überschreiten. Die Angabe der Höhe ist mit 700 vorgegeben. Für Bilder von mehr als 700 Pixel Höhe muss die Eingabe entsprechend der tatsächlichen Höhe eingegeben werden. Die Ausgabe der Bilder in der Galerie erfolgt immer in maximal 700 Pixel Höhe.

Als letzter Schritt in dieser Vorlage erfolgt die Angabe der Bildquelle (erscheint als Bildunterschrift in der Galerienansicht).

[[!template  id=g-start]]
[[!template  id=g-img BILD="Neubau1" B="1136" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau_1" B="935" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau2" B="712" H="700" QUELLE=""]]
[[!template  id=g-ende]]

Für die Einbettung von Videos bzw. Playlists stehen zusätzlich folgende Vorlagen zur Verfügung. Hier werden jeweils die Video-ID resp. die Playlist-ID sowie ggf. ein Titel eingetragen:

[[!template  id=g-start]]
[[!template  id=g-youtube-pl B="1202" VIDEO="" TITLE=""]]
[[!template  id=g-youtube-pl B="1202" PLAYLIST="" TITLE=""]]
[[!template  id=g-ende]]

Die Parameter für die Breite sind hier bereits vorgegeben. Videos werden mit dem Seitenverhältnis 16:9 (Standard) entsprechend dem gesetzten Seitenverhältnis der Gallerie (1.77:1) dargestellt.

Um Text direkt in der Galleriedarstellung anzuzeigen kann die folgende Vorlage befüllt werden. Text sollte in diesem Kontext möglichst knapp gehalten werden - er dient hier im Wesentlichen der reinen Präsentation von Ankündigungen oder ähnlichem:

[[!template  id=g-text UEBERSCHRIFT="" 
UNTERZEILE="" 
TEXT="
" COPYRIGHT=""]]

Die Quellenangabe kann in allen Vorlagen, wenn nicht benötigt, leer gelassen werden.

Textlicher Teil (Artikeltext):

Die hierauf folgenden Einträge werden die textlichen Bestandteile des eigentlichen Artikels, der unterhalb der Galerie erscheint. Diese Einträge bestehen aus einfach zu formatierenden Eingaben. Das System verwendet die Syntax 'Markdown' als Formatierungssprache um Texteingaben zu gestalten. Die für die Erstellung der Seite zu verwendenden Formatierungen sind ein Asterisk '#' am Anfang einer Zeile (für die Schlagzeile) sowie eine Leerzeile, um einen einfachen Absatz zu erzeugen.

#Grundsteinlegung
Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.
Consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.

Damit sind alle notwendigen Eingaben erfolgt:

[[!pagetemplate  template=gallerypage.tmpl]]
[[!meta   title="Neubau" sortas="001"]]
[[!tag  projekte/gewerbe projekte/wettbewerbe]]
[[!if   test="included()"
...
[[!template id=mauerstein

BILD="Neubau_1" TITEL="Gewerbe"
KOPFZEILE="Neubau"
SCHLAGZEILE="Grundsteinlegung" UMBRUCH="Richtfest"]]

...
[[!template  id=g-start]]
[[!template  id=g-img BILD="Neubau1" B="1136" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau_1" B="935" H="700" QUELLE=""]]
[[!template  id=g-img BILD="Neubau2" B="712" H="700" QUELLE=""]]
[[!template  id=g-ende]]
#Grundsteinlegung
Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.
Consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
[[!template  id=m-start]]
[[!inline  pages="tagged(projekte/gewerbe) and !*.* and !*/sidebar" archive=yes show=0 raw=yes sort="title mtime" reverse=yes]]
[[!template  id=m-ende]]
...]]

Je nach Art der Verwendung der erstellten Seite innerhalb der gesamten Site befindet sich am Ende des Textblocks noch der Aufruf [[!inline ...]] eingeschlossen von zwei weiteren Aufrufen der Vorlagen für den Bau der 'Mauer' aus der obigen Vorlage 'mauerstein'. Diese Aufrufe bleiben, wie bei der Galerievorlage ebenfalls unverändert.

Der Aufruf [[!inline ...]] an sich sorgt für die Einbindung einer Übersicht weiterer Seiten in Gestalt ihrer Übersichtsdarstellung in die erstellte Seite. Dieser Eintrag bleibt in der Regel unverändert, kann jedoch zur Auswahl von anzuzeigenden Site-Kategorien, Sortierungsreihenfolgen und anderer Funktionen nach Bedarf äußerst vielseitig verändert werden.

Zwei

Als nächstes wird über den Link "Attachments" der Abschnitt mit den für die Seite benötigten Dateianhängen geöffnet. Über "Choose File" wird die hochzuladende Datei ausgewählt. Es ist empfehlenswert die Dateien bereits jeweils mit dem oben angegebenen Namen versehen hochzuladen. Eine nachträgliche Umbenennung oder auch der Austausch einer Datei ist jedoch auch nach der Erstellung der Seite zu jeder Zeit möglich.

Die Reihenfolge von Schritt eins und Schritt zwei ist umkehrbar. Die Umkehrung kann für die zügige Erstellung von Vorteil sein, da die bereits hochgeladenen Dateien immer im Blick sind und so die Dateinamen schneller und fehlerfrei einegegben werden können.

Drei und Schluss

Über "Preview" kann die Anzeige einer Voransicht der bearbeiteten Seite aufgerufen werden. Die 'Preview' kann zu jeder Zeit während der Eingaben geöffnet werden.

Mit "Cancel" wird die Erstellung oder Bearbeitung der Seite abgebrochen. Eine neue Seite wird entsprechend nicht erstellt, eine Bearbeitung nicht gespeichert.

Über "Save" wird der aktuelle Stand der Erstellung bzw. Bearbeitung gespeichert und die gerade erstellte oder bearbeitete Seite kompiliert.

Alle anderen Seiten der Site, die von der Erstellung bzw. Bearbeitung der Seite betroffen sind, d.H. solche die ihrerseits eine Übersichtsdarstellung der neu erstellten oder bearbeiteten Seite einbinden, werden zugleich automatisch neu kompiliert.

Fertig!

Schluss

Die neu erstellte bzw. bearbeitete Seite wird angezeigt. Sie wird, mit ihrer Übersichtsdarstellung, zugleich auf allen Seiten, auf denen die Kategorie, der sie angehört, eingebunden ist, angezeigt. Entsprechend verweist ihre dort jeweils angezeigte Übersichtsdarstellung auf sie selbst. D.H. sie kann von den verschiedenen Übersichten aus aufgerufen werden.

Um eine bereits bestehende Seite zu bearbeiten genügt es den Mauszeiger zur oberen Kante des Fensters zu bewegen und dort den Eintrag 'Edit' auszuwählen.
Dort können unter 'Preferences' auch die Anmeldung eines neuen Redakteurs vorgenommen oder andere Seiten auf dem Pfad bis zur geöffneten Seite aufgerufen werden.

Am Fuss jeder in in die Site-Struktur eingebundenen Seite finden sich außerdem Links aller auf die aufgerufene Seite verweisenden Seiten, sowie ein Hinweis auf den Zeitpunkt der letzten Bearbeitung.

Diese Elemente sind nicht Bestandteil des Produktionsansicht, also der Seiten, die an die Benutzer ausgeliefert werden.

Distribution

Die Entwicklungsumgebung dev.coidoarchitects.de wird über einen cron-Job auf dem Server für die Distribution kompiliert. Hierbei werden mittels der Werkzeuge rsync und sed für die Live-Ansicht nicht benötigte Elemente entfernt, Skripte und HTML- und Stildateien minifiziert und anschließend das Ganze in das Distributionsverzeichnis 'dist' kopiert. Von dort werden die Seiten an die Besucher von https://coido.de bzw. https://coidoarchitects.de ausgegeben.

Um den Distributionsprozess einzuleiten wird die Seite Veröffentlichen zur Bearbeitung geöffnet, auf dieser Seite und im entsprechenden Textfeld findet sich eine kurze Übersicht des aktuellen Standes, letztes Veröffentlichungsdatum. Die Seite kann ohne weitere Einträge über 'Save' erneut gesichert werden, die erneute Sicherung setzt den Distributionsprozess in Gang.

Weiterführende Seiten

Auf dem Entwicklungsabschnitt dieser Domain finden sich neben den benötigten Werkzeugen auch weitere Seiten, die tiefer gehende Informationen zum System beinhalten, Vorlagen zur Seitenerstellung, sowie diese Dokumentation.

Vorlagen

Verwaiste Links

Administratives

Verwendete Direktiven