Konfiguration von MZ3-Tool3 MegaZine3 MZ3-Tool3 Training: MZ3-Tool3 Parameter konfigurieren Video 1-5
Paramter-Konzept MZ3-Tool3 enthält alle Funktionen, um unterschiedliche MZ3-Titel zu erstellen. Wie MZ3-Tool3 funktionieren soll, wird über Parameter festgelegt. Dies erlaubt eine hohe Flexibilität. Die Parametrierung ist in aufgeteilt in zwei Dateien : make Datei Generelle Parameter für den Ablauf details Datei Parameter, die den Aufbau der MZ3-Titel festlegen Diese beiden Dateien können für spezielle Aufgabenstellungen angepasst und entsprechend benannt werden. Damit können Parametersätze für unterschiedliche Einsatzzwecke erstellt werden. Zwei solcher Konfigurations-Sätze befinden sich im _examples\ Ordner: mz3_pdf_make.xml und mz3_pdf_details.xml (zur PDF Konvertierung vieler PDFs) mz3_photo_make.xml und mz3_photo_details.xml (zur Erstellung von Fotobüchern) Die Unterschiede und Details der beiden Konfigurationssätze wird später erläutert. MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 2
XML Grundlagen Sowohl die make als auch die details Konfigurationsdateien sind XML Dateien, d.h. der Inhalt entspricht den XML Konventionen: <element name>element inhalt</element name> Die Anfangs- und Ende- Tags ( Marker ) eines XML Elements enthalten den Element- Namen und den Element-Inhalt, und sind in spitze Klammern <> eingeschlossen. Das Ende-Tag enthält einen Schrägstrich / vor dem Elementnamen. Der Inhalt des Elements befindet sich zwischen dem Anfangs- und Ende-Tag. XML Elemente können Attribut-Werte Paare enthalten. MZ3-Tool3 nutzt keine Attribute, aber die Konfigurationsdatei für MegaZine3, die von MZ3-Tool3 erstellt wird, enthalten auch Attribute. Elemente können verschachtelt sein, d.h. ein Element kann weitere Elemente enthalten. Es muss immer ein erstes, umschließendes Element geben, Dieses wird Root- Element genannt und enthält alle anderen Elemente der XML Datei. MZ3-Tool3 Parameter sind Elemente der make bzw. details Konfigurationsdatei. MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 3
Aufbau der make Datei Das Root Element der make Datei heißt <mz3_tool3> Die prinzipielle Struktur einer make Datei sieht wie folgt aus: <mz3_tool3> <parameter name>parameter</parameter name>...... </mz3_tool3> Beispiele für Parameternamen (als XML Elemente) sind: <UI_language> <mz3_variant> <PDF_XML_path> Kommentare sind auch möglich. Ein Kommentar beginnt mit der Zeichenfolge <!-- und endet mit --> MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 4
Editieren der Konfigurationsdateien Das XML Format ist sehr weit verbreitet und wird gut unterstützt. Es gibt einige Editoren, welche die XML Struktur und Syntax unterstützen und Elemente, Inhalte und Kommentare farblich getrennt hervorheben können. Damit kann ein XML Element z.b. so dargestellt werden: <PDF_XML_path>my_PDFs</PDF_XML_path> <!-- Path to the '*.pdf files --> Oder mit einer anderen Einstellung für den Stil (XML Editoren können idr auf unterschiedliche Stile eingestellt werden): Notepad++ und Sublime Text2 sind zwei Beispiele von (kostenlosen) XML Editoren. Parameter können leicht angepasst werden: Der Parameter muss gefunden werden; dann kann der Inhalt entsprechend angepasst werden.. MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 5
Beispiele zur Parameteranpassung Im Beispiel werden die Parameter so angepasst, dass MZ3_tool3 eine Online-Version eines MZ3-Titels erzeugt: <UI_language>en</ui_language> <mz3_variant>online</mz3_variant> Der erste Parameter definiert die Ausgabesprache für Meldungen durch MZ3-Tool3. Möglich sind en für Englisch und de für Deutsch. Sobald die Sprache definiert ist, wird sie nicht mehr nach jedem Start abgefragt. Der zweite Parameter bestimmt, dass der nächste MZ3-Titel als Online Version, welche auf einen Server geladen und über das Internet abgerufen werden kann, erstellt wird. Die Nutzung jedes Parameters wird übrigens über einen Kommentar erklärt. MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 6
Zusammenfassung Die allgemeine Struktur eines XML Elements ist: <element>wert/inhalt</element> MZ3-Tool3 Parameter sind solche Elemente der make und details Konfigurationsdatei Unterschiedliche Parametersätze der make und details Konfigurationsdateien können als Konfigurationssatz mit eigenem Namen gespeichert werden. Beispiel eines solchen Namens: mz3_default oder mz3_pdf Das Verhalten von MZ3-Tool3 ist vollständig über Parameter steuerbar Für das Ändern der Parameter empfiehlt es sich, spezielle XML Editoren wie notepad++ oder Sublime Text2 einzusetzen. XML Dateien sind Textdateien, sodass auch jeder beliebige Texteditor genutzt werden kann; allerdings ohne den Komfort, den XML Editoren bieten. MegaZine3 / MZ3-Tool3 Training: XML Konfigurationsdateien Video 1-5 7