Eine Schritt-für-Schritt-Anleitung zur Erstellung einer vollständigen Übersetzung für Visforms.
Wir möchten Visforms gerne in möglichst vielen Sprachen anbieten.
Dafür haben wir eine Download-Seite für Übersetzungsdateien eingerichtet, auf der Sie hoffentlich bald passende Übersetzungen finden werden.
Wenn Sie also den Anweisungen folgen und eine vollständige Übersetzung aller Sprachdateien für Visforms erstellen, würden wir uns freuen, wenn Sie Ihre Arbeit mit anderen Visforms-Nutzern teilen.
Bitte senden Sie uns Ihre Übersetzung zu. Vielen Dank!
Bevor Sie beginnen
Den korrekten Sprach-Tag ermitteln
Bevor Sie mit der Übersetzung beginnen, müssen Sie den korrekten Sprach-Tag ermitteln.
Jede Sprache ist mit einem Sprach-Tag (Language Tag) verknüpft.
Ein Sprach-Tag (z. B. en-GB) besteht aus
- zwei Kleinbuchstaben für die Hauptsprache (en),
- einem Bindestrich (-) und
- zwei Großbuchstaben für die Region (GB).
Prüfen, ob bereits eine Übersetzung existiert.
Prüfen Sie auf der Download-Seite für die Sprachdateien,
ob bereits eine Übersetzung für Ihre Sprache existiert.
Falls ja, schauen Sie in der Spalte Hinweis nach, ob die Übersetzung aktuell ist oder ob sie eine Aktualisierung benötigt.
Ist die Übersetzung nicht mehr auf dem neuesten Stand, laden Sie die entsprechende Sprachdatei herunter und folgen Sie den Anweisungen zur Aktualisierung einer bestehenden Übersetzung.
Falls noch keine Übersetzung vorhanden ist, folgen Sie den Anweisungen zur Erstellung einer neuen Übersetzung.
Aufwand bestimmen
Frontend für den Anwender
Es macht besonderen Sinn das Frontend für alle Anwender der Formulare in der gewünschten Muttersprache zu zeigen.
Alle Texte für das Frontend befeinden sich in den INI-Dateien im Ordner site der heruntergeladenen und entpackten ZIP-Datei (siehe unten).
Dateien mit der Endung .sys.ini im Ordner site brauchen für das Frontend nicht übersetzt werden.
Mit plg_* beginnenden Dateien ohne die Endung .sys.ini im Ordner admin müssen für das Frontend zusätzlich übersetzt werden.
Der Aufwand hierfür ist vergleichsweise gering.
Die Texte für das Frontend sind lange nicht so zahlreich und im einzelnen insgesamt deutlich kürzer als für das Backend, mit seinen durchaus detailreichen Erklärungen und Beispielen.
Hinweis: Die Menge an Übersetzungen für das Frontend sind etwa 10 % der gesamten Texte.
Backend für den Administrator
Es macht ebenso Sinn das Backend für alle Administrator der Formulare ebenfalls in der gewünschten Muttersprache zu zeigen.
Alle Texte für das Backen befeinden sich in den INI-Dateien im Ordner admin der heruntergeladenen und entpackten ZIP-Datei (siehe unten).
Mit plg_* beginnenden Dateien ohne die Endung .sys.ini im Ordner admin brauchen für das Backend nicht übersetzt werden.
Dateien mit der Endung .sys.ini im Ordner site müssen für das Frontend zusätzlich übersetzt werden.
Der Aufwand hierfür ist eher groß.
Die Texte für das Backend sind zahlreich und im einzelnen insgesamt deutlich länger als für das Frontend, mit seinen eher kurzen und prägnanten Angaben und Meldungen.
Hinweis: Die Menge an Übersetzungen für das Backend sind etwa 90 % der gesamten Texte.
Neue Übersetzung erstellen
- Laden Sie die englischen Sprachdateien herunter: visforms-language-en-GB_j6.zip.
- Entpacken Sie die ZIP-Datei.
- Benennen Sie den entpackten Ordner entsprechend Ihrem Sprachkürzel um:
z. B. pt-PT, falls Sie ins Portugiesische – wie in Portugal gesprochen – übersetzen möchten. - Öffnen Sie den umbenannten Ordner.
- Benennen Sie die Datei visforms-en-GB.xml um.
Ersetzen Sie dabei en-GB im Dateinamen durch Ihr Sprachkürzel. - Öffnen Sie die umbenannte XML-Datei mit einem Texteditor Ihrer Wahl.
- Bitte ändern Sie die Attribute des
<extension>-Knotens nicht. - Ersetzen Sie die Zeichenfolge „- en-GB“ im
<name>-Knoten durch den Namen und die Region Ihrer Sprache.
Nehmen Sie an diesem Tag (Element) bitte keine weiteren Änderungen vor. - Ersetzen Sie den Wert im
<author>-Knoten durch Ihren Namen. - Ersetzen Sie den Wert im
<authorurl>-Knoten durch Ihre URL (optional). - Ersetzen Sie den Wert im
<creationDate>-Knoten durch das aktuelle Datum. - Passen Sie den Text im
<description>-Knoten an. - Ersetzen Sie jedes Vorkommen der Zeichenfolge en-GB durch Ihr Sprachkürzel.
- Speichern Sie Ihre Änderungen und schließen Sie die XML-Datei.
- Öffnen Sie den Ordner admin.
- Öffnen Sie nacheinander alle Dateien im admin-Ordner mit einem Texteditor Ihrer Wahl und übersetzen Sie die englischen Texte in Ihre Sprache.
Ein Übersetzungseintrag besteht aus einem Platzhalter in Großbuchstaben, einem Gleichheitszeichen (=), einem öffnenden Anführungszeichen ("), dem englischen Text und einem schließenden Anführungszeichen (").
Achten Sie darauf, diese Struktur nicht zu verändern und ausschließlich den englischen Text zu ersetzen! Alle Übersetzungen müssen in doppelte Anführungszeichen (") gesetzt werden! - Zeichenfolgen wie {0} oder %s sind Konstanten oder Variablen, die nicht verändert werden dürfen.
- Öffnen Sie den Ordner site.
- Öffnen Sie nacheinander alle Dateien im Ordner site mit einem Texteditor Ihrer Wahl und übersetzen Sie die englischen Texte in Ihre Sprache.
- Jetzt sind wir fast fertig.
Sie müssen lediglich den gesamten Übersetzungsordner (den Ordner, den Sie in Ihr Sprachkürzel umbenannt haben, z. B. pt-PT) als ZIP-Datei komprimieren. - Testen Sie Ihre Übersetzung.
Installieren Sie das Sprachpaket über den Erweiterungsmanager in Ihrem Administrationsbereich. - Senden Sie uns die ZIP-Datei mit Ihren Übersetzungen per E-Mail an contact@vi-solutions.de.
Wir werden sie dann auf der Seite mit den Übersetzungsdateien bereitstellen.
Vorhandene Übersetzung aktualisieren
- Laden Sie die englischen Sprachdateien herunter: visforms-language-en-GB.zip.
- Entpacken Sie die Datei visforms-language-en-GB.zip.
- Entpacken Sie die bereits heruntergeladene ZIP-Datei für Ihre Sprache.
- Suchen Sie nach neuen Einträgen in den englischen Sprachdateien (en-GB), die in Ihrer Übersetzung noch fehlen.
Sie müssen dazu jede einzelne Sprachdatei überprüfen – am besten mithilfe eines Vergleichsprogramms.
Fügen Sie die neuen Einträge in die entsprechende Sprachdatei für Ihre Sprache ein und übersetzen Sie die englischen Texte.
Um Ihnen die Arbeit zu erleichtern, werden neue Texte immer am Ende der jeweiligen Datei hinzugefügt. - Öffnen Sie die XML-Datei (z. B. pt-PT.xml) im Hauptverzeichnis des Sprachpakets und passen Sie den Wert im
<version>-Tag an.
Hier die Version eintragen, wie sie in der en-GB.xml drin steht. - Erstellen Sie ein ZIP-Archiv des gesamten Übersetzungsordners (des Ordners, den Sie zuvor mit Ihrem Sprachkürzel – z. B. pt-PT – benannt haben).
- Testen Sie Ihre Übersetzung.
Installieren Sie das Sprachpaket über den Erweiterungsmanager in Ihrem Administrationsbereich. - Senden Sie uns die ZIP-Datei mit Ihrer Übersetzung per E-Mail an contact@vi-solutions.de.
Wir werden sie anschließend auf der Seite mit den Übersetzungsdateien bereitstellen.