Comet 4 bietet ab der Version 4.0.5 die Möglichkeit, Textrahmen als HTML Dokument zu exportieren. Stilinformationen werden dabei als CSS Datei ausgegeben. Ziel ist eine möglist genaue Abbildung der InDesign®-Inhalte im HTML Dokument.

Ab Comet 4.1 R20505 gibt es die Möglichkeit, HTML-formatierten Text in InDesign®-Dokumente zu importieren

Die Comet Plugins exportieren den formatierten Text eines Rahmens. Stilinformationen des Dokumentes werden gesammelt und in eine seperate CSS Datei im "resources"-Unterordner des Zielordners abgelegt. Die CSS Stilinformationen ergeben sich aus Absatzformaten, Zeichenformaten, Tabellenformaten und Zellenformaten. Grundsätzlich werden alle unterstützten Stile des Dokumentes exportiert.

Beachten Sie bitte: Der HTML-Export erzeugt keine HTML-Seiten der InDesign®-Dokumentseiten.

Da HTML eine Textstruktur hat, die der von InDesign® ähnelt, wird die Textstruktur folgendermaßen übersetzt:

• Absatz - <p>
• Zeichenstil - <span>
• Tabelle - <table>
• Unsortierte Liste - <ul>
• Sortierte Liste - <ol>
• Inline Rahmen - <iframe>

Lokale Stiländerungen werden dabei direkt in das Stilattribut des jeweiligen Elementes geschrieben.

Zeichenformate werden als <span>-Element in HTML dargestellt. Die unterstützten Parameter entsprechen den Absatzformaten.

Tabellen werden als <table>-Element in HTML dargestellt. Sie unterstützen Kopfzeilen, Fußzeilen, verbundene Zellen und folgende Tabellenformatattribute:

Tabellenzellen werden als <td> Elemente dargestellt. Folgende InDesign® Formatierungsoptionen für Zellenformate werden unterstützt:

Für die Aufzählungspunkte (<li>) von Listen (<ul> und <ol>) wird im TaggedText jeweils ein neuer Absatz erzeugt.

Für die Aufzählungspunkte wird nur die Schreibweise <li>....</li> unterstützt; die Schreibweise <li/> wird nicht unterstützt.

Text zwischen den einzelnen Aufzählungspunkten, sogenannter Raw-Text, wird ignoriert.

Beginnt der HTML-Text mit einer Aufzählungsliste, wird für den Absatztrenner ein zuätzliches <ParaStyle:> an den Beginn der TaggedText-Ausgabe geschrieben. Um den zusätzlichen Absatztrenner beim Einfügen am Textanfang zu unterdrücken, rufen Sie die Funktion html::to_tagged mit folgender Zusatzangabe:

html::to_tagged (html_text, ttResult, "kListAware", 1 ...)

html::to_tagged wird dann (und nur dann) statt des üblichen <ParaStyle:> am Anfang des Ergebnis-TaggedTexts das Pseudo-Tag <OptionalParaStyle:> einfügen. Die priint:comet-Funkionen zum Ein- und Anfügen von Text kennen dieses Tag und

• entfernen es beim Einfügen an der Textposition 0
• wandeln es an allen anderen Textpositionen in ein normales <ParaStyle:> um

Beachten Sie bitte Folgendes:

• Die direkte Umwandlung von HTML in TaggedText mit %!TT_html_ kennt diese Option nicht und verwendet bei Bedarf automatisch das Pseudo-Tag <OptionalParaStyle:>.
• Das Pseudo-Tag <OptionalParaStyle:> ist dem Standard-Import von InDesign® nicht bekannt. Vor der Verwendung des konvertierten Textes außerhalb der priint:comet Funktionalitäten muß es geeignet entfernt oder ersetzt werden.

Diverse InDesign® Steuerzeichen sind entweder in HTML nicht verfügbar oder haben eigentlich eine andere Bedeutung. Diese Zeichen werden folgendermaßen exportiert:

<?ACE HEXCODE ?>, also z.B. <?ACE 8 ?> für das rechtsbündige Tab.

Folgende Zeichen werden so behandelt:

Beim Import werden diese Zeichen dann natürlich zurückgewandelt.

