Innovator 11. Design der Dokumentation ändern. Wie Sie die Dokumentation von Innovator Ihrer Corporate Identity anpassen. HowTo.

Transkript

1 Innovator 11 Design der Dokumentation ändern Wie Sie die Dokumentation von Innovator Ihrer Corporate Identity anpassen HowTo

2 Übersicht zum Layout der Dokumentation Das Layout der Innovator-Dokumentationen wird in Innovator classix grundsätzlich im Dokumentationsrepository mit seinen Festlegungen zum Layout und zur Struktur der Dokumentation bestimmt. Eine Auswahl des Dokumentationsrepositorys wird mit den Angaben zum Ausgabeformat und zum Speicherort der Dokumentation in einer Dokumentationsvorlage verbunden. Das Dokumentationsrepository bearbeiten Sie mit dem Dokumentationseditor. In Innovator excellence wird das Layout der Dokumentation (weitgehend analog zum Dokumentationseditor) im Konfigurationseditor als Bestandteil eines Profils festgelegt. Im Modellbrowser werden die zu dokumentierenden Modelldaten selektiert, in Informationsdateien abgelegt und dann offline mit dem Dokumentationsgenerator ausgegeben. Zusätzlich zu den genannten Programmen beeinflussen weitere Angaben das Layout der Dokumentation, so z. B. Festlegungen im Voranzeigefenster, in den Stylesheet-Dateien für die XML/HTML- Ausgabe und in der Word-Vorlagedatei. Sie können für die Ausgabeformate HTML und Word für Windows sowie im Voranzeigefenster im Wesentlichen für die Bereiche Titelseite, Haupttext und Inhaltsverzeichnis Festlegungen zum Layout treffen. Diese betreffen vor allem die Logo-Grafik, das Zeichenformat und die Textausrichtung. Für das HTML-Format können Sie zudem die Hintergrundfarbe bestimmen. Die Tabelle zeigt wo, was, wie und wann Sie ändern können, um das Layout der Dokumentationen Ihren Bedürfnissen anzupassen. Wo Was Wie Wann Hintergrundfarbe festlegen Logo einbinden und Größe anpassen XSL-Stylesheets Vorlagendokument (I4BA 1 ) Dokumentationseditor (classix) bzw. Konfigurationseditor (excellence) Alle Hintergründe der HTML-Dokumentation Alle Hintergründe der Word Dokumentation Import und Größe der Grafiken anpassen (Word-Dokumentation) Stylesheets Absatzformats Punktkommandos.import (Wertepaare für Größenverhältnis, siehe Handbuch classix Dokumentation C-8.1.8) beim Erstellen des Dokumentationsrepositorys bzw. des Profils Titelseite bzw. Kopfund Fußzeilen des Vorlagendokuments (I4BA) Grafik (Word Dokumentation) Grafik einfügen und skalieren XSL-Stylesheets Import und Größe der Grafiken anpassen (im Header der HTML- Dokumentation) Stylesheets 1 Innovator for Business Analysts 2

