17 Mai 10 AIR Help – Umlaute im Inhaltsverzeichnis und Index

Anleitung: So stellen Sie deutsche Umlaute im Inhaltsverzeichnis und Stichwortverzeichnis richtig dar.

Anmerkung: Für die deutschen Umlaute ist noch manuelle Nacharbeit geboten. Für die Suchergebnisse im Search-Tab konnte ich noch keine Lösung finden.

1. Editieren Sie die Datei C:\DITA-OT1.5\demo\lmi-airhelp\xsl\map2ahtoc.xsl folgendermaßen: Fügen Sie beim xsl:output das Attribut encoding="ISO-8859-1" hinzu.
2. Editieren Sie die Datei C:\DITA-OT1.5\demo\lmi-airhelp\xsl\map2ahp.xsl in der gleichen Weise: Fügen Sie beim xsl:output das Attribut encoding="ISO-8859-1" hinzu.
3. Setzen Sie den Build-Befehl für die AIR-Help-Generierung ab. Im Outputverzeichnis ändern Sie danach die Datei DATEINAME.ahix in der ersten Zeile von UTF-8 in ISO-8859-1.

	Titel des Downloads:	Ausgabeformat AIR-Help
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel "Ausgabeformat AIR-Help" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
	Aktualisiert am:	12.07.2010
	Anzahl der Downloads:	116

Tags: Adobe AIR

17 Mai 10 Auto-Update einrichten

Anleitung – So richten Sie bei der AIR-Help die Suche nach einem Update ein.

Voraussetzung: LMI Airhelp 0.06 als Plugin-Version. Ebenso muss in der Hauptditamap die Prodinfo-Versionsnummer hinterlegt sein.

1. Nachdem Sie alle inhaltlichen Änderungen vorgenommen haben, nehmen Sie im letzten topicref-Element der Haupt-Ditamap den topicmeta-Eintrag für die Versionsnummer vor. Hier speziell vrm version.

   <topicref href="topics/common/impressum_con.xml"
   scope="local" type="concept" xml:lang="de-de">
   <topicmeta>
   <copyright><copyryear year="2009"/>
   <copyrholder>ditalog.com</copyrholder>
   </copyright>
   <prodinfo>
   <prodname>ditalog</prodname>
   <vrmlist><vrm version="0.2"/></vrmlist>
   </prodinfo>
   </topicmeta>
   </topicref>
   

   Im Beispiel ist die 0.2 die neue Versionsnummer. In der derzeitigen AIR-Applikation ist demzufolge noch die Versionsnummer 0.1 hinterlegt. Erst dieser Unterschied läßt das Adobe Update Framework verkünden, dass eine neue Version zum Download bereitsteht.

2. Erstellen Sie eine Update-Beschreibungsdatei (update descriptor file).

   <?xml version="1.0" encoding="utf-8"?>
   <update xmlns="http://ns.adobe.com/air/framework/update/description/1.0">
   <version>0.2</version>
   <url>http://example.com/updates/ditalog_0.2.air</url>
   <description>Hier kommt Ihr kurzer Erläuterungstext.</description>
   </update>
   

   Die Einträge für version und url sind obligatorisch. Speichern Sie diese Datei unter dem Namen update.xml lokal ab.

3. Öffnen Sie die Datei \demo\lmi-airhelp\app\common.as und tragen Sie den Wert für die Variable gAppUpdateUrl ein. Dies ist die URL der Update-Beschreibungsdatei.static public var gAppUpdateUrl:String =”http://example.com/updates/update.xml”;
4. Starten Sie das Airhelp-Plugin. Im Output-Ordner generieren Sie anschließend mit Hilfe der Datei airhelp-packager.bat die Air-Datei.
5. Kopieren Sie die Update-Beschreibungsdatei und die soeben erstellte Air-Datei auf den Download-Server. Die hinterlegte Domain bei beiden Dateien muß funktionieren! Testen Sie dies, in dem Sie die URL der Update-Beschreibungsdatei im Browser eingeben.
6. Starten Sie die alte, noch installierte AIR-Applikation und klicken Sie auf die Update-Schaltfläche. Im Plugin 0.06 ist diese mit der Versionsnummer versehen. Folgendes Fenster erscheint, wenn ein Update verfügbar ist.

   Abbildung 1. Update manuell auslösen
   

   Abbildung 2. Installation starten
   

	Titel des Downloads:	Ausgabeformat AIR-Help
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel "Ausgabeformat AIR-Help" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
	Aktualisiert am:	12.07.2010
	Anzahl der Downloads:	116

Tags: Adobe AIR

17 Mai 10 Version und Copyright festlegen

Anleitung – So befüllen Sie automatisch die Datei airhelp.ahp mit Versionsnummer und Copyright-Angaben.

Damit die Angaben der Outputdatei airhelp.ahp automatisch aus den DITA-Quelldateien gefüllt werden, ist es wichtig, innerhalb der Haupt-Ditamap im letzten topicref-Eintrag ein topicmeta-Abschnitt einzufügen. Diesen gilt es entsprechend zu füllen.

<topicref href="topics/common/impressum_con.xml" id="impressum_con" scope="local"
type="concept" xml:lang="de-de">
<topicmeta>
<copyright><copyryear year="2009"/>
<copyrholder>ditalog.com</copyrholder>
</copyright>
<prodinfo>
<prodname>ditalog</prodname>
<vrmlist><vrm version="0.2"/></vrmlist>
</prodinfo>
</topicmeta>
</topicref>

Anmerkung: Ohne diese Angaben funktioniert auch der Auto-Update-Mechanismus nicht!

	Titel des Downloads:	Ausgabeformat AIR-Help
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel "Ausgabeformat AIR-Help" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
	Aktualisiert am:	12.07.2010
	Anzahl der Downloads:	116

Tags: Adobe AIR

17 Mai 10 DITA-Build-Datei anpassen

Die Datei sample_airhelp.xmlanpassen.

ant -f C:\DITA-SRC\build\ditalog-airhelp.xml -logger org.dita.dost.log.DITAOTBuildLogger

Build-Datei

Da ich meine individuelle CSS-Datei nutzen und eine Log-Datei generiert haben möchte, habe ich der sample_airhelp.xml zwei property-Elemente hinzugefügt und als ditalog-airhelp.xml abgespeichert.

<project name="sample_airhelp" default="sample2lmi-airhelp" basedir=".">
<property name="dita.dir" value="C:/DITA-OT1.5"/>
<import file="${dita.dir}/integrator.xml"/>

<target name="sample2lmi-airhelp" depends="integrate">
 <ant antfile="${dita.dir}/build.xml" target="init">
  <property name="args.logdir" value="C:/DITA-SRC/log" />
  <property name="args.css" value="C:/DITA-SRC/css/ditalog.css" />
  <property name="args.copycss" value="yes" />
  <property name="args.input" value="C:/DITA-SRC/ditalog.ditamap"/>
  <property name="output.dir" value="C:/DITA-SRC/out/air-ditalog/help"/>
  <property name="transtype" value="lmi-airhelp"/>
 </ant>
</target>
</project>

	Titel des Downloads:	Ausgabeformat AIR-Help
	Art der Publikation:	Kapitel
	Beschreibung:	Das gesamte Kapitel "Ausgabeformat AIR-Help" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
	Aktualisiert am:	12.07.2010
	Anzahl der Downloads:	116

Tags: Adobe AIR