itl Institut fürtechnische Literatur

Sonderausgabe FM 12 und TCS5 02/14

[ i ]m FokusDas Fachmagazin von itl

FrameMaker 12 und dieTechnical Communication Suite TCS5

[ i ]m Fokus: FrameMaker 12 und TCS52

Sonderausgabe FM 12 und TCS5 02/14

Adobe veröffentlicht FrameMaker 12 und die Technical Communication Suite TCS5 FrameMaker lebt! Und endlich hat Adobe seinem früher eher ungeliebten Produkt eine Frischzellenkur verabreicht, die FrameMaker wieder einzigartig und als bestes Out-of-the-box-Produkt für die Technische Dokumentation im Ranking an die Spitze schiebt. Adobe selbst sieht dieses Update als wichtigstes seit FrameMaker 7 an, und dieser Review kann das nur bestätigen.

Autor: Dieter Gust, Leitung F&E

Desktop-Publishing neu definiert

Eigentlich gilt das DTP-Zeitalter im Bereich der TechnischenDokumentation durch die High-end-Prozesse komplexer XML-Lösungen als beendet. DTP bedeutet bekanntlich, Dokumenta-tionen direkt im Print-Layout fertigstellen zu können. Das warein riesiger Vorteil gegenüber der klassischen strikten Trennungzwischen dem Editieren von Texten und dem Erstellen des End-

layouts durch Spezialwerkzeuge. Die „neuen“ XML-Prozesseknüpfen an die „alte“ strikte Trennung der Teilprozesse an, nunjedoch mit dem Fokus der industriellen Fertigung von Doku-menten aus Modulen und sonstigen Objekten wie Daten undGrafiken. Dennoch hat Adobe gerade für DTP-Anwender – also für dennicht strukturierten FrameMaker – das Publizieren in Online-Ausgabeformate optimiert. FrameMaker bietet nun z. B. ohnejegliche Zusatzwerkzeuge ein weitgehend konfigurierbaresHTML5-Publishing auf der Grundlage eines Responsive Designs.

Dialog für die Layoutanpassung des HTML5 Responsive Designs

Seit der Revolution der mobilen Endgeräte durch Steve Jobs imJahr 2007 könnte der neue Publikationskanal für mobile Doku-mentation auf Smartphones und Tablets den bisherigen StandardPrint-PDF und Papier ablösen. Bisher begnügte man sich damit,im DTP- oder auch XML-Prozess, PDF-Dateien zu erzeugen.HTML-basierte Ausgaben ließen sich mit oder ohne XML zwareinrichten, allerdings war der Aufwand eher etwas für Program-mierer – er setzte teure Konverter voraus – und der Bedarf ver-gleichsweise gering. Zur Not konnte das PDF auch als Online-Dokumentation herhalten.Nun kommt FrameMaker 12 und bietet out of the box komplettePublikationsstrecken für alle modernen Formate – insbesondereauch für HTML5, dem zukunftsträchtigsten Format für die mo-bile Dokumentation. Damit definiert FrameMaker das DTP neuund zeigt sich beispielsweise im Vergleich zu Word und InDesignals fortschrittlichstes DTP-System. Publikationsformat in FrameMaker 12 zusätzlich zum PDF

[ i ]m Fokus: FrameMaker 12 und TCS5 3

Sonderausgabe FM 12 und TCS5 02/14

Die neuen Veröffentlichungsformen sind zusätzliche Optionenzur professionellen PDF-Ausgabe. In FrameMaker 12 haben dieFrameMaker-Entwickler die meisten der früher nur in RoboHelpzur Verfügung stehenden Konfigurationsmöglichkeiten integ-

riert. Diese Funktionserweiterung ist sicher eine der interessan-testen, aber beileibe nicht die einzige Verbesserung, dieFrameMaker 12 erfahren hat. An dieser Stelle daher ein großesLob an die FrameMaker-Entwicklung.

Prozess-Fluss-Diagramm für die Multikanal-Ausgabe-Optionen. Diese Ausgabe gilt nur für das FrameMaker-Format, nicht für XML-Ausgaben

