I progetto sono il luogo in cui vengono tenuti insieme i componenti principali di un progetto di traduzione (lavoro, memorie di traduzione e database terminologici). 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 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 accedere.
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, Seleziona un e 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 può accedere dal menu .
I progetti esistenti possono essere duplicati selezionando duplicare progetto dal menu sulla pagina . Il progetto duplicato utilizza il formato principale dell'originale. Se tale formato non supporta pluralization per impostazione predefinita, la pluralizzazione non è disponibile. Se non viene 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 di origine 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 Languages.
Si apre la scheda.
-
Fare clic su Aggiungere lingua. Si apre la finestra .
-
Dalla scheda, fornire un nome lingua e codice della lingua (impostazioni locali).
-
Dalla scheda, Seleziona una lingua di origine dall'elenco a discesa.
-
Dalla scheda, Seleziona le opzioni di revisione.
-
Clicca su Salva.
La lingua viene aggiunta a quel progetto.
Altre lingue possono essere aggiunte facendo clic su Aggiungere lingua nella scheda, e possono essere modificate dal More options
menu Selezionando
.
Frammenti di informazioni e flag possono essere archiviati nelle variabili di progetto. Le variabili sono 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 sono 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 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 dividerli 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 impostazioni locali di origine corrispondenti ai progetti Strings.
-
Creare un file di configurazione che includa le posizioni dei file di impostazioni locali di origine nel progetto e le abbini ai 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