LibreOffice Lokalisierungs Handbuch

    From The Document Foundation Wiki
    This page is a translated version of the page LibreOffice Localization Guide and the translation is 48% complete.

    Dieses Dokument ist für neue Übersetzer gedacht, die bisher noch keinen Kontakt zu LibreOffice oder der Welt von Open Source im Allgemeinen hatten. Es basiert auf dem Tutorial Localization of OpenOffice.org 2.0 von Javier Solá.

    Planung und Vorbereitung

    Was Sie wissen müssen

    LibreOffice lokalisieren erfordert keine hoch spezialisierten Programmeirkenntnisse oder Kenntnisse der Open Source Welt. Es erfordert auch keine Kenntnis eines speziellen Betriebssystems wie Linux. Jeder kann LibreOffice auf Windows lokalisieren, wenn er es will. Einmal erledigt, können Lokalisierungen sehr einfach auf andere Plattformen übertragen werden. (wenn Dein Sprachskript durch diese Plattformen unterstützt werden, oder nicht ganz so einfach, wenn diese Basisunterstützung fehlt).

    Du brauchst nicht verstehen, wie man Programme oder Daten aus dem Internet herunterlädt, wie sie installiert werden oder gestartet werden (folge genauen Anweisungen). Es wird auch wärmstens empfohlen, mindestens einer Mailingliste beizutreten, in welcher die Lokalisierung von LibreOffice besprochen wird.

    LibreOffice - genauso wie Open Source im Allgemeinen - ist eine gemeinschaftliche Aufgabe. Es gibt keinen Grund dafür, warum jemand irgendetwas machen sollte, das Du brauchst oder willst, inklusive Fehlerbehebung, neue Funktionen hinzufügen oder Korrekturprogramme ausführen. Bitte sei höflich, geduldig und - wenn Du wirklich etwas willst - charmant und verbindich… oder lerne wie Du es selbst tun kannst. Es gibt viele Leute in den Mailing Listen, die Dir helfen wollen, wenn Du sie auf die richtige Art und Weise fragst.

    Kontrolliere die Liste der LibreOffice Sprachteams, um zu überprüfen, ob es nicht bereits ein Lokalisierungsprojekt für Deine Sprache gibt. Wenn dem so ist, schreibe der Kontaktperson, um den Status des Projektes zu erfahren und ob es Sinn macht, dem Projekt beizutreten. Denke dran, dass sich nicht alle Teams die Zeit nehmen, sich auf der Seite einzutragen. Daher heisst eine fehlende Tabellenzeile nicht, dass es kein Team gibt. Es wird empfohlen, auch die anderen Seiten der Category:L10n zu kontrollieren und einen kurzen Blick auf Weblate zu werfen. Falls der Status Deines Gebietsschemas immer noch unklar ist, kontaktiere bitte die L10n Mailingliste.

    LibreOffice zu übersetzen, ist keine kleine Aufgabe und sie hat viele Ebenen. Die einfachste ist, sicher zu stellen, dass LibreOffice Deine Schrift (falls sie nicht lateinisch ist) richtig behandelt, auch wenn die Schnittstelle in Englisch oder einer anderen Fremdsprache ist. Unterstützung für Deine Schrift zu organisieren, ist vielleicht noch ein Punkt, den Du selbst stemmen kannst. Aber die ganze LibreOffice Schnittstelle komplett zu übersetzen, ist eine viel größere Aufgabe, die mehr als ein Mannjahr erfordert. Daher wäre es ideal, wenn mehrere Personen involviert sind.

    Lokalisierung von LibreOffice beinhaltet:

    • Sicherstellen, dass LibreOffice mit Deiner Schrift auf der Plattform funktioniert, die Du nutzen willst.
    • Sicherstellen, dass das Programm Deine Sprache als eine Sprache erkennt, in der es funktionieren kann. (das kann einige Ändderungen im Quelltext erfordern. Aber keine Angst - Du musst das sehr wahrscheinlich nicht selbst erledigen).
    • Übersezen in Deine Sprache. Übersetzen hat mehrere Ebenen:
      • Als Erstes und Wichtigstes - die Menüs und Mitteilungen des Programmes selbst übersetzen (ca. 28.000 Texte / 93.000 Wörter für alle LibreOffice Applikationen zusammen).
      • Zweitens - übesetzen der Hilfe-Dateien von LibreOffice, keine einfache Aufgabe (nochmal 45.000 Texte / 440.000 Wörter).
      • Die dritte Ebene ist, die Dokumentation in Deiner Sprache zu entwickeln. Wenn Du nach all dem immer noch freie Kapazitäten hast, kannst Du die Trainingsunterlagen für LibreOffice in Deiner Sprache vervollständigen.

    Aber, bevor wir in die Einzelheiten zu all dem gehen, gibt es ein paar Dinge zu regeln, um für ein Lokalisierungsprojekt gerüstet zu sein…

    Denke an Deine eMail Adresse

    Wenn Du den Lokalisierungsprozess startest, wirst Du Dich bei mindestens einer Mailingliste eintragen. Deine eMail Adresse wird herumgereicht werden, so dass Du eine Menge Spam bekommen wirst. Du solltest Dich vielleicht von der Qualität des Spamfilters Deines Providers überzeugen und wenn er nicht adäquat ist, denke daran, eine eigene eMail Adresse für die ganze Lokalisierung zu verwenden (und nicht nur für LibreOffice).

    Du solltest mit den Programmen, die Du zum Übersetzen benutzt, vertraut werden. Wenn Du kein regelmässiger Nutzer bist, empfehlen wir, dass Du auf LibreOffice wechselst und es bei Deiner täglichen Arbeit nutzt.

    Wir empfehlen, dass Du die Version installierst, die Du übersetzen willst (wahrsscheinlich die letzte stabile Version). Du findest sie auf der Download Seite.

    Später, wenn Du Versionen von LibreOffice findest und bearbeitest, wirst Du wissen wollen, ob und wann Deine Korrekturen eingearbeitet werden. Du wirst also die neuesten verfügbaren builds herunterladen und installieren wollen. Du findest sie auf der Seite der Vorabversionen.

    Die Installationsdateien brauchen ungefähr 200 MB Speicherplatz, und Du brauchst nochmal ca. 500 MB, um das aktuelle LibreOffice zu installieren (und wahrscheinlich mehr während der Installation).

    It might be that LibreOffice does not work with your script. In this case you have to try to get such support. See tough things to do if your script is not supported yet for details and contact the developer mailing list for further advice.

    Registriere Dich bei LibreOffice

    In process, you will need to register with the various services that LibreOffice uses. We don't use single sign-on for all our services yet. For example, to subscribe to LibO mailing lists, you will have to send empty messages to list+subscribe email addresses; to file bugs and provide patches, you will need to register with Bugzilla; to translate online, you can use your TDF single sign-on account to log into Weblate, and so on…

    Tritt der Lokalisierungs Mailing Liste bei

    Prior to starting localization of LibreOffice, you should join the LibreOffice localization mailing list. This mailing list is the means of communication with the people in LibreOffice that drive the localization, as well as with other localizers that might help you figure out specific parts of the localization adventure. It will become your main window into the world of LibreOffice, unless you become involved in other developments outside localization.

    To join this mailing list, just send an empty message to l10n+subscribe@global.libreoffice.org. This will make the LibreOffice mailing list manager send an e-mail to your account asking you to confirm your intention of subscribing to the list. Reply to that message following the instructions (which usually are “just hit reply and send, don’t do anything else”).

    If you have done everything correctly, you will receive a “Welcome to the list” message… and you are on. From this moment on you will receive all mails sent to the list and will be able to send mails to the list yourself.  

    Announce your intention to undertake the localization project

    The first step is to let people at LibreOffice know that you are going to start the localization project, but before you do this, please check if there is already a project for your language listed in the Language Teams page. This list might not be ordered alphabetically, make sure to check it well.

    Dazu gibt es mehrere Möglichkeiten:

    • Your language is already listed, including all the data and a contact of a project manager. In this case you should contact directly that project manager and try to figure out what is happening, status, etc… It does not make sense to have more than one project for exactly the same language, but maybe the project that is being carried on is different from the one you want to do (for example, there is Khmer for Cambodia, but you want to do Khmer for Khmer-speaking minorities in Vietnam, which is sufficiently different to justify the localization work, and you are prepared to do it). If the project is sufficiently similar, you should consider joining the existing project.
    • The language is listed, but it is either in the FIXME list or it does not include a project contact name. In this case you should write to the list and ask if anybody has information about this project. If there are no answers, you probably can take the project over.
    • Your language is not in the list. In this case check out if the locale exists and has any recent activity in the appropriate project (LibreOffice x.x.x – UI) in Weblate.
      • If it is active, it's quite likely that the team leader simply forgot to list his team. In this case, contact the mailing list to find out who the leader is and make sure to remind him or her to add missing information to the Language Teams table.
      • If it is inactive and lacks a lot of strings, the project is likely in a dormant state. In this case, act as if the language is in the FIXME list: write to the list and ask if anybody has information about this project. If there are no answers, you probably can take the project over.
      • If the language is not listed in Weblate at all, it's a pretty good indication that you will have to start from scratch. In this case, prepare for a lot of translation work (or better, find yourself a few comrades) and contact the localization mailing list telling your intentions and listing all the necessary information (see below).

    The necessary information that you need to gather to be listed in the Language Teams page (that is, for your project to be considered as an on-going localization project) is:

    • The ISO codes for your language and country or region. If you don’t know them, follow these links: Language codes - iso639-2 Country codes - iso3166-1
    • You should also mention if the language is only spoken in a country or is shared by several countries/regions, and if there are sufficient difference in the way the language is spoken and written in the different countries/regions as to require separate treatment. Based on this data, an internal ISO-CODE for your localization will be assigned by the LibreOffice localization team leader according the following rules (taken from RFC 3066):
      1. Use ISO 639-1 if possible. This happens when the language is spoken in a single country (or there are no major differences between how it is spoken in different countries), or when the ISO code of the language is the same than the ISO code of the country (es, fr).
      2. Use ISO 639-2 (three letter language code) if no ISO 639-1 (two letter) code exists.
      3. Use ISO 3166 country code if necessary, to specify versions of languages with the same language code in different countries, such as Spanish in Chile (es-CL), Portuguese in Brazil (pt-BR), or English in the United States (en-US).
    • The name of the language in English.
    • The Microsoft locale ID, in decimal and hexadecimal formats. You can find this numbers in [1].
      If your language does not appear in the list, then say so in the LibreOffice Localization mailing list and the language will be assigned a LibreOffice internal number. This number is used for the cases in which information is stored or read in Microsoft file formats.
    • Inform about the script of your language. Does the language use Latin script? Does it have its own script? If so, what family does the script belong to, specifying if it is Indic, if it uses use pictograms, if it is written from right-to-left, etc... and any other information that might be relevant, including character sets that can be used to render (show) it.
    • Give a contact e-mail address for the manager of your localization project (probably yourself).

    If you want to start a new project, you should write all the above information in an e-mail to the localization list, indicating your intention to start a localization project, and stating what is the status of the project. The person in charge of the list of localization projects will add your language and data to it, including the current status for your project.  

    Plan your work

    And now you are ready to start your localization project. Next we will go one-by-one, through all the changes that need to be done to LibreOffice in order for it to work in your language and script, using your local conventions in numbers, and the preferred fonts for your script.

    These steps are not very complicated, and we will try to explain them to you very clearly, but they might take some time. Some of them require time from other people at LibreOffice, who will not always be available, and who probably already have a long list of tasks they have to get to before they can help you with your localization. You should start the actions, and do your part of the work, and then wait until the right people have the time to integrate them in the source.

    You should also start looking at the translation part of the project. Translating LibreOffice requires gathering or developing a wide range of computer, mathematical and accounting terms in your own language, a glossary. If you do not have such a glossary, you should start working on it as soon as possible, because it will probably take at least two or three months to gather all the information.

    If you already have a glossary, then you can start already on the translation of the messages, in parallel to the technical work

    Source code modifications

    Include the language in "Language Settings" Dialog Box

    Check the latest build to see if your language appears in the language dialog boxes. To do this go to Tools→Options, click on Language Settings, and then on Languages.

    The Language Settings dialog

    Search for the name of your language in the Locale Setting dialog box. If it is not there, you have to request having it included.

    There are two levels of language/locale support:

    Add the new language

    For the mere support of UI localization and to have the language/locale available in character attribution and thus for spell-checking (if there is a spell check dictionary available that is) it is sufficient to add it to a few places in the source code, for details please see adding a new language or locale that also explains how to have this done for you.

    After you file the request to add a new language, it is a good idea to send an e-mail to the localization mailing list (yes, the one you are already subscribed to) saying that you are starting localization to your language and that you have requested inclusion in the Locale Setting dialog box in bug xxxxx. This will make people who are in charge of localization aware of the fact that the process for your language has started and that you need some help from them.

    Submit locale data

    To support a locale to the degree that it is listed in Locale setting and available as default document language its locale data is needed, for details please see how to submit new locale data.

    Advanced source code modifications

    Some languages may require further work, please see advanced source code modifications.