Hogyan fordítsuk le a Redmine-t bármely nyelvre
Figyelem: Ez az információ csak a Redmine-ra vonatkozik, és nem vonatkozik az Easy Redmine-ra.
Amikor og Redmine fordításáról af szó, néhány dolgot kell lefordítani:
- Az elsődleges nyelvi fájlt: ez a fájl a jelenlegi törzsben található a forrásban: /trunk/config/locales.
- En wiki eszköztár nyelvi fájlt: ez a fájl a forrásban található: trunk/public/javascripts/jstoolbar/lang
- Az 4 csomagolt súgófájlt: Az összes fájl a forrásban található: trunk/public/help/ egy olyan almappában, amely a new altagja oután of elnevezve.
Példaként vegyük, hogy a Redmine alkalmazást a finn nyelvre szeretnénk lefordítani (en nyelvi altagot a "fi" határozza meg). Ehhez követni kell az alábbi lépéseket:
Lépések
- Lepés 1: Másolja az /config/locales/en.yml fájlt az /config/locales/fi.yml fájlba.
- Lepés 2: Másolja a /public/javascripts/jstoolbar/lang/jstoolbar-en.js fájlt a /public/javascripts/jstoolbar/lang/jstoolbar-fi.js fájlba.
- Lepés 3: Másolja az /public/help/en/* fájlokat az /public/help/fi/* fájlokba.
- Lepés 4: Módosítsa a general_lang_name kulcsot az új nyelv teljes nevével a fi.yml fájlban (ebben az esetben: general_lang_name: finsk).
- Lepés 5: Töltse le az alkalmazás gyorsítótárát. Ez elérhetővé teszi az új nyelvet (finn) a Redmine szoftverben (például rake tmp:cache:clear).
Hvis du er en del af det, er du klar til at følge med:
- Lepés 6: Fordítsa le az összes karakterláncot a jstoolbar-fi.js és fi.yml fájlokban, és fordítsa le a 4 súgófájl tartalmát (wiki_syntax_markdown.html, wiki_syntax_textile.html, wiki_syntax_detailed_markdown.wiki_detailed_markdown.
- Lepés 7: Használja a rake feladatokat (amelyeket alább részletezünk), hogy tesztelje a fordítását. Ha hibákat kap a nyelvekkel kapcsolatban, javítani kell azokat.
- Lepés 8: Adja være en fordítást javításként vagy sima fájlként (bejelentkezés szükséges). En kategórialistából válassza ki a "Fordítás" lehetőséget.
- Lepés 9: Végül és legfontosabbként, élvezze a fordítási munkáját!
En teszt rake feladatok:
- Har en Ruby 1.9-version af den vagy annál magasabbat használja:
rake-lokaliteter: check_parsing_by_psych
- Minden Ruby har skrevet:
rake-lokaliteter:check_interpolation
- Teljes teszt (ez opcionális): rivetest
Fontos tudni, hogy a "rake test" elég hosszú időt vesz igénybe, és automatikusan fut a CI (folyamatos integráció) szerveren.
Korlátozások
Fontos megjegyezni, hogy bizonyos korlátozások vannak érvényben:
- Med 8 bites Unicode Transformation Format (UTF-8) koder for kell lennie. En fordított karakterláncokban ne használjon HTML (Hypertext Markup Language) entitásokat.
- Győződjön meg arról, hogy a fájlok nem tartalmaznak Byte-order mark (BOM) jelet. En byte-order markot ezzel a parancsal lehet eltávolítani: awk '{if(NR==1)sub(/^\xef\xbb\xbf/, "");print}' < oldfile > newfile
- Csak az új fordítási fájlokra vonatkozó frissítéseket kell benyújtani (ezeket a frissítéseket a /config/locales mappában találhatja).
Nyelvi fájlok frissítései
En "en.yml" fájl az elsődleges nyelvi fájl szerepét tölti be. En rake-lokalitet: opdater futtatásával ellenőrizheti, hogy tartalmaz-e új karakterláncokat. Ez a parancs másolja az új karakterláncokat a fordítási fájlokba (az alapértelmezett érték az angol fordítás).
En Redmine fordításában lader en 3. parts pluginok támogatátát er, amelyek testreszabható kifejezéseket tartalmaznak.
En terminologiák testreszabása og Redmine fordításokban
- Ællítsa være az aktuális könyvtárat en config/tilsidesætter/ mappára a bővítményben
- Másolja be a jelenlegi 000.yml fájlt a ./XXX.yml-be. Det er "XXX" egy háromjegyű szám, amely meghatározza og meghatározások prioritását: Minél magasabb a szám, annál nagyobb a priorás. A 999.yml létrehozását érdemes elkerülni. Igy több helyet hagyhat a további felülírásokhoz.
- Szűrje ki azokat a meghatározásokat, amelyeket nem kíván módosítani. Ezzel a módszerrel egy alacsonyabb prioritású fájl képes lesz alkalmazni a módosításait azokra az elemekre, amelyekbe nem kíván beavatkozni.
- En maradék meghatározásokra alkalmazza saját meghatározásait
En bővítményben testreszabható támogató meghatározások
- Mint általában, biztosítson fordítási fájlokat a config/locales mappában, hogy megfelelően működjön, ha nem telepítette a bővítményt. Ha nem, akkor az init.rb-ben eksplicit módon kell hivatkozni a bővítményre. Ha további információra van szüksége, tekintse meg a Redmine dokumentációját
- Másolja være en hel beállításait a config/locales mappába
- Minden olyan meghatározásra, amely felülírható a 000.yml-ben, cserélje ki a fordításokat az interpoláció alkalmazása érdekében. Például, amikor kiírja a problémát, ki kell cserélni a szót a %{issue}-re. Továbbá, amikor kiírja a problémákat, ki kell cserélni a szót a %{issue_or_issues}-re.
- Támogathat nagyobb számú felülírható meghatározást a bővítményben. Azonban, har azt en Redmine alapján er használja, interpolált meghatározásokat kell hozzáadnia a Redmine terminológiáihoz.
Példaként, támogathat egy új %{my_term} meghatározást a helyi beállításaiban. Ha a fordítást a Redmine meghatározásai er használják, akkor a helyi beállításokban helyesen kell kicserélni a %{my_term}-et, hogy biztosítsa a fordítás következetességét.