Translating an external workbench/pl

Other languages:

W poniższych uwagach, " kontekst" powinien być nazwą twojego dodatku lub środowiska pracy, na przykład, "MySuperAddon" lub "DraftPlus", lub cokolwiek innego. Wielkość liter ma tu znaczenie: na przykład "Context" to nie to samo co "context". Ten kontekst sprawia, że wszystkie tłumaczenia twojego kodu będą zebrane pod tą samą nazwą, aby tłumacze mogli je łatwiej zidentyfikować. Oznacza to, że będą oni dokładnie wiedzieli, do którego dodatku lub środowiska pracy należy dany ciąg znaków.

Uwaga: Oto skrypt all-in-one, który automatyzuje całą procedurę opisaną poniżej (zalecamy jednak przeczytanie procedury, aby wiedzieć, co skrypt powinien zrobić): https://github.com/yorikvanhavre/BIM_Workbench/blob/master/utils/updateTranslations.py

Przygotowywanie źródeł

Informacje ogólne

W każdym pliku .py Python

import FreeCAD
translate = FreeCAD.Qt.translate

print("My text")
staje się:
print(translate("context", "My text"))
Pamiętaj, że translate() nie jest zwykłą funkcją: służy również jako "tag" dla narzędzia do przetwarzania tekstu lupdate, więc musi mieć nazwę dokładnie "translate". Program lupdate jest prostym procesorem tekstu, nie wykonuje Twojego kodu. Do funkcji translate() musisz przekazywać bezpośrednio literały łańcuchowe: nie możesz przekazywać zmiennych, stałych, itp. Na przykład:
# This works:
FreeCAD.Console.PrintMessage(translate("context", "My text") + "\n")

# This does not, lupdate only sees the word "a_variable", and doesn't know what that is:
a_variable = "My text"
FreeCAD.Console.PrintMessage(translate("context", a_variable ) + "\n")

# But this works -- a_variable will contain the translated string:
a_variable = translate("context", "My text")
FreeCAD.Console.PrintMessage(a_variable  + "\n")

Może to być użyte wszędzie: w print(), w FreeCAD.Console.PrintMessage(), w oknach dialogowych Qt, itd. Funkcje FreeCAD.Console nie dodają automatycznie znaku nowej linii (\n), więc musi on być dodany na końcu, jeśli jest to pożądane. Ten znak również nie wymaga tłumaczenia, więc może znajdować się poza funkcją tłumaczącą: 

FreeCAD.Console.PrintMessage(translate("context", "My text") + "\n")



obj.addProperty("App::PropertyBool", "MyProperty", "PropertyGroup", QT_TRANSLATE_NOOP("App::Property", "This is what My Property does"))

Nie używaj swojego własnego "kontekstu" w tym konkretnym przypadku. Zachowaj "App::Property".

Wewnątrz InitGui.py

def QT_TRANSLATE_NOOP(context, text):
    return text

self.appendMenu(QT_TRANSLATE_NOOP("Workbench", "My menu"), [list of commands, ...])
self.appendToolbar(QT_TRANSLATE_NOOP("Workbench", "My toolbar"), [list of commands, ...])

FreeCADGui.addLanguagePath("/path/to/translations")
FreeCADGui.updateLocale()

Plik InitGui.py nie ma atrybutu plik, więc nie jest łatwo znaleźć względną lokalizację folderu tłumaczeń. Łatwym sposobem na obejście tego problemu jest zaimportowanie innego pliku z tego samego folderu, a następnie wykonanie w tym pliku polecenia: 

FreeCADGui.addLanguagePath(os.path.join(os.path.dirname(__file__), "translations"))
FreeCADGui.updateLocale()

Wewnątrz każdej klasy poleceń FreeCAD

def QT_TRANSLATE_NOOP(context, text):
    return text

def GetResources(self):
    return {'Pixmap'  : "path/to/icon.svg"),
            'MenuText': QT_TRANSLATE_NOOP("CommandName", "My Command"),
            'ToolTip' : QT_TRANSLATE_NOOP("CommandName", "Describes what the command does"),
            'Accel'   : "Shift+A"
    }

gdzie "CommandName" jest nazwą polecenia, zdefiniowaną przez: 

FreeCADGui.addCommand('CommandName', My_Command_Class())

Zbierz wszystkie ciągi z twojego modułu

lupdate *.ui -ts translations/uifiles.ts