Dynamic-HTML-Effekte z. B. für „expandable Areas“ sind nunauch in FrameMaker direkt integriert und haben auch in mobilenAnwendungen ihre Berechtigung.Da in FM-Dokumente nun auch Videos importiert werden kön-nen, erfüllt das Programm eigentlich alle wichtigen Aspekte einermodernen HTML5-Ausgabe für Web-Apps. Allerdings gibt es imDetail durchaus noch sehr große Verbesserungsmöglichkeiten:Bisher sind neben dem reinen Videoimport nur für das FLV-For-mat weitergehende Use-Cases umgesetzt. Für HTML5 ist das ein-zig relevante Videoformat MP4 mit H264-Encoding. Für diesesFormat kann FrameMaker 12 weder Sprünge noch Skins definie-ren. Warum auch in FrameMaker 12 nicht das weit bessere User In-terface für die Videoplatzierung von InDesign übernommenwurde, bleibt dem Praktiker ein Rätsel. Allerdings sollte man indiesem Zusammenhang auch bedenken, dass alle Systemherstellerfür ein HTML5-Publishing erst noch am Anfang stehen, die neuenVideo-Use-Cases wirklich anwendergerecht zu durchleuchten.

Dialog in InDesign zur Medienplatzierung, der zu FrameMaker sehrgut passen würde

Linksetzung aus FrameMaker-Texten in ein Video (nur für FLV-Dateien)

Word 2013 kann lediglich Weblinks zu Videos einbinden. Allen-falls mit dem PDFMaker von Acrobat 11 ist eine direkte Videoein-bindung auch in Word möglich. Allerdings ist die Funktionalitätnicht sonderlich stabil und kontrollierbar umgesetzt. BeidenWerkzeugen – Word und InDesign – fehlt jedoch eine mitFrameMaker vergleichbar konfigurierbare Ausgabe nach HTML.Trotzdem bleibt auch für die FM-Entwicklung noch viel zu tun.Zu erwähnen ist auch, dass die umfassende HTML5-Ausgabenur auf dem nicht strukturierten FrameMaker-DTP-Format ba-siert. FrameMaker konvertiert die Daten auf Basis des Mappingsvon Absatz- und Zeichenformaten nach HTML5. Für struktu-rierte Dokumente gibt es kein Mapping der XML-Elemente aufHTML-Tags. Leider wird das von Adobe nicht direkt erwähnt.

[ i ]m Fokus: FrameMaker 12 und TCS54

Sonderausgabe FM 12 und TCS5 02/14

Formatvorlagen-Mapping der FrameMaker-Formate auf HTML-Elemente

Für den strukturierten FrameMaker mit der DITA-XML-Anwen-dung ist die HTML-Ausgabe über die Out-of-the-box-Anbin-dung an das DITA-Open-Toolkit vorgesehen – das gilt somit nurfür XML-Dateien, die auf dem DITA-Standard beruhen. Bei derAusgabe über das DITA-Open-Toolkit sucht man HTML5 jedochvergebens.

Ausgabedialog für das DITA-Open-Toolkit

Hier zeigt sich bereits auf den ersten Blick, dass die so viel geprie-sene XML-Welt nicht automatisch die besseren Optionen für einSingle-Source-Publishing in beliebige Medien bietet. Neben den umfassenden Cross-Media-Publishing-Featuresfallen die weiteren Neuerungen des nicht strukturiertenFrameMaker 12 nicht so sehr ins Gewicht.

Weitere Verbesserungen

Im Detail sind es durchaus Verbesserungen, die auch dem profes-sionellen, langjährigen FM-Anwender angenehm auffallen:

1. Schnellerer Start des Programms

FrameMaker 12 startet viel schneller als die Vorgängerversionen.

2. Verwendung von regulären Ausdrücken im Suchen- Ändern-Dialog

Suchen mit regulären Ausdrücken. Das Bild zeigt das Ersetzen vonZollzeichen als Anführungszeichen in typografische Anführungs-zeichen

Lange erwartet und endlich möglich: Nun sind auch reguläreAusdrücke beim Suchen und Ersetzen erlaubt. So kann man – wieim Bild dargestellt – mit regulären Ausdrücken etwa Zollzeichendurch typografische Anführungszeichen ersetzen.

[ i ]m Fokus: FrameMaker 12 und TCS5 5

Sonderausgabe FM 12 und TCS5 02/14

