Lokalizacja Final Fantasy XIV

Jak to działa

Pięć kroków prowadzi zdanie z gry z powrotem do gry, już przetłumaczone. Biorą w tym udział dwa repozytoria, pull request i wtyczka. Żaden plik gry nie jest zmieniany.

Szybka droga

W przeglądarce

Cztery kliknięcia na GitHubie. Nic do instalowania, żadnego gita do nauki.

Zobacz cztery kroki → Pełna droga

Z klonem i edytorem

Sklonuj oba repozytoria i tłumacz w swoim edytorze, z angielskim, francuskim i japońskim obok.

Zobacz cztery kroki →

Szybka droga

W przeglądarce

Wszystko dzieje się na GitHubie. Pierwsze kliknięcie tworzy fork repozytorium, czyli twoją własną kopię. Tak każdy, kto nie jest właścicielem projektu, proponuje w nim zmiany.

1

Otwórz plik na GitHubie i kliknij ołówek

Wejdź do repozytorium języka, do folderu corpus/, i otwórz plik rozmowy. Ołówek w prawym górnym rogu otwiera edytor. Jeśli nie jesteś współpracownikiem, GitHub najpierw prosi o fork repozytorium. Zaakceptuj.

ffxiv-language-pack-pl/ corpus / flat / DefaultTalk.json✎

●You need to fork this repository to propose changesFork this repository

Fork powstaje w sekundę, a edytor otwiera się na nim. Dzieje się to tylko za pierwszym razem.
Żeby znaleźć linię, wyszukaj jej angielski tekst w ffxiv-corpus-en. Plik ma tę samą ścieżkę w obu repozytoriach.

2

Wpisz target

Wpisz tłumaczenie w pole target wiersza. Nie zmieniaj gameKey ani hash: identyfikują linię. Tekst w nawiasach ostrych to makro; skopiuj je bez zmian.

github.com · ffxiv-language-pack-pl · DefaultTalk.json

    { "gameKey": "DefaultTalk#590415.20", "hash": "E38048F1B03D2DD9", "target": "Jestem najemnym kapitanem Oriona." },
    { "gameKey": "DefaultTalk#590415.21", "hash": "5869006EA8C4FD7E", "target": "" },

Możesz zmienić jeden wiersz albo sto, w jednym pliku albo w kilku. Pull request zabiera wszystkie.
Angielski, francuski i japoński tego wiersza są w tym samym pliku w ffxiv-corpus-en.

3

Commit changes, potem Propose changes

Commit changes otwiera okno. Wpisz wiadomość, która mówi, co przetłumaczono; GitHub tworzy gałąź w twoim forku. Propose changes prowadzi do pull requesta. Create pull request otwiera go do repozytorium języka.

Propose changes

Wiadomość commitaAhldskyf, kapitan Oriona

Gałąźpatch-1 → mainPropose changes

✔Able to merge. These branches can be automatically merged.Create pull request

Wiadomość musi mówić, które linie przetłumaczono. Z niej generowane są notatki wydania.

4

Poczekaj na check

Gdy pull request istnieje, validate sprawdza każdy zmieniony wiersz. Jeśli jest zielony, pull request scala się sam. Jeśli język ma recenzenta, czeka na jego zgodę. Jeśli jest czerwony, raport mówi, który wiersz nie przeszedł i dlaczego. Popraw go w tej samej gałęzi, a check uruchomi się ponownie.

ffxiv-language-pack-pl· Pull request

✔validate sprawdza każdy zmieniony wiersz: zmienił się tylko target, JSON jest poprawny, makra są na miejscu i nie ma znacznikówvalidate

●Jeśli język ma recenzenta, scalenie czeka na jego zgodę. Jeśli nie ma, nie czekaAuto-merge enabled

⛙Scalono do main

Pierwszy pull request z całkiem nowego konta GitHub czeka, aż opiekun uruchomi check. Następne uruchamiają się same.

Pełna droga

Z klonem i edytorem

Angielski jest w jednym repozytorium, a twój język w drugim. Oba mają te same pliki i te same linie. Z oboma otwartymi w edytorze tłumaczysz z francuskim i japońskim przed oczami.

1

Otwórz oba repozytoria

Otwórz ffxiv-corpus-en i ffxiv-language-pack-pl w Visual Studio Code albo w innym edytorze. Oba mają tę samą strukturę w corpus/: jeden plik na rozmowę i jeden plik na arkusz interfejsu.

Visual Studio Code

EXPLORER

▾ ffxiv-corpus-en

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

▾ ffxiv-language-pack-pl

▾ corpus

▾ quest

▾ 041

AktKba101_04102.json

ffxiv-language-pack-pl ›corpus / quest / 041 / AktKba101_04102.json

