Dokumentation/HowTo/Impress/Template sprachunabhängig machen

TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Spende

• Start
• Entwicklung
• Gestaltung
• QA
• Events
• Dokumentation
• Webseite
• Lokalisierung
• Barrierefreiheit
• Marketing
• Diversität
• Wiki Hilfe
• Die Stiftung

• Dokumentation Start
• Handbücher
• Andere Quellen
• FAQ
• HowTo
• Makros
• Doku Entwicklung

Sprachunabhängigkeit der Templates

Beschreibung des Problems

Ein Template speichert oft viele Informationen in der zugehörigen Datei. Wenn das Template in einer internationalen Umgebung angeboten werden soll (z. Bsp. auf der Template Seite), sollten alle lokalisierten Informationen (Sprache, Währung, Datumsformate,...) entfernt werden. Andernfalls muss der Nutzer die Sprache in vielen Vorlagen in jeder Master-Seite anpassen. Wenn das Template in Deutsch erstellt wurde, wird die Rechtschreibprüfung auch in Deutsch durchgeführt.

Diese Anleitung erklärt, wie all diese Informationen (plus einige Extras) entfernt werden, so dass ein neuer Nutzer des Templates die Rechtschreibprüfung in seiner eigenen Sprache hat, egal, in welcher Sprache das Template erstellt wurde.

Template vorbereiten

Das Template wird in Impress bearbeitet:

• jeglicher Text (z. Bsp. "Schreiben Sie Ihren Text hier") wird entfernt
• lediglich die leeren Boxes bleiben übrig
• Datum und Fußnoten werden entfernt
• nicht genutzte Vorlagen werden entfernt. Nutzerdefinierte Vorlagen werden nicht übersetzt. Stattdesssen sollten vordefinierte Vorlagen verwendet werden.
• in Hinweisen werden auch Texte entfernt.
• Schließlich wird das Template gespeichert.

Auswahl des Vorschau-Bildes

Im Template-Manager ist eine Vorschau des Templates sichtbar. Diese Vorschau sollte ohne Hinweis auf irgendeine Sprache sein:

• das Template wird für eine neue Präsentation geöffnet.
• die Folie für die Vorschau wird ausgewählt: falls es mehrere Folien in dem Template gibt, wird die erste Folie angewählt.
• In Titel und Text wird ein Blindtext als Beispiel für die verwendete Schriftart eingegeben. Ein Blindtext kann dank Autotext in Writer erzeugt werden. Dazu wir "Lorem" eingegeben und markiert. Dann wird über F3 ein ganzer Text ausgegeben
• Die Präsentation wird als Standard-ODP-Datei gespeichert. Nennen wir sie example.odp.

XML-Code anpassen

XML code

Templates haben die Endung .OT?, wobei das ? für folgendes steht:

• T = .OTT für Writer
• S = .OTS für Calc
• P = .OTP für Impress
• G = .OTG für Draw

Weitere Informationen sind unter Welches Dateiformat wird von LibreOffice benutzt? zu finden. Zusammenfassend sind diese Dateiformate einfach zusammengezippte Archive mit einer Struktur aus XML-Dateien (Siehe LibreOffice und XML). Um also Zugriff auf den XML-Code zu bekommen, muss die OD?-Datei erst ausgepackt werden. Dazu wird das bevorzugte Archiv-Programm genutzt. Ggf. muss die Dateierweiterung auf .ZIP geändert werden.

Inhalt und Anpassung einer Template-Datei

Ein Impress-Template hat folgende Struktur:

• Das Verzeichnis Configurations2 sollte entfernt werden. Es ist entweder leer oder es enthält die Änderungen an der Konfiguration der Menü-Leisten oder der Tastaturkürzel. Nutzer bevorzugen deren eigene Konfiguration, wenn sie das Template verwenden
• Das Verzeichnis META-INF enthält nur eine Datei: manifest.xml. Diese Datei enthält die Dateiliste im Template. Diese Liste wird bearbeitet und jede Referenz auf Configurations2 entfernt, wenn dieses Verzeichnis entfernt wurde.
• Das Verzeichnis Pictures enthält alle Bilder, die in dem Template verwendet werden. Es ist zu prüfen, ob wirklich alle verwendet werden. Wenn welche gelöscht werden, wird bitte auch manifest.xml aktualisiert.
• Das Verzeichnis Thumbnails enthält Vorschau-Bilder. Wir werden es später aktualisieren.
• Die Datei content.xml braucht nicht angepasst zu werden, wenn das Template in Impress korrekt geputzt wurde. Dort sollte kein Text enthalten sein.
• Die Datei meta.xml enthält allgemeine Informationen zur Datei: das Erstellungsdatum, der Autor, die Version, unter der sie erstellt wurde... Also hier ist nichts zu ändern.
• mimetype ist eine Textdatei, die den Dateityp angibt. Sie sollte folgendes enthalten:

