I progetti sono il luogo in cui i componenti principali di un progetto di traduzione (lavori, memorie di traduzione e database terminologici) vengono tenuti insieme. Prima che i file possano essere assegnati per la traduzione come lavoro, devono essere assegnati a e contenuti all'interno di un progetto.
I progetti assegnati sono elencati nella scheda sulla pagina del profilo e possono essere filtrati per spazio.
A seconda della struttura del Team, i progetti possono essere definiti per prodotto o per piattaforma. Usare un singolo progetto se tutti i membri del Team richiedono l'accesso.
L'apertura di un progetto lo presenta in una pagina progetto.
Dalla pagina progetto, tutti i dettagli del progetto possono essere visualizzati e modificati. Vengono presentati anche tutti i commenti, i tag, le chiavi e i caricamenti.
Per creare un progetto, seguire questi passaggi:
-
Dalla pagina , fare clic su Nuovo progetto.
Si apre la finestra .
-
Fornire un nome per il progetto.
-
Dagli elenchi a discesa, selezionare un e una dagli elenchi a discesa.
-
Fornire un dall'elenco a discesa.
-
Clicca su Salva.
Il progetto viene aggiunto al profilo.
Queste impostazioni (ovvero il nome del progetto, il formato principale o il punto di contatto) possono essere modificate nella scheda delle a cui si accede dal menu .
I progetti esistenti possono essere duplicati selezionando Duplicare progetto dal menu nella pagina . Il progetto duplicato usa il formato file principale dell'originale. Se tale formato non supporta pluralizzazione per impostazione predefinita, la pluralizzazione non è disponibile. Se non è definito alcun formato principale, viene utilizzato il formato .CSV per impostazione predefinita, con la pluralizzazione disabilitata.
La definizione minima per un progetto sono la lingua di origine e la lingua di destinazione. Queste sono la lingua originale dei testi e le lingue in cui verranno tradotti e sono inizialmente definite nella configurazione del progetto.
Per configurare ulteriori lingue, seguire questi passaggi:
-
Passare il mouse su un progetto e fare clic su Lingue.
Si apre la scheda .
-
Fare clic su Aggiungere lingua. Si apre la finestra .
-
Dalla scheda , fornire un nome lingua e un codice della lingua (impostazioni locali).
-
Dalla scheda , selezionare una lingua di origine dall'elenco a discesa.
-
Dalla scheda , selezionare le opzioni di revisione.
-
Clicca su Salva.
La lingua viene aggiunta a quel progetto.
È possibile aggiungere altre lingue facendo clic su Aggiungere lingua nella scheda e modificarle dal menu Altre opzioni
selezionando
.
Frammenti di informazioni e flag possono essere archiviati nelle variabili di progetto. Le variabili vengono impostate e possono essere gestite tramite il centro di traduzione e l'API. Le integrazioni possono usare le variabili di progetto per configurare i flussi di lavoro o attivare comportamenti specificati.
Le variabili vengono solitamente accessibili negli script tramite l'API. Come le variabili d'ambiente, il valore di una variabile di progetto è rappresentato come una stringa, quindi il tipo deve essere specificato (ad es. booleano, intero).
Esempio 1
-
Un cliente ha diversi tipi di progetto (marketing e prodotto). Impostano la variabile
content_type: marketing. -
Lo script di integrazione legge la variabile per decidere come procedere con quel progetto (ad es. inviarlo attraverso diversi controlli di QA).
Esempio 2
-
Un cliente lavora con Phrase Strings e un CMS. Aggiungono la variabile
template_id: 8734-ABCD. -
Lo script di integrazione legge la variabile e recupera il modello corretto dal CMS durante la pubblicazione del contenuto localizzato.
Le variabili possono essere impostate solo dagli amministratori e sono definite nella scheda della finestra .
Per impostare una variabile, seguire questi passaggi:
-
Da una pagina del progetto, aprire la finestra dall'elenco a discesa .
-
Aprire la scheda .
-
Fornire un nome per la variabile e un valore.
Idealmente, i nomi dovrebbero essere simili alle variabili d'ambiente come
MY_VARe devono essere univoci per progetto. -
Fare clic su Aggiungere variabile per aggiungere altre variabili e fare clic sull'icona
per rimuoverle.
-
Clicca su Salva.
La finestra si chiude e le variabili vengono salvate.
Man mano che i progetti software crescono e diventano più complessi, è utile suddividerli in moduli per mantenere le cose gestibili. Limitare l'ambito dei progetti dividendo le traduzioni in categorie più piccole come frontend e backend può aiutare in questa gestione.
Esempio di flusso di lavoro di manutenzione
-
Creare progetti Strings. Come da esempio, progetto Frontend e progetto Backend.
-
Creare file di origine impostazioni locali corrispondenti ai progetti Strings.
-
Creare un file di configurazione che includa le posizioni dei file di origine impostazioni locali nel progetto e creare una corrispondenza con i progetti Strings corrispondenti:
phrase: access_token: "3d7e6598d955bfcabaf1b9459df5692ac4c28a17793" file_format: yml push: sources: # frontend - file: ./path/to/locales/frontend/en.yml project_id: "5c05692a2a995c0c45c0c3cbfcab1" params: locale_id: "159d48e76802f789d9b8fb6d368e61bc" # backend - file: ./path/to/locales/backend/en.yml project_id: "0c45c0c3cbfcab15c05692a2a995c" params: locale_id: "fb6d368e61bc159d48e76802f789d9b8" pull: targets: # frontend - file: ./path/to/locales/frontend/<locale_name>.yml project_id: "5c05692a2a995c0c45c0c3cbfcab1" # backend - file: ./path/to/locales/backend/<locale_name>.yml project_id: "0c45c0c3cbfcab15c05692a2a995c"
Fornire una configurazione tramite il flag --config
Per impostazione predefinita, la CLI tenterà di usare un file chiamato .phrase.yml allo stesso livello in cui viene eseguito Phrase. Per supportare flussi di lavoro più complessi, usare più file di configurazione per scopi diversi.
Per forzare la CLI a usare un file di configurazione per determinati comandi, fornire il file .yml corrispondente tramite il flag --config:
$ phrase push --config ./path/to/config.yml