3 Schriftarten bestimmen Dokumentationseditor bzw. Konfigurationseditor Proportionale / nichtproportionale Schriftart, Zeilenumbruch Punktkommandos.U.S beim Erstellen des Dokumentationsrepositorys bzw. des Profils Vorlagendokument (I4BA) inofont.ini Absatzformatierung Absatzformats Textausrichtung beeinflussen Dokumentationseditor bzw. Konfigurationseditor Text, Grafiken für alle Dokumentationen Punktkommandos Links, Zentriert oder Rechts Absatzausrichtung beim Erstellen des Dokumentationsrepositorys bzw. des Profils Über die XSL-Stylesheets und die Datei docu.css haben Sie weitreichende Kontrolle über das Layout der XML/HTML-Dokumentation. In diesem Dokument werden nur die Einstellungen zu Hintergrundfarbe, Logo-Grafik und Schriftarten dargestellt. Nähere Informationen dazu finden Sie im Handbuch classix in den Kapiteln C-5.2, "Eingabedaten und Ausgabeeinstellungen bestimmen" und C , "Dokumentation im Format XML ausgeben". Innovator for Business Analysts verwendet als XSL-Stylesheet standardmäßig die Datei xalandocu.html, die anderen Editionen verwenden die Datei htmldocu.xsl. Nähere Informationen zu weiteren Layoutbestandteilen (Seiteneinstellungen, Indexeinträge usw.) finden Sie im Handbuch classix, Kapitel C-7, "Layout der Dokumentation beeinflussen". Layout der Dokumentation Ihrer Corporate Identity anpassen Für die Titelseite, den Haupttext bzw. das Inhaltsverzeichnis können Sie Layoutvorgaben für die Logo-Grafik, das Zeichenformat und die Textausrichtung machen. Zusätzlich können Sie für die XML/HTML-Ausgabe die Hintergrundfarbe der Dokumentation bestimmen. Die XSL-Dateien befinden sich jeweils im Verzeichnis $INODIR. HTML Hintergrundfarbe In der Datei docu.css stellen Sie die Hintergrundfarbe ein body { background-color #FFFFFF; } Logo einbinden und Größe anpassen Die Logo-Grafik für den Kopfbereich (Header) befindet sich als Datei logo.gif im Verzeichnis $INODIR. Speichern Sie Ihre eigene Logo-Datei unter diesem Namen in diesem Verzeichnis ab. 3

4 Die Größe der Logo-Grafik können Sie im XSL-Stylesheet festlegen. Nutzen Sie dazu die Attribute width und height. Beachten Sie das korrekte Seitenverhältnis, um Verzerrungen zu vermeiden. Um die definierte Höhe des Kopfrahmens nicht zu übersteigen, darf die Höhe der Logo-Grafik 80 Pixel nicht übersteigen. <xsltemplate match="docu[toc]"> <xtdocument method="html" href="{$bannerfile}"> <p align="right"> <img src="file{$logo}" width="" height="" alt="logo" /> </p> </xtdocument> </xsltemplate> Zeichenformat anpassen Für die Titelseite können Sie das Zeichenformat in der Datei docu.css festlegen.titlecenter { font-size 38pt; font-family Frutiger,Helvetica,Arial; font-weight italic; color #cc0033; text-decoration none; } Für den Haupttext und das Inhaltsverzeichnis können keine expliziten Formate vorgegeben werden. Ausrichtung beeinflussen Für die Titelseite bestimmen Sie in Innovator classix die Textausrichtung im Dokumentationseditor in der Dialogbox Bearbeiten/Eigenschaften mit Aktivierung eines der drei Alternativfelder Links, Zentriert oder Rechts. Analog legen Sie in Innovator excellence die Textausrichtung im Konfigurationseditor in der Ansicht Dokumentation für die Titelseite in der Dialogbox Bearbeiten/ Eigenschaften als Merkmal Ausrichtung fest. Für den Haupttext nehmen Sie die Einstellungen im Dokumentationseditor für die einzelnen Blätter des Strukturbaums in der Dialogbox Bearbeiten/Eigenschaften, Register Absatzformat, Gruppe Absatzausrichtung vor. Analog legen Sie in Innovator excellence die Textausrichtung im Konfigurationseditor in der Ansicht Dokumentationsstrukturen für die einzelnen Blätter des Strukturbaums in der Dialogbox Bearbeiten/Eigenschaften als Absatzformat Absatzausrichtung fest. Nähere Informationen zur Absatzausrichtung finden Sie im Handbuch classix im Kapitel C , "Mitgelieferte Standardstruktur kennen lernen". 4

5 Word 2 für Windows Logo einbinden und Größe anpassen Für die Titelseite binden Sie eine Logo-Grafik im Dokumentationseditor mit dem Punktkommando.import <Dateiname> <Breite1> <Höhe1> [<Breite2> <Höhe2>] ein. Beispiel.import logo_mid.bmp 6 cm 2,38 cm 15,7 cm 6,1 cm Unterstützt werden die in der Datei inounits.ini eingetragenen Maßeinheiten. Falls der angegebene Dateiname keinen Pfad enthält, wird die Datei außer auf dem aktuellen Arbeitsverzeichnis auch in den Verzeichnissen gesucht, die mit dem Eintrag Suchpfad im Abschnitt Einstellungen der Datei inodocu1.ini angegeben sind. Die Änderung der Bildgröße sowie ggf. des Seitenverhältnisses der Grafik erfolgt durch Angabe von Wertepaaren. Für die Kopf- bzw. Fußzeile des Haupttextes binden Sie Logo-Grafiken auf analoge Weise ein. Zeichenformat anpassen Die Zeichenformate der Titelseite, des Haupttextes, der Kopf- und Fußzeile sowie des Inhaltsverzeichnisses können Sie in der Datei inodocu.dot anpassen. Ausrichtung beeinflussen Für die Titelseite bestimmen Sie die Textausrichtung im Dokumentationseditor in der Dialogbox Bearbeiten/Eigenschaften mit Aktivierung eines der drei Alternativfelder Links, Zentriert oder Rechts. Analog legen Sie in Innovator excellence die Textausrichtung im Konfigurationseditor in der Ansicht Dokumentation für die Titelseite in der Dialogbox Bearbeiten/Eigenschaften als Merkmal Ausrichtung fest. Für den Haupttext nehmen Sie die Einstellungen im Dokumentationseditor für die einzelnen Blätter des Strukturbaums in der Dialogbox Bearbeiten/Eigenschaften, Register Absatzformat, Gruppe Absatzausrichtung vor. Analog legen Sie in Innovator excellence die Textausrichtung im Konfigurationseditor in der Ansicht Dokumentationsstrukturen für die einzelnen Blätter des Strukturbaums in der Dialogbox Bearbeiten/Eigenschaften als Absatzformat Absatzausrichtung fest. Nähere Informationen zur Absatzausrichtung finden Sie im Handbuch classix im Kapitel C , "Mitgelieferte Standardstruktur kennen lernen". Für die Kopf- und Fußzeile sowie das Inhaltsverzeichnis passen Sie die Textausrichtung in der Datei inodocu.dot an. 5

6 Word 2007 In Innovator for Business Analysts gibt es für das Ausgabeformat Word 2007 die Möglichkeit, dem Dokumentationskommando im Konfigurationseditor ein Vorlagendokument zuzuordnen. Dabei handelt es sich um ein Word 2007-Dokument, das beliebigen Inhalt haben darf, an den die erzeugte Dokumentation angehängt wird. Somit lassen sich ebenso leicht Titelseiten gestalten wie Absatzformate vorgeben. Titelseiten gestalten Die Titelseite darf drei besondere Benutzersteuerelemente beinhalten, die beliebig auf der Seite verteilt werden dürfen. Diese müssen die folgenden Bezeichnungen tragen TitleTop TitleCenter TitleBottom Diese werden durch die Texte substituiert, die innerhalb der Titelseite des Dokumentationskommandos angegeben werden. Besonderheit ist, dass durch die Benutzersteuerelemente zum einen die freie Positionierbarkeit gegeben ist, zum anderen der Inhalt der Benutzersteuerelemente beliebig formatiert werden kann. Diese Formatierung bleibt erhalten, wenn die Benutzersteuerelemente durch den tatsächlichen Text ersetzt werden. Als Beispiel kann die ausgelieferte Vorlagendatei im INODIR-Verzeichnis dienen. Absatzformate anpassen Im Vorlagendokument dürfen neben dem Standardabsatzformat Absatzformate für nummerierte und nicht nummerierte Überschriften hinterlegt werden, die bis zu neun Überschriftsebenen abdecken dürfen. Außerdem ist es möglich, Formate für arabisch und römisch nummerierte Listen sowie Spiegelstrichlisten zu hinterlegen. Copyright 2010 MID GmbH Bei Fragen wenden Sie sich bitte an unsere Hotline. Telefon +49 (0) , Dieses Dokument finden Sie neben anderen auch im exklusiven Login-Download-Bereich für Innovator-Wartungskunden unter http// Ihre MID MID GmbH, Kressengartenstraße 10, Nürnberg Telefon +49 (0) , Fax +49 (0) , Internet http// Innovator 11.2 HowTo Doku Design doc 6