Frammento di Codice per i Controlli QA Personalizzati

I controlli di assicurazione della qualità (QA) personalizzati aiutano i clienti e i traduttori a correggere errori di ortografia, punteggiatura, terminologia, formattazione e altro. Il Frammento di Codice è un pezzo di codice che aiuta a creare controlli QA personalizzati e integrarli a Crowdin.

Parametri del Frammento di Codice

Il Frammento di Codice è basato su JavaScript. Include un oggetto crowdin e un numero di proprietà. Per creare il frammento di codice, usa questo modello dell’oggetto per l’inserimento del codice:

object crowdin {
 object file {
   string name,
   string fullName,
   string branch,
   string type
 }
 string sourceLanguage,
 string targetLanguage,
 object context {
   ?int maxLength,
   ?string pluralForm
 },
 string contentType,
 string source,
 string translation
}

Trova l’esempio di un frammento di codice del controllo QA personalizzato nell’Editor Script di Crowdin. Usa il link per vedere la struttura del frammento di codice, modificalo con i tuoi dati e verifica che il tuo codice sia corretto.

Richiesta Frammento di Codice

La richiesta del frammento di codice include le chiavi sotto elencate:

  1. file.name – nome del file sorgente
  2. file.fullName – percorso completo al file sorgente nel progetto (ramo escluso se presente)
  3. file.branch – nome del ramo in cui è memorizzato il file sorgente
  4. file.type – tipo di file sorgente
  5. sourceLanguageCodice di Crowdin per la lingua sorgente del progetto
  6. targetLanguageCodice di Crowdin per la lingua di destinazione del progetto
  7. source – testo sorgente
  8. translation – stringa tradotta
  9. context.maxLength – lunghezza massima della stringa tradotta
  10. context.pluralForm – pluralForm indica quale forma plurale sta venendo tradotta al momento
  11. contentType – La stringa può includere uno dei 3 tipi:

    • testo/semplice
    • application/vnd.crowdin.text+plural
    • application/vnd.crowdin.text+icu

Dai un’occhiata all’esempio della richiesta del frammento di codice:

{
   "file": {
     "name": "strings.json",
     "fullName": "backend/strings.json",
     "branch": "master",
     "type": "json"
   }
   "sourceLanguage": 'en',
   "targetLanguage": 'de',
   "context": {
       "pluralForm": 'one',
   },
   "contentType": 'application/vnd.crowdin.text+plural',
   "source": '{"one":"Password", "other":"Passwords"}',
   "translation": 'das Passwort '
}

Risposta del Frammento di Codice

Dopo aver eseguito il frammento di codice, dovrebbe restituire la risposta, che i controlli QA personalizzati siano riusciti o meno:

  • L’oggetto di risposta dovrebbe contenere la proprietà success booleana indicante se i controlli QA siano riusciti. Ad esempio:
{
  "success": true
}
  • Nel caso in cui i controlli QA siano falliti, il “messaggio” della proprietà sarà mostrato al traduttore. Per esempio:
{
  "success": false,
  "message": "La frase inizia con uno spazio, sei pregato di rimuovere 1 spazio all'inizio della traduzione.",
  "fixes": [
     {
          "from_pos": 0,
          "to_pos": 1,
          "replacement": ""
     }
  ]
} 
  • I controlli QA di Crowdin possono anche restituire gli errori e le istruzioni automatiche di correzione all’editor. Se possibile, si consiglia di includere la proprietà fixes (un insieme di oggetti) poiché può risparmiare molto tempo e sforzi per i traduttori.
{
     "from_pos": 0,
     "to_pos": 1,
     "replacement": ""
}

from_pos è una posizione del carattere nella stringa di translation dove inizia la sostituzione. to_pos è la fine della posizione del carattere. La proprietà replacement è il testo che dovrebbe esser posto tra from_pos e to_pos.

Vedi Anche

Questo articolo è stato utile?