application/vnd.oasis.opendocument.presentation-template

üblicherweise wird der Typ vom Betriebssystem erkannt

Die grösste Säuberungsaktion findet in den beiden folgenden Dateien statt. Wenn die Datei eine lange Geschichte hat, finden sich hier viele nutzlose Dinge.

• Die Datei settings.xml enthält die Einstellungen vieler Optionen, die bei der Neuanlage des Template angelegt wurden. Mittlerweile sind viele dieser Einstellungen für den Nutzer nutzlos oder der Nutzer braucht andere Einstellungen (Drucker-Einstellungen, Gitter- und Umbruch-Einstellungen...) Es sollte genau überprüft werden, ob hier Einstellungen gesetzt werden. Andernfalls kann die Datei sicher entfernt werden (manifest.xml aktualisieren!), damit der Nutzer eigene Einstellungen verwenden kann.
• Die Datei styles.xml enthält alle Vorlagen, die im Template verwendet werden.
  • Sprach- und Länder-Tags werden entfernt:
    • fo:language="xx"
    • fo:country="XX"
    • style:language-asian="xx"
    • style:country-asian="XX"
    • style:language-complex="xx"
    • style:country-complex="XX"
  • Schriftgröße, Gewichtseinheiten und Vorlagen für Asien und komplexe Tags werden vervollständigt (diese Tags müssen dupliziert werden; siehe tdf#114746):
    • Die Vorlage style:font-size-asian="xxpt" style:font-size-complex="xxpt" für jedes fo:font-size="xxpt" wird ergänzt
    • Die Vorlage style:font-weight-asian="wwwww" style:font-weight-complex="wwwww" für jedes fo:font-weight="wwwww" wird ergänzt
    • Die Vorlage style:font-style-asian="sssss" style:font-style-complex="sssss" für jedes fo:font-style="sssss" wird ergänzt

Vorschau-Bild ändern

• example.odp auspacken
• die Datei thumbnail.png in Verzeichnis Thumbnails kopieren
• Das Template wird in das Template-Verzeichnis zurück kopiert

Template-Datei erzeugen

Lediglich alle Verzeichnisse und Dateien eines Templates in einer ZIP-Datei zusammenzupacken erzeugt zwar ein Template, das LibreOffice öffnen kann. Dieses Template wird aber nicht als mimetype-Datei anerkannt werden. Um eine gültige OpenDocument-Datei zu sein, muss sie am Anfang der Datei ohne Komprimierung vorhanden sein.

unter Windows

Wie man eine solche Datei bekommt, steht in der Anleitung von Regina Henschel.

unter Linux

Auspacken über den Datei-Manager ist einfach: ein Rechts-Klick auf die Datei  ▸ Hier extrahieren.

Um wieder alles zusammenpacken, können die folgenden Kommandos auf der Konsole verwendet werden. Sie werden in dem Verzeichnis ausgeführt, das die mimetype-Datei enthält:

zip -0 -X ../template2.otp mimetype
zip -r ../template2.otp * -x mimetype

die erste Zeile legt eine neue ZIP-Datei an, die nur den mimetype ohne Kompression enthält. Die zweite Zeile fügt alle anderen Dateien außer der mimetype-Datei eine nach der anderen mit Standard-Kompression dazu.

Template testen

Das Template ist jetzt fertig, um vor der Verteilung getestet zu werden. Es muss nur gemäß ODF 1.3 extended soweit wie möglich gültig sein. Prüfinstanz ist https://odfvalidator.documentfoundation.org/.

Mitentwicklung am LibreOffice Code

Der Ablauf zum Teilen des Templates wird in der README-Datei hier beschrieben.