Obskura – file di lingua
========================

Ogni file <codice>.xml contiene tutti i testi dell'app Obskura (interfaccia,
messaggi, errori) in una lingua. Obskura 0.3 comprende: it, en, de, es, ru, zh,
ja, ar. All'avvio l'app usa la lingua del sistema; se non è disponibile, l'inglese.

Aggiungere una lingua
---------------------
1. Copia en.xml (o la lingua da cui traduci) in un nuovo file, per esempio fr.xml.
2. Nell'elemento <language> cambia:
     code          codice della lingua: fr, pt-BR, ...  (BCP 47)
     name          nome della lingua nella lingua stessa: Français
     english-name  nome in inglese: French
     dir           "ltr", oppure "rtl" per le scritture da destra a sinistra
3. Traduci il testo di ogni elemento <string>. Salva il file in UTF-8.
4. In Obskura: Impostazioni > Lingua > "Importa file di lingua (XML)…".
   La lingua compare subito e viene usata in automatico sui sistemi in quella
   lingua. I file importati restano nella cartella dati dell'app
   (languages/<codice>.xml) e valgono solo su quel computer.

Regole
------
- Non cambiare mai l'attributo key.
- Lascia invariati i segnaposto tra graffe: {count}, {name}, {path}...
- Mantieni i tag <b>, <code>, <em>, <kbd>, <br/> dove compaiono.
- Scrivi & < > come &amp; &lt; &gt; (oppure usa <![CDATA[ ... ]]>).
- Plurali: le chiavi che finiscono in .zero .one .two .few .many .other seguono
  le regole plurali Unicode CLDR della lingua. Usa le forme che servono alla tua
  lingua; .other è obbligatoria.
- I testi mancanti compaiono in inglese: una traduzione parziale funziona già.

Correggere una lingua inclusa
-----------------------------
Un file con il codice di una lingua inclusa (per esempio de.xml) non la
sostituisce: corregge solo i testi che contiene. Nelle impostazioni è segnato
"correzioni" e si rimuove con la ×.

Impostazioni > Lingua > "Esporta modello XML…" salva il file completo della
lingua attuale, correzioni comprese.