Die erste FM12-Version hatte noch den Bug, dass Ersetzungstext-zeichen immer im Format „Times New Roman 12 Punkt“ einge-fügt wurden – dies wurde aber bereits mit dem ersten Update(12.0.1.331) behoben.Da reguläre Ausdrücke den meisten Anwendern unbekannt seindürften und das Handbuch kein Tutorial zu diesem Thema ent-hält, nennen wir im Folgenden einige Links, die diesbezüglichsehr gute Hintergrundinformationen und Testwerkzeuge bieten:Das Beispiel im Bild kann man über verschiedene Test-Tools auchim Internet vorab testen, z. B. über http://regexhero.net/tester/Erläuterungen auf Deutsch finden Sie unter:• http://wiki.selfhtml.org/wiki/Perl/

Regul%C3%A4re_Ausdr%C3%BCcke• http://www.math.uni-leipzig.de/pool/tuts/perl/html/

perl_reg.html

3. Absatz-Hintergrundfarbe

Versteckte neue Option „Farbe“ in der Registerkarte „Erweitert“ desAbsatzformatdialogs

Im Dialog für die Absatzformate unter „Erweitert“ kann mannun einem Absatz einen farbigen Hintergrund zuordnen. Dasstellt eine wichtige Verbesserung gegenüber FrameMaker 11 dar.Leider fehlt noch ein weitergehendes Finetuning, wie es etwaWord bietet.

4. Farbige Buttons in den Symbolleisten

Das bisherige Grau in Grau der Buttons kann man jetzt optionalfarbig wählen, und auch die Größe der Buttons kann für hochauf-lösende Monitore verändert werden.

5. Einfügen von QR-Codes mit nachträglicher Editiermöglichkeit

Dialog zur Erstellung von QR-Codes

FrameMaker hat nun einen integrierten Editor zur Definition vonQR-Codes. Für eine Übergangszeit, bei der man noch auf Papier-dokumentation setzen will oder muss, lassen sich mit QR-Codeseinfach nutzbare Verweise z. B. auf Videos setzen.Gerade auf mobilen Medien wie Smartphones werden QR-Codesgern und viel genutzt.

6. Verbesserung des Reviewprozesses über PDF-Dateien und Kommentare

PDF ist lange noch kein „aussterbendes“ Format, wie viele Tech-nologen gerade aus dem XML-Umfeld vorhersagen. PDF bietetweit mehr als nur eine 1:1-Darstellung des Papierlayouts mit ent-sprechender Ausdruckmöglichkeit. Die Kommentarfunktionenvon PDF werden in der Technischen Dokumentation seit Langemfür Reviewprozesse genutzt. Neu in FrameMaker 12 ist nun, dasstrotz Änderungen im FrameMaker-Dokument PDF-Kommentarezuverlässig reimportiert werden können. Die verbesserten Filter-funktionen in den Pods erlauben nun auch eine einfachere Batch-Verarbeitung der PDF-Kommentare, die bekanntlich auf Bedin-gungstags und/oder FM-Marken abgebildet werden.

Die Benutzeroberfläche von FrameMaker ist optional wieder farbig und bietet größere Schaltflächen

PDF-Kommentare können in FrameMaker importiert werden und werden auf Bedingungstags oder Marken abgebildet

[ i ]m Fokus: FrameMaker 12 und TCS56

Sonderausgabe FM 12 und TCS5 02/14

7. Integration des MathML-Gleichungseditors

MathML-Gleichungseditor als Alternative zum 20 Jahre alten Glei-chungseditor

Die Lizenz für den Editor muss allerdings separat erworben wer-den.

8. Realtime-Filterung in den Pods und in Format- und Elementlisten

Gerade bei großen Dokumenten und Büchern sind diese neuenFiltermöglichkeiten eine große Erleichterung beim Prüfen der In-halte.

Bei den Zeichen- und Absatzformaten erreicht man den Dialogüber die Tastaturkürzel F8 und F9, bei der Elementliste im struk-turierten FrameMaker über das Kontextmenü im Strukturfenster.

Sonstige Verbesserungen und Bugfixing

Neben den hier besonders hervorgehobenen Features nenntAdobe folgende Neuerungen:• Single-Click-Feature, um eine komplette Sitzung – einschließ-

lich aller geöffneten Dateien wiederherzustellen• Pod, der alle geöffneten Dateien anzeigt und sie für eine wei-

tere Bearbeitung an- und abwählen lässt

