Documenti / Traduci / Rails YAML
Traduci file di localizzazione YAML di Rails
Compila config/locales/<lang>.yml per Rails e altri dizionari YAML, mantenendo l'interpolazione %{name} ed espandendo le mappe plurali one/other alle forme di ciascuna lingua.
Come funziona
localize-dev translate legge config/locales/en.yml, e file come devise.en.yml accanto, quindi scrive le chiavi mancanti nel file di ciascuna lingua sotto la propria chiave di localizzazione. Una lingua senza file ne ottiene uno: devise.en.yml ottiene devise.pl.yml.
I segnaposto Rails %{name} e %<name>s, i18n-js {{name}} e printf vengono mantenuti. Una mappa delle categorie plurali (one:, other:) viene trattata come un unico messaggio e scritta con le categorie utilizzate dalla lingua di destinazione.
Prima e dopo
Output effettivo di localize-dev translate --locales pl sul primo file. La mappa dei plurali items ottiene few e many del polacco, e i valori che iniziano con % rimangono tra virgolette.
en:
orders:
title: "Your orders"
shipped: "Shipped to %{city} on %{date}"
items:
one: "%{count} item"
other: "%{count} items"pl:
orders:
title: Twoje zamówienia
shipped: Wysłano do %{city} dnia %{date}
items:
one: "%{count} przedmiot"
few: "%{count} przedmioty"
many: "%{count} przedmiotów"
other: "%{count} przedmiotów"Cosa rimane intatto
- Interpolazione
%{name}, controllata dopo la traduzione - Mappe plurali, con
few:emany:aggiunti dove la lingua ne ha bisogno - La nidificazione del file sorgente, sotto la chiave della locale di destinazione
- YAML valido: i valori sono quotati dove YAML ne ha bisogno
Errori comuni e come vengono evitati
Mappe plurali con solo one e other
Rails sceglie la chiave plurale con le regole della lingua. Se pl.yml ha solo one e other, conteggi come 3 o 25 non hanno una forma propria. Ogni categoria utilizzata dalla lingua viene scritta.
Nomi di interpolazione tradotti
%{city} deve rimanere %{city}, altrimenti Rails genera un errore di interpolazione mancante a runtime. I segnaposto vengono mascherati prima della traduzione e controllati dopo.
Virgolette errate
Un valore che inizia con % o contiene : necessita di virgolette, e una traduzione modificata manualmente le perde facilmente. Il file è scritto da una libreria YAML, quindi le virgolette seguono le regole di YAML.
Esegui
Nella cartella che contiene i file di localizzazione. Le lingue senza un file ne ottengono uno. --dry-run mostra cosa cambierebbe per primo.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deQuindi tienilo completo in CI. Non richiede alcuna chiave API e fallisce quando a una lingua mancano le traduzioni:
npx localize-dev check --only translationsGratuito per 1000 stringhe al mese. Una stringa conta una volta, indipendentemente da quante lingue includa. Crea un account gratuito
Guide per le app che utilizzano questo formato
Quando il testo è ancora hardcoded nel tuo codice, localize-dev run lo sposta prima in questo formato.