To działa rekurencyjnie i znajdzie pliki .ui wewnątrz wszystkich twoich katalogów. 

pylupdate *.py -ts translations/pyfiles.ts

lconvert -i translations/uifiles.ts translations/pyfiles.ts -o translations/MyModule.ts

* Sprawdź zawartość trzech plików .ts, aby upewnić się, że zawierają one łańcuchy znaków, a następnie możesz usunąć zarówno pyfiles.ts, jak i uifiles.ts.

#!/bin/sh
lupdate *.ui -ts translations/uifiles.ts
pylupdate *.py -ts translations/pyfiles.ts
lconvert -i translations/uifiles.ts translations/pyfiles.ts -o translations/MyModule.ts
rm translations/pyfiles.ts
rm translations/uifiles.ts

Przesłanie pliku .ts do platformy tłumaczeniowej

Nadszedł czas, aby zlecić tłumaczenie Twojego pliku .ts. Możesz założyć konto na publicznej platformie tłumaczeniowej, takiej jak Crowdin lub Transifex, lub możesz skorzystać z naszego istniejącego konta FreeCAD-addons na Crowdin, które ma już wielu użytkowników, a zatem jest większa szansa, że Twój plik zostanie przetłumaczony szybko i przez ludzi, którzy znają FreeCAD.

Jeśli chcesz udostępnić swój plik na koncie FreeCAD Crowdin, skontaktuj się z użytkownikiem Yorik na forum FreeCAD.

Uwaga: niektóre platformy, takie jak Crowdin, mogą zintegrować się z GitHubem i wykonać wszystkie procesy z punktów 2, 3 i 4 automatycznie. W tym celu nie można korzystać z konta FreeCAD Crowdin. Będziesz musiał założyć własne konto.

Scalanie tłumaczeń

Kiedy Twój plik .ts został przetłumaczony, choćby częściowo, możesz pobrać tłumaczenia ze strony:

Kompilacja tłumaczeń

Teraz uruchom program lrelease dla każdego pliku, który posiadasz: 

lrelease "translations/Draft_de.ts"
lrelease "translations/Draft_fr.ts"
lrelease "translations/Draft_pt-BR.ts"

Możesz zautomatyzować ten proces: 