• Integration der DropBox-Dateiablage• Verbesserungen in der Anbindung (sogenannte Konnektoren)

an die CMS Documentum, SharePoint und Adobe ExperienceManager

Die FrameMaker-Entwicklung betont, dass auch viel Aufwand indie Optimierung und das Bugfixing gesteckt wurde, deren Wir-kungen der Benutzer nicht gleich wahrnimmt.

Realtime-Filterung in den Pods für Variablen, Bedingungstags, Einschübe (z. B. referenzierte Grafiken) und Querverweise

[ i ]m Fokus: FrameMaker 12 und TCS5 7

Sonderausgabe FM 12 und TCS5 02/14

XML, DITA und die „neue Leichtgewichtigkeit“

Während dieser Artikel schwerpunktmäßig den nicht struktu-rierten FrameMaker betrachtet, wollen wir nicht verschweigen,dass aus Sicht der FrameMaker-Entwickler und vor allem deramerikanischen FrameMaker-Experten die zahlreichen neuenXML-Funktionen in FrameMaker 12 besonders herausragen.Zudem gibt es nun auch die langersehnte „Leichtversion“:

FrameMaker XML Author. Im Vergleich zur Vollversion wur-den bei FrameMaker XML Author einfach diepublishingrelevanten Funktionen aus dem User Interface her-ausgenommen. Im Hinblick auf die Lizenzierung sollFrameMaker XML Author eine Alternative zu den vielen ande-ren Light-Weight-Editoren wie XMetaL, Arbortext-Editor undOxygen bieten. Er wird daher auch zu einem reduzierten Preisangeboten.

FrameMaker XML Author als separates Produkt oder als dritter Modus in der FrameMaker-Vollversion