Um TaggedText direkt im HTML zu definieren, verwenden Sie das Pseudo-Tag

<?IDTT ?>

Der Inhalt dieser Tags wird direkt und ohne weitere Konvertierungen in das Ergebnis übernommen. Whitspaces zwischen dem Text und den ? werden ignoriert.

Inline Rahmen werden als seperate HTML Dokumente exportiert und über das iframe-Element verlinkt. Der Dateiname ist dabei die UID des Rahmens + ".html". Es werden Inline-Textrahmen und -Bildrahmen unterstützt. Im Falle eines Bildrahmens besteht die Option, das Bild nur zu verlinken oder es in den "resources" Unterorder des Zielordners zu kopieren. Sollte ein verlinktes Bild nicht mehr existieren, wird ein PNG des Bildes exportiert und ebenfalls im "resources" Unterordner abgelegt. Der Bildname entspricht dabei dem ursprünglichen Namen des Bildes erweitert um die Endung ".png", falls das Ursprungsbild kein PNG war.

InDesign® unterscheidet zwei Arten von Stilhierarchien: Die erste Art bestimmt, auf welchem Stil ein Stil basiert, die zweite unter welchen Stilordner er untergeordnet ist. Beide Arten werden im HTML Export berücksichtigt.

Um die Stilordnerhierarchie beizubehalten werden Stile folgendermaßen im CSS notiert:

p.FormatGruppe1.Absatzformat2 { }

Anwendung im Dokument findet wie folgt statt:

<p class="FormatGruppe1 Absatzformat2"></p>

Auf diese Weise lässt sich nachvollziehen, welcher Stil in welchen Stilordner eingeordnet war.

Leider ist es in CSS nicht direkt möglich, Stile basierend auf anderen Stilen zu erstellen. Der Comet löst das Problem, indem in den CSS Stilen auch Selektoren für die untergeordneten Stile notiert werden. Die Stile haben dabei als Eigenschaften die Differenz zu ihrem übergeordneten Stil. Anschließend wird nur der unterste Stil der Hierarchiekette angewendet.

Im folgenden Beispiel verändert "Absatzformat1" den Schriftschnitt, "Absatzformat2" basiert auf "Absatzformat1" und verändert die Schriftgröße.

Die CSS Notation lautet wie folgt:

p.Absatzformat1, p.Absatzformat2 { font-family: 'Calibri'; }
p.Absatzformat2 { font-size: 14pt; }

Anwendung im Dokument findet wie folgt statt:

<p class="Absatzformat2"></p>

In InDesign® ist es möglich, ohne größere Einschränkungen Namen an Stile zu vergeben. In HTML und CSS ist man da leider etwas eingeschränkt. In CSS haben folgende Zeichen eine besondere Bedeutung:

! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ ` { | } ~

Leerzeichen zwischen Stilnamen werden in HTML/CSS verwendet, um Stildefinitionen zu vererben. In InDesign® ist die Vererbung bereits in die Definition der Stile integriert und Leerzeichen sind (normaler) Teil des Stilnamens. Wollen Sie Stile mit Leerzeichen im HTML-Code verwenden, müssen die Leerzeichen entsprechend kodiert werden, z.B. mit %20. Mehr Infos zu den Kodierungen finden Sie im Folgenden.

Des weiteren dürfen CSS Namen nicht mit einer Zahl oder mit einem Bindestrich gefolgt von einer Zahl beginnen. Aus diesem Grund erhält jeder Stilname das Prefix "priint_".

Ab Comet 4.1 R21800 gibt es zwei verschiedene Möglichkeiten die Stilnamen zu exportieren. Dazu wird der Parameter "kCSSEscapeMode" der cScript Funktion html::export_ verwendet.

Folgende Modi sind verfügbar:

Hex-Modus:
In diesem Modus wird jedes der oben aufgeführten Zeichen durch eine Hex-Escapesequenz ersetzt: 0x + Hexcode des Zeichens. Also z.B. 0x002B für das Gleichheitszeichen. Sie sollten darauf achten, solche Sequenzen in Ihren ursprünglichen Stilnamen zu vermeiden, da eine eventuelle Rückübersetzung nicht mehr eindeutig ist. Der Vorteil dieses Modus ist, dass Stilnamen im CSS und HTML exakt gleich sind.

Beispiele:

Slash-Modus:
Dieser Modus setzt in der CSS Definition einen backslash vor jedes nicht unterstützte Zeichen, in der Anwendung im HTML Text jedoch nicht. Die Stilnamen werden dadurch einfacher zu lesen, allerdings unterscheiden sich CSS Definition und HTML Anwendung, was eventuelle Bearbeitung durch z.B. Textersetzung erschwert. Außerdem werden einige Zeichen gesondert behandelt:

Beispiele:

Zum Import von HTML wird der HTML-Text in TaggedText umgewandelt. Bitte haben Sie Verständnis dafür, dass nur ein beschränkter Umfang der Möglichkeiten, die HTML und CSS bieten, unterstützt werden kann.

Auf Grund der Komplexität von HTML können der HTML-Importe nicht vom WERK II Support abgedeckt werden!

Zum Import von HTML können Sie die Funktion html::to_tagged verwenden. Alternativ und bei direkter Textübergabe können Sie die _html_-Kennung für %!TT-Texte verwenden:

%!TT_html_...

Folgende Tags werden unterstützt:

<table>
	<thead>
		<tr>
			<td>Company</td>
			<td>Contact</td>
			<td>Country</td>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Alfreds Futterkiste</td>
			<td>Maria Anders</td>
			<td>Germany</td>
		</tr>
		<tr>
			<td>Centro comercial Moctezuma</td>
			<td>Francisco Chang</td>
			<td>Mexico</td>
		</tr>
	</tbody>
</table>

string::set (tt, html::to_tagged (str, "kForFrontDocument", 1));

string::set (tt, "%%!TT_html_%s", str);
frame::replace (gFrame, tt);

Andere Tags wie z.B. <div> oder Kommentare (<!--...-->) werden überlesen und ignoriert

Derzeit werden die vom Export geschriebenen CSS Stildefinitionen nicht importiert!

Entsprechend des HTML Exportes werden Formate auf den HTML Knoten durch das Attribut "class" bestimmt. Dabei entspricht das "class" Attribut folgender Knoten folgenden Formaten:

"priint_"-Prefixe in Stilnamen werden entfernt. In HTML reservierte Zeichen, die durch eine Escapesequenz ersetzt wurden, werden zurückersetzt.

Der Import von CSS Attributen wird derzeit nur als Style-Attribut eines HTML Knotens unterstützt (z.B. <span style="font-size:20pt">).

Dabei gilt: Es gilt immer das "zu unterst" gesetzte Attribut, also das Attribut, was in der Hierarchie dem notierten Inhalt am nächsten ist. So wird z.B. das Textattribut "font-size" auf einem <p>-Knoten überschrieben, wenn darunter ein <span> Knoten das selbe Attribut setzt.

Folgende Attribute werden unterstützt:

<td style="width:60pt">Title</td>

HTML-Entities in der Dezimal- (z.B. &#160) und Hexadezimalschreibweise (z.B. &#xA0) werden unterstützt und durch die entsprechenden Zeichen ersetzt (z.B. bei html::to_tagged oder Direktimport in Illustrator). Zusätzlich werden Schlüsselwörter für HTML-Entities (z.B. &nbsp;) unterstützt. Die komplette Liste finden Sie auf https://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references

Für die Unterstützung von HTML steht eine Reihe an cScript Funktionen zur Verfügung:

Export:

• html::export_
• frame::export_html (deprecated)

Import:

• html::to_tagged

Sonstiges:

• html::tidy

Einfacher HTML Export eines Textrahmens:

int main()
{
	String 	folder 		= string::alloc();
	String 	docName 	= string::alloc("HTML Export");
	int 	err 		= 0;

	err = file::select_folder (folder);
	if (err) 
	{
		return 0;
	}

	document::name(docName);

	html::export_frame( gFrame,
	 		"kOutputFolder", folder,
	 		"kOutputName", docName,
	 		"kDocTitle", "Hello World",
	 		"kCSSEscapeMode", 0);

	return 0;
}