{
  "conversation": "quest/041/AktKba101_04102",
  "gameVersion": "2026.08.11.0000.0000",
  "entries": [
    { "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_00", "hash": "6100EBD3346502DA", "target": "" },
    { "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_01", "hash": "A91C0F3E6D2B7C10", "target": "" },
    …

Zrób fork repozytorium języka na GitHubie i sklonuj fork. Dzięki temu możesz wypchnąć swoją gałąź.
ffxiv-corpus-en jest tylko do odczytu. Sklonuj go albo przeglądaj na GitHubie. Nie jest edytowany.

2

Znajdź ten sam plik w obu

Ścieżka pliku jest taka sama w obu repozytoriach, tak samo jak każdy gameKey. Plik angielski ma linię po angielsku, francusku i japońsku. Twój ma ten sam klucz, hash i pusty target.

Visual Studio Code

ffxiv-corpus-en ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "en": "The effort to find the blasphemy is being led by none other than the Elder Seedseer herself, Kan-E-Senna.",
  "macro": "The effort to find the blasphemy is being led by none other than the Elder Seedseer herself, Kan<-->E<-->Senna.",
  "fr": "Les recherches du blasphème sont menées par la Grande Prophétesse en personne, Kan-E-Senna.",
  "ja": "ブラスフェミーの捜索は、カヌ・エ・センナ様が自ら指揮を執っている。",
  "hash": "3C7D2A9E5B1F8E04"
}

ffxiv-language-pack-pl ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": ""
}

Podziel edytor: angielski po jednej stronie, twój plik po drugiej.
W razie wątpliwości szukaj po gameKey. To wartość, którą oba pliki dzielą.

3

Przetłumacz

Wpisz tłumaczenie w target. Wyjdź od angielskiego, francuskiego albo japońskiego, tego, który rozumiesz najlepiej. Tekst w nawiasach ostrych to makro, które gra wypełnia, gdy pokazuje linię: imię gracza, łamanie linii, wariant zależny od płci. Kopiuj makra bez zmian.

Visual Studio Code

ffxiv-language-pack-pl ›corpus / quest / 041 / AktKba101_04102.json

{
  "gameKey": "quest/041/AktKba101_04102#TEXT_AKTKBA101_04102_SEQ_02",
  "hash": "3C7D2A9E5B1F8E04",
  "target": "Poszukiwaniami bluźnierstwa kieruje nie kto inny jak sama Starsza Jasnowidząca, Kan<-->E<-->Senna."
}

Zapisz plik bez zmiany formatu: UTF-8 bez BOM i to samo wcięcie. Edytor rozumiejący JSON robi to sam.
Rozmowa to plik. Przetłumacz ją w całości, żeby głosy były spójne.

4

Commit, push, pull request

Utwórz gałąź w swoim forku. Zrób commit z wiadomością, która mówi, co przetłumaczono. Wypchnij gałąź i otwórz pull request do repozytorium języka. Możesz to zrobić z terminala albo z panelu gita w edytorze.

Terminal

$ git checkout -b ahldskyf
$ git commit -am "Ahldskyf, capitano dell'Orion"
$ git push -u origin ahldskyf
$ gh pr create --fill

Otwieraj jeden pull request na partię linii, nie na linię. Notatki wydania wymieniają jego commity.
Od tego miejsca proces jest taki sam jak w przeglądarce: check, scalenie i wydanie.

Czego się nie rusza

Cztery zasady, ważne na obu drogach. Check pilnuje trzech pierwszych. Czwarta sprawia, że tłumaczenie jest dobre.

gameKey · hash · gameVersionNie są edytowane. Identyfikują linię i jej łatkę. Check odrzuca każdą ich zmianę.
<--> <br> <if(…)>Kopiowane bez zmian: te same, które ma angielski, ani jednego więcej. Dodane makro psuje linię. Usunięte makro gubi imię albo łamanie linii.
"target": ""Puste znaczy „nieprzetłumaczone”. Nie wpisuj znaczników w rodzaju TODO: gra by je pokazała.
fr · jaCzytaj je. Francuski pokazuje, jak linia jest powiedziana. Japoński jest oryginałem i wyjaśnia, co znaczy.

Po pull requeście

Nikt nie ingeruje. Check się uruchamia, scalenie następuje, wydanie się buduje, a wtyczka proponuje je każdemu graczowi przy starcie.

ffxiv-language-pack-pl· Pull request → Release

✔validate sprawdza każdy zmieniony wiersz: zmienił się tylko target, JSON jest poprawny, makra są na miejscu i nie ma znacznikówvalidate

●Jeśli język ma recenzenta, scalenie czeka na jego zgodę. Jeśli nie ma, nie czekareview

⛙Scalono do main

▲Wydanie zbudowane i opublikowane. Zajmuje to dwie, trzy minutyrelease

◆Gubal Library proponuje nową wersję przy starcie i pokazuje twoją linięGubal Library

The Unending Codex po hiszpańsku, z wpisem o Alphinaudzie — **The Unending Codex**Hiszpański pakiet tłumaczy wpisy kodeksu o postaciach, miejscach i pojęciach.

Dialog z zadania w oknie rozmowy gry, przetłumaczony — **Co czyta gracz**Hiszpańska paczka w oknie rozmowy. Twoja wygląda tak samo: gra rysuje twój tekst własną czcionką, kursywą i kolorami.

Języki

Jedno repozytorium na język. Procent przetłumaczenia jest czytany z każdego repozytorium przy ładowaniu strony.

Język	Repozytorium	Przetłumaczone	Błędna linia?
Español (España)	ffxiv-language-pack-es-es	—	issues
Italiano	ffxiv-language-pack-it	—	issues
Português (Brasil)	ffxiv-language-pack-pt-br	—	issues
Polski	ffxiv-language-pack-pl	—	issues

Inny język? Zapytaj na GitHub Discussions.