Archiv der Kategorie: FrameMaker
FrameMaker 9.0.4
Im Gegensatz zum vorherigen Patch-Release 9.0.3 (auch als 9.0p250 bekannt) sind die in den Release Notes erwähnten vier Punkte wohl hinreichend für den Schritt von Build 250 auf 255 (9.0p255), dürften aber nur Automatisierer betreffen, insbesondere rund um die DITA-Spezialisierung, betreffen. Bei den Einträgen, die mit FANote beginnen, handelt es sich um Ereignisse, die FrameMaker intern verwendet, die man aber auch per Programmierung (FDK oder FrameScript) abfangen kann. Im Fall 2. gab es Programmierer, die vor dem Schließen eines Buchs (PreQuitBook) gerne noch Dokumente oder Bücher gespeichert hätten, die aber mit dem Befehl F_ApiSimpleSave nicht machen konnten. Und so weiter.
Auch wenn die Änderungen nicht spektakulär zu sein scheinen, zeigen sie doch, dass Adobe Add-on-Programmierer ernst nimmt, nicht zuletzt entsteht so in der Regel ein flüssiger Prozess.
Sie erhalten das Update entweder über die interne Update-Funktion oder auf der Download-Seite.
- Earlier FrameMaker used to crash if FA_Note_QuitModelessDialog notification was registered, and user tried to close Cross Reference dialog, Marker dialog or Variable pod. This has been fixed now.
- F_ApiSimpleSave() now works fine in the FA_Note_PreQuitBook Notification.
- Now FrameMaker should close normally when FA_Note_DisplayClientXRefDialog notification is registered.
- FrameMaker now works fine while executing “Go To Source” command on XRef when
FA_Note_PreGoToXrefSrc notification is registered.
Alle Updater
Je nachdem, welche FrameMaker-Version Sie haben (Menü Hilfe > Über FrameMaker), müssen Sie gegebenenfalls mehrere Updater nacheinander ausführen, um auf 9.0.4 zu kommen:
-
9.0.0 (p196) ► 9.0.1 (p230) (17.3.2009, 30,5 MByte)
-
9.0.1 (p230) ► 9.0.2 (p237) (5.5.2009, 21,6 MByte)
-
9.0.2 (p237) ► 9.0.3 (p250) (17.9.2009, 31,3 MByte)
-
9.0.3 (p250) ► 9.0.4 (p255) (30.6.2010, 19,4 MByte)
PS: Auf der Webseite ist von 9.0.4 (p252) die Rede, dies ist anscheinend ein Tippfehler.
Veröffentlicht unter FrameMaker
Kommentare deaktiviert für FrameMaker 9.0.4
Dokumentvergleich – Änderungsanzeige
Diff, Change Tracking, Änderungsverfolgung… you name it…
Es gibt mehrere Gründe warum jemand gerne sehen möchte, wo in einem Dokument welche Änderungen gemacht wurden:
- Der Leser möchte bei einem Update die Stellen mit Änderungen gegenüber seiner letzten Version des Dokuments sofort erkennen
- Der Korrektur-Leser möchte die Stellen mit Änderungen seit dem letzten Korrekturlauf erkennen
- In den Übersetzungsprozess sollen nur Abschnitte mit Änderungen geleitet werden
Den letzten Fall möchte ich hier einmal ausklammern, auch wenn dessen wirtschaftliche Relevanz nicht unterschätzt werden darf. Aber hierfür sind eine Vielzahl weiterer Prozessfragen zu klären.
Die ersten beiden Punkte bieten Raum genug. Zum Beispiel, wenn wir Versionssprünge für bestimmte Sprachen oder Produktvarianten unterstellen. Wenn also nicht in allen Sprachen oder Produktvarianten die gleichen Änderungen angezeigt werden sollen (Äa = Änderungsanzeige):
| Version | häufige Sprachen | seltene Sprachen |
|---|---|---|
| 2.0 | PDF mit Äa zu 1.0 | PDF mit Äa zu 1.0 |
| 2.1 | PDF mit Äa zu 2.0 | — |
| 2.2 | PDF mit Äa zu 2.1 | — |
| 3.0 | PDF mit Äa zu 2.2 | PDF mit Äa zu 2.0 |
Wenn Sie dies noch kombinieren mit gesonderter Änderungsanzeige für verschiedene Korrekturleser… dann ist es kein Wunder, dass dies heute nicht oder nur selten stattfindet. Und wenn, dann mit recht hohem Zeitaufwand.
Aber es geht! Mit FrameMaker!
In einem aktuellen Projekt habe ich folgendes umgesetzt:
- zwei beliebige XML-Fassungen eines Handbuchs werden mit Hilfe eines XML-Tools verglichen
- das XML-Ergebnis mit Änderungsmarkierungen wird für FrameMaker aufbereitet
- es entsteht ein FrameMaker-Buch mit FrameMaker-Änderungsmarkierungen, die auf Wunsch noch nachbearbeitet werden können
Im Detail:
Es gibt viele Werkzeuge, mit denen Textdateien oder sogar XML-Dateien vergleichen werden können. Aber erst 2009 fand auch eines, dass Änderungsmarkierungen auch in einem XML-Dokument speichern kann. Dies erfolgt mit Hilfe von Processing Instructions, so dass die XML-Datei nicht durch neue Elemente oder Attribute von vornherein ungültig wird. Dem Werkzeug fehlten noch einige Funktionen, die wir für den Vergleich von Dokumenten benötigen, zum Beispiel den Vergleich auf Textebene. Mittlerweile gibt es eine Version 2.0 von XML Tree Compare zum Testen auf http://www.xmldifftool.com/.
Eine Aufbereitung des Outputs von XTC ist nötig, da FrameMaker Änderungsmarkierungen auf ganz bestimmte Art und Weise erwartet. Zudem bietet die Aufbereitung auch die Möglichkeit, bestimmte technisch motivierte Änderungen zu ignorieren. Da es sich um eine XML-Datei handelt, erfolgt diese Anpassung per XSLT.
Integriert wird das Ganze mit einem Skript, so dass der Vorgang für den Anwender problemlos ist. FrameMakers Einschränkungen im Zusammenhang mit der Änderungsverfolgung werden dabei weitgehend behoben.
Und das Dokument mit Änderungsanzeige kann anschließend mit der Symbolleiste Textänderungen nachverfolgen nach Änderungen durchsucht werden. Wenn gewünscht können auf diese Weise banale Änderungen noch akzeptiert werden. Abgebildet sind hier das alte, das neue und das Dokument mit Änderungsanzeige.
(Für große Darstellung bitte anklicken und mit Pfeiltasten zwischen den Bildern wechseln)
Wenden Sie sich an mich, wenn Sie dies auch für Ihre FrameMaker-Publikationen einsetzen wollen!
Veröffentlicht unter FrameMaker, XML/XSL
Ein Kommentar
PDF-Schaltflächen erzeugen
Wie einige von Ihnen vielleicht wissen, kann man in FrameMaker in sogenannten PostScript-Textrahmen Anweisungen hinterlegen, die bei der PDF-Erstellung ausgewertet werden. Auf diese Weise lassen sich etliche Zusatzfunktionen unterbringen und der Nachbereitungsaufwand im PDF bestenfalls auf Null senken. Das Stichwort dazu lautet pdfmark und eine Referenz dazu findet sich in Thomas Merz’ Buch Das pdfmark-Einmaleins, ein Auszug aus seinem Standardwerk Die PostScript- & PDF-Bibel. Beide Werke finden Sie hier:
Mein Thema sind Schaltflächen, mit denen zum Beispiel der Druck bestimmter Seiten einer Anleitung für den Anwender komfortabel gestaltet werden kann. Das sieht dann gewöhnlich so aus, wie rechts im folgenden Bild:
Wenn aber mehr gewünscht wird, wie zum Beispiel eine grafische Gestaltung des Hintergrunds oder der ganzen Schaltfläche (wie links), dann muss man etwas tiefer einsteigen. Natürlich nur, wenn diese Schaltfläche im PDF nicht gedruckt werden soll, denn sonst könnte man das Erscheinungsbild schon in FrameMaker hinzufügen und eine unsichtbare Schaltfläche darüber legen. Weiterlesen
Veröffentlicht unter FrameMaker
Verschlagwortet mit PDF, pdfmark
Kommentare deaktiviert für PDF-Schaltflächen erzeugen
Dokumente durch die Übersetzung ‚retten‘
Die größte Sorge im Dokumentationsbereich scheint in vielen Firmen die Übersetzung zu sein (weil externe Kosten). Dass eventuell auch bei internen Prozessen effizienter gearbeitet werden könnte… steht auf einem anderen Blatt.
Zum genannten Thema gibt es am Freitag 16.4.2010 ein kostenloses E-Seminar mit Stefan Gentz, einem ausgewiesenem Spezialist für Übersetzungs-Technologie. Aus dem Ankündigungstext:
[…] erfahren Sie, wie Sie als Technischer Autor oder Grafiker/Designer Dokumente so vorbereiten können, dass sich Ihre FrameMaker- oder InDesign-Dokumente optimal durch moderne Übersetzungsprozess führen lassen. Stefan Gentz verrät Ihnen zehn einfache aber höchst effektive Tipps & Tricks, mit denen Sie sich viel Geld, Zeit und Ärger sparen können. Ihr Übersetzungsdienstleister wird Sie dafür lieben.
Bitte hier anmelden: http://www.adobe-eseminars.de/signup-477.htm
Veröffentlicht unter FrameMaker, InDesign, Tools
Ein Kommentar
Migration zu XML-strukturierten Dokumenten
Der prinzipielle Ablauf der Migration Format-basierter zu XML-strukturierten FrameMaker-Dokumenten ist dieser:
- Entwurf und Optimierung einer Konvertiertabelle: Hier wird für jedes FrameMaker-Objekt ein entsprechendes Element festgelegt
- Anwenden dieser Konvertiertabelle: Wenn Sie bei 1. gründlich waren, entstehen Dokumente mit einem definierten Highest Level Element
- Laden der gewünschten Elementdefinitionen
- Reparieren aller noch vorhandenen Fehler
Letzteres wird zum Beispiel nötig, wenn Abbildungen und Warnmeldungen bislang mit Tabellen aufgebaut waren, dies aber im strukturierten Template nicht mehr der Fall ist. Da können sehr viele Aktionen anstehen.
Bislang habe ich in solchen Fällen Skripte geschrieben, jetzt aber mache ich das mit dem Plug-in FrameSLT und dessen Funktion Node Wizard Scripts. Es handelt sich hier um XPath-basierte Element- und Attributaktionen, die nahezu jegliche Modifikation der Dokumentstrukturen erlauben. In einem aktuellen Projekt (ca. 1.200 Seiten, 32 Kapitel) waren es einmal über 20.000 Aktionen:
Bei solchen Volumina ist ein C-Plugin auch signifikant schneller als ein Skript es wäre! Aber das allerschönste ist die Notation der Aufgabenstellung mit XPath-Ausdrücken, die damit eine wunderbare Präzision bekommen.
Veröffentlicht unter FrameMaker, XML/XSL
Kommentare deaktiviert für Migration zu XML-strukturierten Dokumenten
Zweimal geschütztes Leerzeichen
Als alter Hase war mir (und anderen) eine Besonderheit von FrameMaker schon lange in Fleisch und Blut übergegangen: Sobald ein Wort in Kontakt mit einem Sonderzeichen, insbesondere dem geschützten Leerzeichen (Strg+Lz) kam, wurde es für die automatische Silbentrennung nicht mehr berücksichtigt.
Am Rande bemerkt: Über die Qualität jeglicher Silbentrennungsalgorithmen kann man durchaus verschiedener Meinung sein…
Im Rahmen der Tests der Unicode-fähigen Version 8 war mir aufgefallen, dass sich das geschützte Leerzeichen auf zwei Arten erstellen lässt: Weiterlesen
Veröffentlicht unter FrameMaker
4 Kommentare
Wörterbücher
Ein Überblick über die diversen FrameMaker-Wörterbücher findet sich im aktuellen Blog-Beitrag aus Indien:
Es wird erklärt, wo sich die relevanten Dateien befinden und wie man Voreinstellungen in der maker.ini anpassen kann. Ob sich damit die Probleme mancher Anwender lösen lassen?
Mein Hinweis: In meinen Augen ist das Dokumentwörterbuch — genauso wie dokumentbezogene Ausnahmen von der Strukturprüfung — eher eine Quelle unerwünschter Inkonsistenzen und ich würde es vermeiden. In so mancher MIF-Datei habe ich schon eigenartige Schreibweisen gefunden, und wer denkt schon daran, die auch zu löschen…?
Veröffentlicht unter FrameMaker
Kommentare deaktiviert für Wörterbücher
Top 10 FrameMaker-Tipps
Blogs, Twitter, Facebook, Xing, Linked-in, Foren, … wenn ich alles lesen wollte, was es zu meinen Themen zu lesen gibt, ich wäre extrem unproduktiv. Also sind es einige ausgewählte Quellen, und auch dort oft nur die Überschriften. [Eine gute Gelegenheit darauf hinzuweisen, dass der Betreff einer Nachricht oft darüber entscheidet, ob sie gelesen wird bzw. von wem sie gelesen wird.] Seit Oktober »blogt« auch Samartha Vashishtha, der als Technical Writer bei Adobe Systems in Indien arbeitet. Und von ihm bzw. unter seiner Mitwirkung entstanden die »Top Ten FrameMaker Tips«. Das PDF gibt es zum Download in Samarthas Blog-Beitrag, eine deutsche Übertragung folgt hier:
Textänderungen protokollieren
Die zugehörigen Funktionen finden Sie unter Spezial > Textänderungen nachverfolgen bzw. Darstellung > Symbolleisten > Textänderungen nachverfolgen. Diese Funktion war neu in FrameMaker 8 und dazu gibt es auch eine kleine Demo mit einem sehr sonoren Sprecher [en].
Screenshots erstellen
Mit FrameMaker 9 (aus der Technical Communication Suite) haben Sie auch Zugriff auf RoboScreenCapture, um auf die Schnelle Screenshots zu erstellen, mit Anmerkungen zu versehen oder anders zu bearbeiten. Wählen Sie dazu Datei > RoboScreenCapture starten.
Anzeigen von Änderungen durch Versionsvergleich
Nutzen Sie FrameMakers Versionsvergleich, um die Änderungen zwischen Dokumentversionen sichtbar zu machen. Details finden Sie in diesem Artikel in der Onlinehilfe.
- Öffnen Sie beide Versionen eines Dokuments (oder Buchs).
- In der neueren Version wählen Sie Datei > Dienstprogramme > Dokumente vergleichen.
Bedingte Texte anzeigen und verwalten
Mit dem neuen Pod »Bedingter Text« lassen sich Textbedingungen und bedingte Texte auf neue Art und Weise verwalten. Allgemeine Tipps dazu finden Sie auch in der Onlinehilfe.
Änderungsbalken explizit hinzufügen
Manchmal ist es besser, wenn Änderungsbalken nicht automatisch sondern manuell gesetzt (oder auch entfernt) werden. Statt also die automatische Anzeige von Änderungsbalken zu aktivieren verwenden Sie hierfür eines der vielen, vielen Tastaturkürzel: Strg+Shift+H. Mit diesem Kürzel setzen oder entfernen Sie Änderungsbalken für den ausgewählten Text.
PDF-Korrekturläufe aus FrameMaker starten
Mit Hilfe des Befehls Datei > Als PDF speichern (zur Überprüfung senden) können Sie ein PDF erstellen, das direkt in Acrobat mit dem Assistent zur E-Mail-Überprüfung geöffnet wird.
PDF-Kommentare importieren
[Wenn es zu Ihrem Workflow passt.] Sie können Kommentare aus einer PDF-Datei, die Sie mit Datei > Als PDF speichern (zur Überprüfung senden) erstellt haben, in ihr unverändertes Ausgangsdokument importieren. Die Kommentare erscheinen dann, als wenn Sie mit der Textänderungsverfolgung gearbeitet hätten und Sie können jeden einzelnen akzeptieren oder verwerfen. Weitere Erläuterung zu der über Datei > Importieren > PDF-Kommentare verfügbaren Funktion finden Sie auch in der Onlinehilfe.
Gestalten Sie Ihren Arbeitsbereich
Entweder wählen Sie einen der vordefinierten Arbeitsbereiche aus dem Menü am rechten Ende der Titelleiste, oder Sie definieren sich selbst die am besten passenden Anordnung von Fesntern und Pods. Mehr Details finden Sie in der Onlinehilfe, dort auch den Link zu einer Einführung durch R.J. Jácquez [en].
Änderungsbalken vorübergehend unsichtbar machen
Wenn Sie Änderungsbalken beibehalten wollen, aber ein PDF ohne diese Balken benötigen, können Sie die Farbe unter Format > Dokument > Änderungsbalken einfach vorübergehend auf weiß (bzw. die Farbe Ihres Seitenhintergrunds) setzen.
PDF-Einstellungen optimieren
In den Dialogen Format > Dokument > PDF-Einstellungen und Datei > Voreinstellungen > Allgemein können Sie die geeigneten Einstellungen wählen, um z.B. Tagged PDF zu aktivieren, eine der Voraussetzungen für das Importieren von PDF-Kommentaren. Die Details stehen in der Onlinehilfe.
Veröffentlicht unter FrameMaker
3 Kommentare
FrameMaker Server 9
In einem Blog-Beitrag hat Mahesh Kumar Gupta von Adobe India auf die Bedeutung von FrameMaker Server 9 hingewiesen. Meine Anmerkungen zur Version 8, die ich seinerzeit mit Adobe Deutschland abgestimmt hatte, sind anscheinend immer noch gültig. Hier die Links:
- FrameMaker Server – was ist das? (Mai 2008)
- Adobe Technical Communication Blog
- Produktseite bei Adobe Deutschland, die leider nur auf die englische Seite verweist. Dort am interessantesten sind die FAQ:
- FrameMaker Server FAQ
Veröffentlicht unter FrameMaker
Ein Kommentar
Wie ist das umgesetzt?
In einem Projekt wünschte sich der Kunde eine graphische Umsetzung für XML-Strukturen und ich bin ganz unbescheiden der Ansicht, dass meine Umsetzung dieses Wunsches für FrameMaker recht gut gelungen ist, zumal der Autor nur die sichtbaren Textzeichen eingeben muss. Können Sie auf den ersten Blick erkennen, wie das umgesetzt ist? Bis zur tekom-Tagung werde ich Woche für Woche mehr Details preisgeben:
- Screenshot FrameMaker (ohne Steuerzeichen)
- PDF-Datei dieser Seite
- Screenshot FrameMaker (mit Steuerzeichen)
- Verlosung und Lösung siehe Kommentar 17
Auf der Tagung an meinem Stand 415 können Sie sich die Datei dann selbst ansehen. Alle Lösungsansätze in Kommentaren zu diesem Beitrag nehmen an einer Verlosung teil! Sollte jemand die Umsetzung richtig (oder nahezu richtig) beschreiben, gibt es einen Sonderpreis! Nicht teilnehmen dürfen Personen, die mit der Umsetzung des Projekts befasst waren.
Screenshot FrameMaker (ohne Steuerzeichen)
Diese Visualisierung ist ausschließlich mit FrameMaker-Bordmitteln erstellt und benötigt weder Plug-ins noch Skripte. (Klicken Sie die Grafik für eine 1:1-Darstellung, Esc schließt das Bild wieder.)
PDF-Datei
Hier finden Sie die PDF-Datei für die Visualisierung der XML-Strukturen. Hier können Sie erkennen, was Grafik und was Text ist. Vielleicht noch der Hinweis, dass die Lösung mit allen bei mir installierten FrameMaker-Versionen (7.1, 7.2, 8, 9) möglich ist eine Unicode-fähige FrameMaker-Version (8.0 oder 9.0) voraussetzt.
Screenshot FrameMaker (mit Steuerzeichen)
(Klicken Sie die Grafik für eine 1:1-Darstellung, Esc schließt das Bild wieder.)
Zu gewinnen gibt es
Dank der Großzügigkeit von Adobe Deutschland kann ich folgende Gewinne ausloben:
1 × Photoshop Elements 8 (Win)
5 × Notebook-Mappe (für 15″-Modelle, ohne Notebook!)
Die rote Einstecktasche auf der Notebook-Mappe ist aus leicht schimmerndem Material und wirkt wesentlich roter als auf dem angeblitzten Foto.
Die Chancen stehen also nicht schlecht!