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:	234

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:	234

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:	234

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:	234

Tags: Adobe AIR

12 Mai 10 AIR-Datei erstellen

Anleitung: So erstellen Sie eine AIR Help Datei, welche Sie weitergeben können.

1. Um AIR-Dateien zu erstellen, die weitergegeben werden können, bedarf es der Generierung einer Zertifikatsdatei. Einem sogenannten self-signed certificate.
2. Öffnen Sie im bin-Verzeichnis des AIR SDK ein Kommandofenster und setzen den Befehl für die Generierung einer p12-Zertifikatsdatei ab. Ersetzen Sie die Angaben in Großbuchstaben durch eigene Werte entsprechend.

   adt -certificate -cn ZERTIFIKATSNAME 1024-RSA DATEINAME.p12 PASSWORT

3. Im bin-Verzeichnis des AIR SDK wurde eine Zertifikatsdatei DATEINAME.p12 generiert. Kopieren Sie diese in den Ordner C:\DITA-OT1.5\samples\ant_sample\out\airhelp
4. Öffnen Sie die Datei airhelp-packager.bat im Texteditor und ändern die Werte für DATEINAME.p12 und PASSWORT. Vergessen Sie auf keinen Fall den Eintrag -tsa none. Ohne diesen bekommen Sie eine Fehlermeldung Could not generate timestamp: Connection refused: connect.

   CALL "C:/Programme/Adobe/air_sdk/bin/adt" -package -storetype pkcs12
    -keystore "DATEINAME.p12" -tsa none -storepass PASSWORT
    hierarchy.air airhelp-app.xml airhelp.swf help/*

5. Doppelklicken Sie die Datei airhelp-packager.bat. Im Ergebnis ensteht eine Datei hierarchy.air. Sobald ein Nutzer die Adobe AIR SDK installiert hat, kann er auf die air-Datei doppelklicken und als AIR-Anwendung installieren. Die AIR-Anwendungen sind als Link unter Start > Programme zu finden.

   Abbildung 1. AIR Installer Package doppelklicken

   

Links zum Thema:
Creating a self-signed certificate with ADT

	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:	234

Tags: Adobe AIR

12 Mai 10 Leximation AIR Help DITA-Plugin installieren

Anleitung: So installieren und testen Sie das AIR Help Plugin.

Voraussetzung: DITA OT 1.5

1. Entpacken Sie die ZIP-Datei lmi-airhelp.VERSION.zip in den Ordner DITA-OT/demo. Als Ergebis entsteht ein Ordner lmi-airhelp.
2. Falls Sie schon Flex Builder installiert haben, machen Sie mit dem nächsten Schritt weiter. Falls nicht, laden Sie bitte folgende Komponenten herunter und installieren Sie diese:
   • Adobe Flex SDK
     (http://www.adobe.com/cfusion/entitlement/index.cfm?e=flex3sdk)
   • Adobe AIR SDK
     (http://www.adobe.com/products/air/tools/sdk/)
3. Editieren Sie die Datei C:\DITA-OT1.5\demo\lmi-airhelp\airhelp.properties. Tätigen Sie die Pfadangaben für die soeben entpackten Komponenten. Dies kann bspw. so aussehen:

   FLEX.SDK_HOME = C:/Programme/Adobe/flex_sdk_3-4
   AIR.SDK_HOME = C:/Programme/Adobe/air_sdk
   

4. Fügen Sie die Datei lmi-airhelp.jar Ihrem Classpath hinzu. Unter Windows unter Startschaltfläche > Systemsteuerung > System > Registerkarte Erweitert > SF Umgebungsvariablen

   C:\DITA-OT1.5\demo\lmi-airhelp\lmi-airhelp.jar;

5. Melden Sie sich am Betriebssystem wieder neu an bzw. starten Sie Ihren Rechner neu.
6. Doppelklicken Sie die startcmd.bat und setzen Sie folgenden Befehl ab:

   ant -f integrator.xml

7. Kopieren Sie die die Datei sample_airhelp.xml in den Ordner C:\DITA-OT1.5\samples\ant_sample.
8. Starten Sie den Build der Beispieldateien per:

   ant -f samples/ant_sample/sample_airhelp.xml

9. Angenommen der Build war erfolgreich, ist unter C:\DITA-OT1.5\samples\ant_sample\out\ ein neuer Ordner airhelp entstanden. Doppelklicken Sie auf die darin liegende Datei airhelp-test.bat, um die Beispiel-AIR-Help zu generieren. Diese Hilfe kann noch nicht als air-Datei abgespeichert werden.
   Abbildung 1. AIR Help mit Beispiel-Dateien

   

Links zum Thema:
leximation.com/airhelp
Adobe Flex SDK
Adobe AIR SDK

	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:	234

Tags: Adobe AIR