for f in translations/*_*.ts
do
    lrelease "translations/$f"
done

Powinieneś znaleźć jeden plik .qm dla każdego przetłumaczonego pliku .ts. Pliki .qm będą używane przez Qt i FreeCAD w czasie pracy.

To wszystko, czego potrzebujesz. Zauważ, że niektóre części Twojego środowiska pracy nie mogą być tłumaczone w locie, jeśli zdecydujesz się na zmianę języka. Jeśli tak jest, będziesz musiał ponownie uruchomić FreeCAD, aby nowy język został zastosowany.

Testowanie tłumaczeń

  1. Przełącz FreeCAD na język, który przetłumaczyłeś (np. niemiecki)
  2. Załaduj tłumaczenie do FreeCAD, np. FreeCADGui.addTranslationPath("/path/to/the/folder/containing/qmfile")
  3. Przetestuj coś, np. FreeCAD.Qt.translate("twój kontekst", "jakiś ciąg znaków")

Wynik: To powinno dać ci niemieckie tłumaczenie. Jeśli to działa dobrze, to znaczy, że podstawowa konfiguracja jest w porządku. Wtedy możemy przyjrzeć się czemuś innemu. Na przykład, nazwy poleceń powinny zawsze używać specjalnego kontekstu, który jest nazwą polecenia zarejestrowanego we FreeCAD.

Istotne uwagi

Wygodniejszy skrypt

Yorik utrzymuje wygodny skrypt dla środowiska pracy BIM, który może zbierać, wysyłać i pobierać pliki ts. Możesz po prostu skopiować i dostosować ten skrypt do swojego środowiska pracy:

https://github.com/yorikvanhavre/BIM_Workbench/blob/master/utils/updateTranslations.py

Szczegóły techniczne i obsługa zaawansowana

W powyższych przykładach używane są dwie oddzielne funkcje: translate() i QT_TRANSLATE_NOOP. Możesz również natknąć się na tr() i QT_TR_NOOP, które automatycznie podają argument "kontekst" na podstawie miejsca wywołania. Te dwie pary funkcji są zasadniczo różne.

translate() i tr() wykonują dwa oddzielne zadania: w czasie działania wykonują rzeczywiste tłumaczenie z przekazanego im łańcucha na końcowy przetłumaczony łańcuch. Jest to prawda niezależnie od tego, czy podano im łańcuch literalny, zmienną czy stałą: wyszukiwanie odbywa się dynamicznie i w czasie rzeczywistym podczas wykonywania kodu. Jednakże, zapewniają one dodatkową funkcję nie związaną z czasem rzeczywistym: są rozpoznawane przez narzędzie pylupdate. Jeśli (i tylko jeśli) zawierają literał łańcuchowy, to jest on wyodrębniany przez narzędzie. TYLKO literały łańcuchowe są wyodrębniane przez pylupdate. -- jeśli zostanie przekazana zmienna, to jest ona ignorowana przez narzędzie pylupdate. Qt będzie próbowało zapewnić tłumaczenie w czasie wykonywania, ale będzie to działać tylko wtedy, gdy jakiś inny fragment kodu wywoła jedną z funkcji tłumaczących z łańcuchem, który ma być przetłumaczony, tak aby pylupdate mógł go wydobyć. Zauważ, że kod z łańcuchem literalnym nie musi być w rzeczywistości wykonywany, musi po prostu istnieć jako linia kodu gdzieś w pliku: pylupdate nie wykonuje żadnej analizy ani egzekucji kodu, po prostu wykonuje wyszukiwanie i ekstrakcję łańcucha.

W przeciwieństwie do nich, QT_TRANSLATE_NOOP i QT_TR_NOOP nie robią nic w czasie wykonywania: są dosłownymi "no-ops" i są całkowicie ignorowane przez działający kod. Ich jedynym zastosowaniem jest oznaczenie dosłownego łańcucha do ekstrakcji przez pylupdate: nigdy nie ma sensu umieszczać zmiennej wewnątrz wywołania jednej z tych funkcji, nie będzie to miało żadnego efektu. Używa się ich w sytuacjach, gdy translate() lub tr() zostaną wywołane ze zmienną zawierającą tekst do przetłumaczenia. Na przykład, każdy kod, który jest używany do tworzenia poleceń lub właściwości, użyje funkcji typu NOOP wokół tekstu menu poleceń lub etykiety narzędzia, lub docstring właściwości: w czasie działania, gdy FreeCAD wyświetla te elementy użytkownikowi, wywołuje translate(): dosłowne ciągi muszą być wyodrębnione przez pylupdate w punkcie tworzenia, na przykład: 

def GetResources(self):
    return {'Pixmap'  : "path/to/icon.svg",
            'MenuText': QT_TRANSLATE_NOOP("CommandName", "My Command"),
            'ToolTip' : QT_TRANSLATE_NOOP("CommandName", "Describes what the command does"),
            'Accel'   : "Shift+A"
    }

W tym zastosowaniu słownik zwracany przez tę funkcję jest dosłownie w czasie pracy: 

{ 
    'Pixmap'  : "path/to/icon.svg",
    'MenuText': "My Command",
    'ToolTip' : "Describes what the command does",
    'Accel'   : "Shift+A"
}

Nie ma odniesienia do żadnego typu informacji o tłumaczeniu. Kiedy FreeCAD faktycznie wyświetla te informacje użytkownikowi, pseudokod wygląda następująco: 

for command in commands:
    resources = command.GetResources()
    menu_text = translate(resources['MenuText'])

W tym przypadku, lupdate nie może wydobyć żadnego łańcucha z wywołania translate(), ponieważ odwołuje się ono do zmiennej. Zatem lupdate ignoruje to wywołanie, ale w czasie wykonywania Qt szuka łańcucha, który został mu przekazany. Tak długo, jak gdzieś w kodzie znajduje się wywołanie jednej z funkcji tłumaczących z pasującym dosłownym łańcuchem (w tym przypadku w funkcji GetResources()), to wywołanie tłumaczenia powiedzie się.

Aby sprawdzić, czy wyodrębniane są oczekiwane ciągi znaków, możesz ręcznie uruchomić polecenie pylupdate: 

pylupdate myfile.py -ts outfile.ts

Plik outfile.ts będzie zawierał zestaw ciągów znaków, które są przesyłane do CrowdIn w celu przetłumaczenia.

Ważne odnośniki

Powiązane strony


Centrum użytkownika