Frage:

Unter den Symbolleisten in XMetal finden sich weder die DocBook-Erweiterungen für café solo noch die benutzerdefinierten Menüs. Was ist zu tun?

Antwort:

XMetaL speichert die Benutzereinstellungen für Symbolleisten und Menüs in der Datei docbookx.tbr, wobei mehrere Instanzen dieser Datei in Ihrem Dateisystem vorhanden sein können. Zur Aktualisierung der benutzerdefinierten Einstellungen empfehlen wir Ihnen, dass Sie Ihr lokales Laufwerk nach Instanzen dieser Datei durchsuchen und alle gefundenen Dateien löschen. Wenn Sie XMetaL das nächste Mal starten wird die Datei anhand der gleichlautenden Datei wiederhergestellt, die sich in dem Verzeichnis befindet, das die DocBook DTD enthält (höchstwahrscheinlich unter %CAFESOLO_HOME%\Doctypes\DocBook). Bitte beachten Sie, dass dadurch die Einstellungen aller Benutzer auf dem betrefffenden Rechner zurückgesetzt werden!

Frage:

Wenn ich aus einem italienischen Dokument eine Winhelp-Datei oder HTML Help-Datei produzieren möchte, schlägt die Produktion fehl und die Fehlermeldung „Output character not available in this encoding (decimal 8217)‟ erscheint im Protokoll. Das PDF lässt sich problemlos erzeugen. Was bedeutet das?

Antwort:

Winhelp und HTML Help unterstützen kein Unicode, sondern nur die Standard-Windows-Zeichentabellen. Nachdem es sich um ein italienisches Quelldokument handelt, sollte es nur Zeichen enthalten, die in der für italienische Winhelp-Dateien ausschlaggebenden Zeichentabelle Windows-1252 enthalten sind. Das erwähnte Zeichen ’ wird in der Unicode-Terminologie als RIGHT SINGLE QUOTATION MARK bezeichnet. Anscheinend hat der italienische Übersetzer oder Verfasser des Dokumentes das betreffende Zeichen benutzt (um anzuzeigen, dass ein Vokal ausgelassen wird, z.B. in dem Begriff „dell'inventario‟). Insbesondere beim Kopieren oder Konvertieren von Inhalten aus Office-Produkten können derartige Zeichen in ein Quelldokument gelangen.

Das korrekte Zeichen lautet ' (im Unicode-Jargon APOSTROPHE QUOTE genannt). Wenn Sie nun das falsche Zeichen austauschen, wird sich das Winhelp- oder HTML Help-Produktionsziel ohne Schwierigkeiten erzeugen lassen. Als Faustregel gilt, dass Zeichen mit einem Dezimalcode jenseits ÿ bei westlichen Sprachen nicht kompatibel mit Winhelp oder HTML Help sind.

Eine vollständige Übersicht aller Zeichen finden Sie unter http://www.unicode.org/charts/charindex.html. [CSKB 00001]

Frage:

Wenn ich ein PDF produzieren will, bricht die Produktion mit der Fehlermeldung „[java] [ERROR] file:/Q:/documents/source/en/output/pdf/file.fo:1:405548 The id "d0e1430" already exists in this document [java] Java Result: 2‟ ab. Was ist zu tun?

Antwort:

Das Quelldokument enthält mindestens ein Strukturelement ohne id-Attribut. Die Produktionsumgebung versucht zwar, fehlende IDs während der Produktion zu generieren, jedoch gibt es keinerlei Gewähr, dass dabei in jedem Fall eindeutige IDs generiert werden.

Suchen Sie im Quelldokument nach Elementen vom Typ book, chapter, appendix, section, sect1 ... sect5, die ein leeeres id-Attribut besitzen, und tragen Sie dort eine ID ein. Danach sollte das Problem behoben sein. Falls Sie Beispiele und Handlungsabfolgen in ähnlicher Weise wie Abschnitte behandeln, müssen Sie auch die Elemente example und procedure in die Suche einbeziehen. [CSKB 00002]

Frage:

Wenn ich ein PDF produzieren will, bricht die Produktion mit der Fehlermeldung „[[java] [ERROR] file:/Q:/documents/source/en/output/pdf/document.fo:1:483948 internal-destination or external-destination must be specified in basic-link [java] Java Result: 2‟ ab. Was ist zu tun?

Antwort:

Für einen Fehler der genannten Art gibt es zwei Ursachen: [CSKB 00003]

Frage:

Wenn ich ein PDF produzieren will, läuft die Produktion zwar durch, es kommt jedoch zwischendurch die Fehlermeldung „[java] [ERROR] Error while creating area : Invalid Image URL - error on relative URL : unknown protocol: c‟. Was hat das zu bedeuten?

Antwort:

Bei der Produktion des PDF-Dokumentes wurde versucht eine Grafik zu laden, die unter einem absoluten Pfad auf dem C:\-Laufwerk angegeben ist, die jedoch nicht vorhanden ist oder nicht gefunden werden konnte. Höchstwahrscheinlich wird die Grafik nicht im Quelldokument selbst referenziert, sondern in der Layout-Konfigurationsdatei, die zur Produktion verwendet wird. Um den Fehler zu beheben müssen Sie die jeweilige Konfigurationsdatei mit dem Layout-Konfigurator öffnen und nach der Zeichenkette C: oder c: suchen. Überprüfen Sie bei jedem gefundenen Wert die Verfügbarkeit und tragen Sie gegebenenfalls den korrekten Pfad ein. [CSKB 00004]

Frage:

Ich habe den café solo manager 2.1 installiert, die Installation verlief ohne Probleme. Beim Aufruf des Programmes kommen allerdings die Fehlermeldungen „cafesolo I/O: \StyleSheets\Common\l10n\atlas.xml‟ und „cafesoloManager: Laufzeitfehler '91': Objektvariable oder 'whith'-Blockvariable nicht gesetzt‟, und der café solo manager startet nicht. Wie kann ich das Problem beheben?

Antwort:

Beim Start versucht der café solo manager zunächst, die vorgesehenen Sprachen und Länder zu laden. Dazu wird die Datei atlas.xml eingelesen. Diese Datei kann nur gefunden werden, wenn die Umgebungsvariable CAFESOLO_HOME gesetzt ist und wenn sich die erwähnte Datei im Unterverzeichnis StyleSheets/Common/l10n befindet. Stellen Sie also sicher, dass die Umgebungsvariable korrekt gesetzt ist. [CSKB 00005]

Frage:

Wenn ich mit dem café solo manager 2.1 eine Produktion starten möchte kommt die Fehlermeldung „cafesoloManager: Laufzeitfehler '53': Datei nicht gefunden‟ und die Produktion startet nicht. Wie kann ich das Problem beheben?

Antwort:

Der café solo manager versucht in diesem Fall erfolglos die Produktionsumgebung zu starten. Sie müssen in der Systemsteuerung die Umgebungsvariable Path um den Eintrag %CAFESOLO_HOME%\Batch erweitern. [CSKB 00006]

Frage:

Wie kann ich den Namen einer Datei bei der Ausgabe festlegen?

Antwort:

Die Dateinamen aller Ausgabeziele werden entweder automatisch generiert (aus dem Namen der Quelldatei) oder können über den Projekt-Assistenten vorgegeben werden. Öffnen Sie hierzu den Projekt-Assistenten und wechseln Sie auf das Register Zusammenfassung. Hier können Sie in die Spalte Name klicken und dort den gewünschten Dateinamen eingeben. Die passende Dateinamenergänzung (z.B. „.PDF‟) wird bei der Produktion übrigens automatisch hinzugefügt.

Frage:

Wenn ich ein PDF produziere, kommen im Ausgabefenster und im Protokoll ab und zu Zeilen, in denen „[java] [INFO] [10] (blank)‟ steht (oder so ähnlich). Was hat das zu bedeuten?

Antwort:

Längere Dokumenten werden übersichtlicher, wenn neue Kapitel immer mit einer rechten Seite (ungerade Seitenzahl) beginnen. Aus diesem Grunde müssen verschiedentlich vor einem neuen Kapitel Leerseiten eingefügt werden, die durch Einträge der von Ihnen zitierten Art angezeigt werden. Bei kürzeren Dokumenten sind die Leerseiten vielleicht störend und ein Wechsel zwischen linken und rechten Seiten beim Beginn eines Kapitels ist akzeptabel. Das Verhalten können Sie in der Layout-Konfigurationsdatei über das Attribut force-chapter-break festlegen.

Frage:

Wenn ich ein PDF produziere, kommen im Ausgabefenster und im Protokoll ab und zu Zeilen, in denen „[java] [ERROR] Error while creating area : Error while recovering Image Informations (file:/q:/xsl/common/config/char) : q:\xsl\common\config\char (Das System kann die angegebene Datei nicht finden)‟ steht (oder so ähnlich). Was hat das zu bedeuten?

Antwort:

Bei frisch angelegten oder konvertierten Layout-Dateien sind einige Werte bereits vorbelegt, so auch die Pfade zu diversen Symbolgrafiken. Wenn im Einzelfall eine solche Grafik bei der Produktion verwendet werden soll, obwohl der genaue Pfad nicht angegeben wurde, erscheint eine Fehlermeldung der zitierten Art. Um den Fehler zu beseitigen öffenen Sie am besten den Layout-Konfigurator, durchsuchen dort die komplette Struktur nach der Zeichenkette „char‟ und geben jeweils die gültigen Pfade ein. Danach werden die richtigen Grafiken angezogen und die Fehlermeldung tritt nicht mehr auf.

Frage:

Bei der Produktion einer HTML-Help-Datei wird eine Handlungsanweisung nicht im Sekundärfenster dargestellt, obwohl ich in der Layout-Konfiguration die entsprechende Option gesetzt habe. Warum funktioniert das nicht?

Antwort:

Die Einstellung in der Konfigurationsdatei ist nur eine notwendige, keine hinreichende Voraussetzung, damit eine Handlungsanweisung mit dem Popup-Fenster angezeigt werden kann. Weiterhin muss das betreffende procedure-Element .mit einem id-Attribut versehen sein und ein title-Element besitzen. Erst wenn diese drei Bedingungen erfüllt sind, wird die Handlungsanweisung externalisiert.

Frage:

Bei der PDF-Produktion kommt im Ausgabefenster bzw. im Protokoll die Meldung „[java] [ERROR] file:/S:/documents/source/pl/output/pdf/mde.fo:1:263616 No meaningful layout in block after many attempts. Infinite loop is assumed. Processing halted. [java] Java Result: 2‟ und das PDF-Dokument kann nicht erzeugt werden. Was hat das zu bedeuten?

Antwort:

Bei frisch angelegten oder konvertierten Layout-Dateien sind einige Werte bereits vorbelegt, unter anderem auch Größenangaben für Schriftarten und Ränder. Öffnen Sie also dje betreffende Konfigurationsdatei und suchen Sie (insbesonder unter den Knoten table und literallayout) nach „überdimensionierten‟ Schriften (z.B. 100 pt). [CSKB 00007]