Mit FrameMaker XML Author kann man nur XML-Dateien (sowieBuchdateien und DITA-Maps) bearbeiten. Versucht man, FM-Da-teien zu öffnen, kommt eine entsprechende Fehlermeldung. Den-noch kennt FrameMaker XML Author auch die Funktion „Als PDFspeichern“. Allerdings wird der Anwender freundlich darauf hin-gewiesen, dass diese Funktionalität nur für den PDF-Review ge-dacht ist. Das Layout wird auch im PDF entsprechend gekenn-zeichnet.So folgt Adobe FrameMaker 12 vor allem dem Trend in den USA,sich voll auf DITA – den bekanntesten topicorientierten XML-Strukturierungsstandard – zu konzentrieren und bietet auch hierzahlreiche Funktionserweiterungen. Bisher wurde von vielen Ex-perten die FrameMaker-Erweiterung DITA-FM von Leximation(http://leximation.com/dita-fmx/) als die noch bessere DITA-FrameMaker-Lösung angesehen. Es bleibt abzuwarten, wie sichFrameMaker 12 im Vergleich dazu schlägt.

FrameMaker 12 als wichtigstes Update seit FrameMaker 7

FrameMaker 12 ist das mit Abstand wichtigste Update seitFrameMaker 7, und es lohnt sich auch jenseits der XML-Lösun-gen, FrameMaker als DTP-Werkzeug näher anzuschauen. Ein besonderer Dank gebührt auch der aktuellen Politik derFrameMaker-Entwicklung, die den intensiven Kontakt zu denAnwendern sucht und sich bemüht, aus dem bisherigen Anwen-dungsstau die von den meisten Anwendern kritisierten Lückenzu schließen. Allerdings sind einige neue Funktionen nur mit

sehr großem Aufwand zu implementieren, wie z. B. die Unter-stützung der Rechts-nach-links-Sprachen, und daher immer nochnicht umgesetzt. Dennoch hat FrameMaker 12 endlich den At-traktivitätszuwachs erlangt, der nötig ist, um im klassischen Pu-blishing den Trend zu Word und/oder InDesign vielleicht sogarumzukehren.

FrameMaker-Server

Dass es für große Systemumgebungen nun auch einen echtenFrameMaker-Publishing-Server mit Web-User-Interface gibt,der für teambasierte, batchorientierte Publishing-Lösungeneine attraktive Neuerung darstellt, sei hier nur am Rande er-wähnt.

FrameMaker-Publishing-Server mit Web-User-Interface

[ i ]m Fokus: FrameMaker 12 und TCS58

Sonderausgabe FM 12 und TCS5 02/14

Technical Communication Suite TCS5

FrameMaker ist als Einzelprodukt oder als Bestandteil der Tech-nical Communication Suite TCS5 erhältlich. Diese umfasst fol-gende Produkte:• FrameMaker 12 (32 Bit)• Acrobat Pro XI (für professionelle PDF-Ausgaben und PDF-

Bearbeitung) (32 Bit)• Captivate 7 (für Screencasts und grundlegende Videobearbei-

tung) (32 Bit/64 Bit)• RoboHelp 11 (integriertes HTML-basiertes Topic-Editing,

umfassende Word- und FrameMaker-Import-Möglichkeitenmit Verknüpfung zu den Originaldateien) (32 Bit)

• Adobe Presenter 9 (Add-on für PowerPoint zur Erzeugungvon SWF-basierten Präsentationen und Integration vonVideos in PowerPoint) (64 Bit)

• RoboScreen Capture (Tool zum Erzeugen von Screenshots)

Die Bereitstellung von Photoshop in TCS3 und von Illustrator inTCS4 wurde aufgegeben.

FrameMaker 12 – nach dem Update ist vor dem Update

Auch FrameMaker 12 bietet noch Platz für zahlreiche weitereVerbesserungen. Die folgende Liste ist nur ein kleiner Auszugder nach wie vor schmerzlich vermissten Features:• Unterstützung für Rechts-nach-links-Sprachen• Weitergehende automatische Skalierungsoptionen für impor-

tierte Grafiken und zugehörige verankerte Rahmen• Unterstützung weitergehender HTML5-Funktionalitäten wie

z. B. Cue-Points, Integration von HTML5-Animationen, frei-ere Anpassbarkeit des HTML5 Responsive Designs

• Umschaltbare Benutzeroberfläche – zumindest für Englischund die jeweiligen Sprachlokalisierungen. Keine Lokalisie-rung von systeminternen Funktionsbereichen wie TOC/IVZ,EDD usw.

• Direkte PDF-Ausgabe ohne Umweg über PostScript• Bessere SVG-Grafikimportunterstützung, welche die Vorteile

des XML-basierten SVG-Formats auch wirklich ausnutzt• Bessere Grafikfunktionalität (aus Sicht des klassischen Desk-

top-Publishings eine nicht zu unterschätzende funktionaleAnforderung)

• Leichter anpassbare Symbolleisten• Zahlreiche eigentlich längst erforderliche Usability-Verbesse-

rungen, wie z. B. die Möglichkeit des Rücksprungs zum Aus-gangspunkt eines Hyperlinks oder die Navigation mit denPfeiltasten zwischen Tabellenzellen

FrameMaker 12 ist das Update wert

Trotz aller immer noch fehlenden Funktionen und doch noch nö-tigen Funktionserweiterungen präsentiert sich FrameMaker 12als solides, ausgereiftes Publishing-Werkzeug, das State of theArt ist. Die Zahl der Anwender ist groß genug, damit sich Plug-ins und Scriptlösungen (ExtendScript oder FrameScript, z. B. [i]-frame von itl) rentieren. So bleibt schließlich nur zu sagen: Weiterso, Adobe!

Weitere Informationen: Videos, Videos!

Sehr viele Informationen findet man heutzutage als Screencastsund Videos.Englische Videos zu FrameMaker 12 finden Sie unter:• http://tv.adobe.com/product/framemaker/• http://www.youtube.com/adobetcs • https://blogs.adobe.com/techcomm/• http://www.adobe.com/devnet/framemaker.html

Das richtige Update-Seminar zu FrameMaker 12 bekommen Sienatürlich von itl. Weitere Informationen zu unserem Praxissemi-nar „FrameMaker-Training“ finden Sie unter:http://www.itl.eu/akademie/toolschulungen/adobe-framemaker.html

Dieter GustLeitung F&EE-Mail: dieter.gust@itl.eu

Impressum Standorte Nachdruck

Herausgeber:

itl Institut für technische Literatur AG Elsenheimerstraße 6580687 Münchenwww.itl.eu, info@itl.eu

Deutschland:München, Cottbus, Stuttgart

Österreich:Wien, Linz

Schweiz:Kreuzlingen

Nachdruck, auch auszugsweise, nur mit Genehmigung des Herausgebers. Copy-right 2014. Alle Rechte vorbehalten.