Capire la struttura dei file. #
A .po file (Portable Object) è il formato standard utilizzato dai flussi di lavoro di localizzazione basati su gettext. Coppia stringhe di origine originali ( msgid) con stringhe tradotte ( Il mio nome) e trasporta i metadati come testo normale. Oltre alle coppie visibili, due elementi svolgono un ruolo decisivo per traduttori e sviluppatori: commenti e contesto. I commenti comunicano intenti, vincoli o dettagli di attuazione, mentre il contesto (il msgctxt campo) disambigua le stringhe identiche utilizzate in luoghi diversi.
Conoscere l'anatomia del file ti aiuta a creare commenti e contesto utili. Una voce tipica contiene commenti opzionali dello sviluppatore e del traduttore, linee di riferimento opzionali che puntano alle sedi del codice sorgente, bandiere che indicano forme plurali o la formattazione, e le msgctxt quando necessario. Trattare il commenti e campi di contesto come cittadini di prima classe— sono leggere, leggibili dall'uomo e possono prevenire errori di traduzione costosi.
Diversi tipi di commenti nei file. #
.po file supporta diversi moduli di commento, ciascuno con uno scopo specifico. Usare il giusto tipo di commento rende la parsing prevedibile per gli strumenti e più chiaro per gli esseri umani. Qui di seguito è una spiegazione concisa dei tipi comuni e quando usarli.
La tabella che segue i tipi di commento, che cosa significano, e esempi di utilizzo pratico.
| Prefisso | Significato | Quando si parla |
|---|---|---|
| #. | Commento automaticamente (nota di traduttore) | Utilizzare per suggerimenti semantici prodotti da strumenti di estrazione, come il significato dei parametri |
| #: | Riferimento alla posizione sorgente (file:line) | Includere quando puntare traduttori a tartaruga la stringa abbigliamento in codice |
| #, | Bandiere (ad esempio, fuzzy, no-c-format) | Populate da strumenti per indicare lo stato o la gestione speciale |
| # | Traduttore commento (forma libera) | Nota umana da traduttori o brevi suggerimenti per sviluppare |
| #| | Precedente stringa non traslata (obsoleto) | Quando si mantiene la storia dopo i cambiamenti; raramente è necessario modificare |
Uso Linee di riferimento ( #: percorso/file:line) quando la posizione è importante per significato. Uso #. per brevi, programmaticamente estratti suggerimenti e semplici # per istruzioni mirate che i traduttori devono leggere. Evitare di duplicare le informazioni su più tipi di commento; preferire un commento autorevole per voce.
Contesto di levaggio (msgctxt) per traduzioni accurate
The msgctxt campo esiste per disambiguare le stringhe di origine identiche utilizzate in diversi contesti semantici. Ad esempio, la parola inglese "Close" può significare "vicino" o "chiudere". Senza contesto, i traduttori devono indovinare, che può portare a errori nelle lingue in cui quei significati usano parole diverse.
Migliori usi di msgctxt:
- Quando la stessa stringa di origine abbigliamento negli elementi dell'interfaccia utente con funzioni diverse (ad esempio, l'etichetta del pulsante vs il testo descrittovo).
- Quando la pluralizzazione o il genere grammaticale dipende da come viene utilizzata la stringa.
- Quando token di formato esterno o markup cambia significato e deve essere conservato esattamente.
Esempio pratico (descritto): preferiscono aggiungere msgctxt come "button:close" e "label:distance-close" invece di affidarsi a commenti da soli. Questo assicura strumenti di traduzione e traduttori vedere una distinzione leggibile dalla macchina. Evitare i valori di contesto eccessivamente verbosi; tenerli brevi, coerenti e stabili attraverso le versioni.
Migliori Pratiche per Scrivere e Mantenere Commenti
Buoni commenti sono concisi, pertinenti e stabilizzanti. Perché esiste una stringa, descrivere i segnaposto e non eventuali restrizioni grammaticali. Non ripetere ciò che è già evidente dalla stringa di origine; invece, aggiunge informazioni che danno errori.
Linee guida pratiche che possono applicare immediatamente:
- Spiegare i segnaposto e la formattazione — Se una stringa contiene segnaposto come "%s" o "{name}", descrivere il loro ordine e se possono essere omessi o maturatuti.
- Dare un breve esempio di utilizzo — Esempio una-line chiariscono l'intento. Per esempio: #. Appare nella pagina delle impostazioni dell'account come un'etichetta del pulsante
- Marca parti non trasferibili — Se un marchio o un termine deve rimanere tecnico invariati, dichiararlo chiaramente nel commento.
- Mantenere i commenti stabilizzati — Quando si modifica il comportamento dell'interfaccia utente, aggiornare il commento con il nuovo contesto e includere una data o un biglietto di riferimento se utile.
- Aggiornare il programma — mantenere la lingua accessibile ai traduttori professionali; usare frasi semplici ed evitare acronimi interni a meno che non.
Quando si parla i commenti attraverso i comunicati, eseguire un passaggio rapido per rimuovere le note obsolete e i riferimenti corretti. Se una stringa viene rimossa o modificata in modo significativo, aggiorna o elimina i commenti correlati per evitare traduttori confondenti.
Consigli di collaborazione tra sviluppo e traduttori
I migliori risultati di localizzazione risultano dalla collaborazione leggera e continua. Osservazioni e contesto sono il canale di comunicazione incorporato direttamente nel flusso di lavoro di traduzione. Renderli efficaci accettando perdite e comportamenti di utensili.
Pratiche di collaborazione attuabili:
- Creare una guida stile — Determinare i prefissi, la lunghezza minima del contesto, e se includere i numeri dei biglietti. Documenta la guida in cui entrambe le squadre possono aderirervi.
- Utilizzare l'opzione — Ad esempio, i contesti prefissi con "button:", "menu:", o "error:" così i traduttori possono scansionare e dedurre l'uso rapidamente.
- Eseguire una recensione di bordo per i traduttori — Condividere una breve passeggiata attraverso i modelli di localizzazione della base di codice e i segnaposto comuni.
- Incoraggiare commenti a due vie — Consentire ai traduttori di aggiungere commenti traduttori (#) con domande o note. Rivedere questi commenti mensili e rispondere o aggiornare sorgente riflettementi.
- Automatizzare i controlli — Integrare l'inting che avverte sulle conseguenze dei segni mancanti, msgctxt vuoto in cui esiste l'ambiguità, o sottolinea inconsistenti.
Infine, il feedback dei traduttori di valore. Un commento traduttore conciso sottolineando ambiguità genuina è informazioni che si dovrebbe incorporare nella fonte per evitare problemi legati. L'obiettivo è un ciclo continuo di miglioramento in cui i commenti e il contesto si evolvono con il prodotto piuttosto che diventare annotazioni stanti.
