Strona główna

Projekt na SourceForge

Strona główna KDE

Dla użytkowników

• Pliki tłumaczeń
• Jak pomóc?
• Inne strony

Dla tłumaczy

• Strona tłumaczy

Jak tłumaczyć dokumentację?

W jaki sposób to działa?

Dokumentację, podobnie jak interfejs użytkownika, tłumaczy się poprzez tłumaczenie napisów znajdujących się w plikach .po. Inny jest natomiast sposób dalszej obróbki przetłumaczonych plików .po.

Dokumentacja jest przechowywana w formacie plików Docbook - jest to język opisu dokumentacji oparty na XML. Pliki .po używane są w ten sposób, że na podstawie oryginalnej dokumentacji w formacie Docbook i pliku .po generowany jest plik Docbook zawierający przetłumaczoną dokumentację.

Przetłumaczone pliki Docbook, po zainstalowaniu, są używane przez program khelpcenter (Centrum pomocy KDE) do wygenerowania (w locie) stron HTML, wyświetlanych następnie użytkownikowi.

Jak tłumaczyć pliki .po

Generalne zasady tłumaczenia dokumentacji są takie same jak zasady tłumaczenia plików interfejsu użytkownika opisane na stronie Jak tłumaczyć.

Niemniej są pewne różnice, dlatego przed rozpoczęciem tłumaczenia należy zapoznać się z opisem z Translation Howto znajdującym się tutaj.

Należy również zwrócić uwagę na następujące rzeczy:

• Dla jednego programu może być więcej niż jeden plik .po dokumentacji, np. kate.po, kate_advanced.po, kate_configuring.po, ...

Specjalne komunikaty dla tłumaczy

CREDIT_FOR_TRANSLATORS - należy wypełnić w postaci:

<para>Imię Nazwisko<email>adres-e-mail</email></para>

ROLES_OF_TRANSLATORS - należy wypełnić w postaci:

<othercredit role=\"translator\">
<firstname>Imię</firstname><surname>Nazwisko</surname>
<affiliation><address><email>adres-email</email></address></affiliation>
<contrib>Polskie tłumaczenie</contrib>
</othercredit>

Entities (wyrazy postaci &kde;)

Niektóre wyrazy bądź zwroty powinny być tłumaczone tak samo wszędzie. W celu uspójnienia tłumaczeń stosuje się tzw. entities, które są zastępowane przez ten sam tekst w całym tłumaczeniu.

Entities muszą w obecnej chwili być zainstalowane razem z pakietem kdelibs, dlatego nie można ich sobie dowolnie definiować. Na pewno zdefiniowane są nazwy programów, użyte w tekście oryginalnym. Oprócz tego zdefiniowane są polskie nazwy dla niektórych programów, których nazwy się odmieniają. Nazwa entity zawiera wtedy również przypadek, np. &konqueror-dopelniacz; zostanie zastąpione przez: Konquerora.

Uwaga: nie należy dodawać przypadku dla nazw nieodmienialnych, np. &kde;
Pełną listę nazw, których można używać (oprócz standardowych, nieodmienialnych nazw programów, np.&kgeography;) można znaleźć w tym pliku (dla KDE 3.5).

Jak zainstalować przetłumaczoną dokumentację

1. Wygenerować dokumentację z plików .po
2. Zainstalować wygenerowaną dokumentację.

Generowanie dokumentacji z plików .po

• Przetłumaczone pliki .po (znajdujące się w katalogu kde-i18n/pl/messages/docs).
• Pliki Docbook z oryginalną (angielską) dokumentacją.
• Spolszczone wspólne elementy dokumentacji (elementy języka Docbook).

Przetłumaczone pliki .po

Pliki Docbook z oryginalną dokumentacją

Np. dla modułu kdebase należy wyciągnąć moduł kdebase/doc/ w następujący sposób (zakładam, że źródła modułu kde-i18n zostały umieszczone w katalogu ~/src/kde-i18n zgodnie z opisem z tej strony):

1. Wejdź do katalogu ~/src:
   cd ~/src
2. Wykonaj polecenie:
   cvs -d :pserver:anonymous@anoncvs.kde.org:/home/kde co -r KDE_3_3_BRANCH kdebase/doc

Po początkowym wyciągnięciu plików z CVS-a można je uaktualniać w następujący sposób:

1. Wejdź do katalogu ~/src/kdebase:
   cd ~/src/kdebase
2. Wykonaj polecenie:
   cvs up -z3 -dP

Spolszczone wspólne elementy dokumentacji

1. Wejdź do katalogu ~/src:
   mkdir ~/src
2. Wykonaj polecenie:
   cvs -d :pserver:anonymous@anoncvs.kde.org:/home/kde co -r KDE_3_3_BRANCH kdelibs/kdoctools/customization/pl
3. Jako administrator wykonaj polecenie:
   cp -a kdelibs/kdoctools/customization/pl `kde-config --prefix`/share/apps/ksgmltools2/customization/

1. Wejdź do katalogu ~/src/kdelibs/kdoctools/customization:
   cd ~/src/kdelibs/kdoctools/customization
2. Wykonaj polecenie:
   cvs up -z3 -dP pl
3. Jako administrator wykonaj polecenie:
   cp -a pl `kde-config --prefix`/share/apps/ksgmltools2/customization/

Łączenie plików .po z oryginalnymi plikami Docbook

WAŻNA UWAGA DLA POSIADAJĄCYCH KONTO CVS: ten skrypt automatycznie dodaje pliki do CVS-a, więc proszę używać osobnej kopii źródeł, wyciągniętych z anonimowego CVS, albo pamiętać nie robić commit na plikach dodanych w katalogu kde-i18n/pl/docs/.

Żeby wygenerować przetłumaczoną dokumentację należy wykonać następujące kroki:

1. Wejdź do katalogu ~/src/kde-i18n:
   cd ~/src/kde-18n
2. Wykonaj polecenie:
   ./update_xml pl

Jeśli skrypt update_xml nie pokazał błędów, dokumentacja jest wygenerowana i gotowa do zainstalowania.

Jeśli skrypt update_xml wskazał, że wystąpiły błędy, należy wykonać polecenie:

• Sprawdź, czy zgadzają się znaczniki otwierające i zamykające, np. <email> i </email>.
• Sprawdź, jak ten napis został przetłumaczony w innym języku, np. w niemieckim (wyciągnij z CVS-a katalog ~/src/kde-i18n/de/ analogicznie jak ~/src/kde-i18n/pl/).

Instalowanie wygenerowanej dokumentacji

Należy zwrócić uwagę, że instalowane są pliki znajdujące się w katalogu kde-i18n/pl/docs, a nie z katalogu kde-i18n/pl/messages/docs. Ten pierwszy zawiera wygenerowaną, przetłumaczoną dokumentację. Ten drugi zawiera pliki .po służące do wygenerowania dokumentacji.

Przysyłanie przetłumaczonej dokumentacji

Zrzuty ekranu