Jak dodać i zarządzać językami

Przydziel każdemu językowi wyraźne miejsce w CMS

Rekord języka w PostnHost informuje CMS, jakie języki obsługuje Twoja publikacja. Dostarcza też kod używany w zlokalizowanych adresach URL oraz atrybucie języka HTML strony.

Trzy powiązane elementy współdziałają ze sobą:

• Rekordy językowe udostępniają język w CMS.
• Tłumaczenia treści dostarczają zlokalizowane artykuły, strony i kategorie.
• Pliki lokalizacji lub nadpisania I18n tłumaczą wspólny tekst publiczny, taki jak etykiety nawigacji i stany pustki.

Dodanie jednego elementu nie tworzy automatycznie pozostałych dwóch.

Dodaj język

1. Otwórz Języki w nawigacji CMS.
2. Wybierz Nowy język.
3. Wprowadź nazwę publiczną, na przykład „hiszpański”.
4. Wprowadź odpowiadający kod języka, na przykład es.
5. Włącz Język domyślny tylko wtedy, gdy ma to być główny język serwisu.
6. Utwórz język.

Utrzymuj kod krótki i spójny. Staje się on częścią zlokalizowanych tras, takich jak /es, więc jego zmiana później może zmienić publiczne adresy URL.

Lista Języków wskazuje język domyślny i pokazuje liczbę treści oryginalnych oraz tłumaczeń.

Zrozum język domyślny

Każda witryna powinna mieć jeden język domyślny. Jest to główny język publikacji oraz zapasowy, gdy nie żąda się wersji zlokalizowanej. Zmieniaj go tylko w ramach przemyślanego, ogólnositego planu dotyczącego języków i adresów URL.

Używaj listy języków i strony szczegółów

Dwie odznaki z liczbą pokazują treści napisane oryginalnie w tym języku oraz warianty przetłumaczone na ten język. Wybierz nazwę języka lub jego akcję podglądu, aby zobaczyć powiązane treści w szczegółach.

Język może istnieć zanim tłumaczenia będą gotowe, więc zero w liczniku jest normalne. Twórz tłumaczenia niezależnie od artykułu, strony lub kategorii będącej źródłem treści.

Jeśli strona szczegółów ostrzega, że nie istnieje plik lokalizacji, rekord języka jest dostępny, ale współdzielony tekst interfejsu publicznego nie jest w pełni przygotowany dla tego kodu. Skorzystaj z opcjonalnej konfiguracji deweloperskiej poniżej.

Przed edycją kodu lub usunięciem języka przejrzyj jego treści i tłumaczenia. Zmiany te mogą wpłynąć na zlokalizowane trasy i powiązane rekordy.

Kiedy konfiguracja deweloperska nie jest potrzebna

PostnHost zawiera publiczne pliki lokalizacji dla angielskiego, francuskiego, niemieckiego, japońskiego, koreańskiego, portugalskiego, polskiego, hiszpańskiego i rosyjskiego: en, fr, de, ja, ko, pt, pl, es i ru.

Jeśli wybrany kod jest już dostępny w aplikacji hostującej, możesz utworzyć odpowiadający Rekord języka w panelu, dodać tłumaczenia treści i dostosować wspólny tekst w Ustawienia → I18n.

Dodaj więcej języków

Ta sekcja dotyczy tylko kodu języka, którego aplikacja hostująca jeszcze nie obsługuje. Poproś dewelopera z dostępem do aplikacji Rails o wykonanie tych kroków.

Dodaj nowy kod, zachowując istniejącą listę lokalizacji:

# config/application.rb
config.i18n.default_locale = :en
config.i18n.available_locales = %i[en fr de ja ko pt pl es ru it]
config.i18n.fallbacks = [:en]

Wygeneruj plik lokalizacji aplikacji hostującej dla tego samego kodu:

bin/rails g postnhost:locale it

1. Tłumacz odpowiednie klucze pod postnhost.public w config/locales/it.yml.
2. Uruchom ponownie Rails po zmianie config/application.rb.
3. Utwórz odpowiadający Rekord języka w PostnHost z kodem it.
4. Dodaj tłumaczenia artykułów, stron i kategorii osobno.

Rekord języka, wpis w available_locales oraz nazwa pliku lokalizacji muszą używać tego samego kodu. Niezgodność może powodować brakujący tekst interfejsu lub nieoczekiwane zlokalizowane trasy. Zachowaj angielski fallback lub użyj mapy fallbacków, która ostatecznie prowadzi do języka domyślnego.

Zweryfikuj nowy język

• Otwórz jego zlokalizowany indeks, na przykład /es lub /it.
• Sprawdź publiczny przełącznik języka.
• Przejrzyj wspólny tekst w Ustawienia → I18n.
• Opublikuj i otwórz przynajmniej jeden przetłumaczony element treści.