Grundsätzlich kann über die Templates der Quelltext einer Webseite beliebig definiert werden. CONTAILOR macht dazu keine generellen Vorgaben, bietet nur Unterstützung z.B. beim Bundling von Ressourcen. Einige wenige Grundlagen müssen dennoch eingehalten werden. Diese Vorgaben werden im Folgenden aufgelistet und beschrieben.
Um zu vermeiden, dass Shapes nicht pflegbar sind, weil die Toolbars verdeckt werden, gibt es hier eine Auflistung von Z-Index-Bereichen, die verwendet werden können oder durch CONTAILOR reserviert sind.
Bestimmte URL-Bereiche sind von CONTAILOR reserviert und können daher nicht für Seiten verwendet werden.
Darunter fallen:
Außerdem werden bestimmte URLs ebenfalls reserviert:
CONTAILOR sorgt automatisch und im Hintergrund dafür, dass CSS- und Javascript-Dateien zu einem sog. Bundle zusammengeführt werden und dabei auch automatisch komprimiert (minified) werden. Alle *.css und *.js-Dateien, die ".min" vor der Dateiendung haben werden daher ignoriert.
Aufgrund des Bundlings dürfen 'use strict'-Anweisungen in zu bundelndem Code ausschließlich innerhalb von Funktionen verwendet werden, da sich diese sonst auf den Rest des Bundles auswirken würde und so Probleme mit CONTAILOR-eigenem Code auftreten könnten.
CONTAILOR überschreibt im EditMode die Styles für HTML und Body, damit das System auch auf iOD-Geräten einfandfrei funktioniert.
html, body {
height: 100%;
overflow: auto;
-webkit-overflow-scrolling: touch;
}
Dieser Style greift nur auf iOS Geräten, sollte aber nicht überschrieben werden, da sonst die Seite beim Antippen eines Shapes auf iOS-Geräten springt.
Pfade zu Dateien in CSS-Anweisungen müssen vom Root-Ordner ausgehend mit / beginnend angegeben werden (z.B. Pfade in background-url, etc.). Der Grund hierfür ist, dass andernfalls Probleme auftreten können, wenn die Bundles zur Laufzeit zurückgesetzt und neu gebildet werden.
ShapeTypes und deren Templates können beliebig angepasst werden. Um die Definition zu ändern, muss lediglich im Instanz-Ordner unter View\ShapeType\<Name des ShapeType> ein Ordner erstellt werden.
Ab diesem Zeitpunkt gelten die Dateien, die darin liegen und überschreiben den Standard (aus dem Ordner \contailor\DefaultShapeType\<Name des ShapeType>). Existiert in diesem Ordner eine *.css-Datei so werden keine CSS-Dateien aus dem Standard mehr verwendet. So wird auch mit JS-Dateien verfahren.
PageTypes und deren Templates können beliebig angepasst werden. Um die Definition zu ändern muss im Instanz-Ordner unter View\PageType die Config-Datei angelegt und unter View\Template die vbhtml-Datei des Templates erstellt werden.
Ab diesem Zeitpunkt gelten diese beiden Dateien und überschreiben den Standard (aus dem Ordner \contailor\DefaultPageType).
Wird im Grundlayout auf die Startseite zugegriffen muss diese vorher auf Nothing geprüft werden, weil sie unveröffentlicht sein kann. Ansonsten kann es zu einem Fehler kommen, z. B. beim Anzeigen der Custom-404-Seite.
Für Meta-Tags gelten folgende Grundlagen:
Generell kann der Webseitenersteller den HTML-Head gestalten wie es ihm beliebt. Nur die Meta-Angaben, die von CONTAILOR verwaltet werden, dürfen nicht verwendet werden, da diese Tags sonst doppelt vorhanden wären.
Für CONTAILOR vorbehalten sind:
Wird eine andere Handhabung eines der genannten Tags benötigt, so ist das mit der Produktentwicklung abzustimmen bzw. als neuer Feature-Request einzutakten.
Jede Webseite benötigt zum Funktionieren eine Web.config-Datei. Da diese für das korrekte Funktionieren auch von CONTAILOR verantwortlich ist, muss diese dazu passend angepasst sein. Die aktuelle Version der Web.config für die V2 findet sich hier zum Download als Textdatei. Diese ist in allen V2-basierten Instanzen zu verwenden.