Traduzione tecnica e IT
Manuali, specifiche, software, hardware, architetture di sistema e documentazione API.
Perché serve una traduzione specialistica
Oltre la traduzione generica
La prosa tecnica affianca spesso frasi comuni a comandi, variabili, numeri di modello e misure. I controlli di qualità segnalano queste stringhe quando cambiano, mentre i glossari mantengono coerenti in tutto il documento i nomi dei componenti e le etichette dell'interfaccia.
Nella documentazione tecnica e IT la parte difficile raramente è la prosa: è la combinazione. La frase che spiega come riavviare un servizio sta accanto al comando che lo fa, a una chiave di configurazione, a un messaggio di errore e a un numero di versione. Chi legge copia il comando e si aspetta che funzioni: la spiegazione deve cambiare lingua, mentre il codice deve restare esattamente com'era.
Il modello di DeepReference redige l'intero segmento, codice compreso, e nulla blocca il codice: comandi, segnaposto e percorsi di file non sono protetti automaticamente. I controlli di qualità segnalano tag, numeri e segnaposto modificati, e il revisore confronta ogni blocco di codice con il testo di partenza.
In questo settore il vantaggio maggiore viene dalla coerenza tra una release e l'altra. Manuali e contenuti di assistenza cambiano un poco a ogni versione. Un glossario mantiene uguali i nomi dei componenti e le etichette dell'interfaccia, la memoria di traduzione (Translator Pro) riutilizza i segmenti approvati il cui testo di partenza non è cambiato, e il confronto delle revisioni mostra esattamente quali frasi di una nuova versione DOCX sono diverse. Il tempo del revisore va così al testo nuovo.
Come funziona
Un progetto dal caricamento alla consegna
- 1
Preparare il file di partenza
Si carica il manuale o la specifica in formato DOCX, PDF, PPTX o XLSX, fino a 50 MB (75 MB con Business). La documentazione gestita in Markdown o in uno strumento di help center va prima esportata in uno di questi formati. Un PDF deve contenere testo selezionabile; una scansione composta solo da immagini viene rifiutata.
Come fare, passo per passo: 6. Document translation (in inglese)
- 2
Impostare la terminologia
Si avvia l'estrazione terminologica sul testo di partenza, oppure su una versione precedente e sulla sua traduzione, e si approvano o scartano i termini trovati. I nomi dei componenti e le etichette dell'interfaccia si aggiungono esattamente come compaiono nel software localizzato. Una base terminologica esistente si può importare in CSV, XLSX, TMX o TBX.
Come fare, passo per passo: 3. Terminology extraction (in inglese)
- 3
Tradurre con le impostazioni giuste
Si sceglie la lingua di arrivo e un tono, per esempio Tecnico. I termini approvati del glossario presenti in una frase vengono inviati al modello insieme a quella frase. Con Translator Pro, una corrispondenza esatta della memoria di traduzione viene riutilizzata invece di essere tradotta di nuovo.
Come fare, passo per passo: 5. Text translation, tones and glossary (in inglese)
- 4
Revisionare segmento per segmento
Nell'editor a segmenti il revisore vede testo di partenza e di arrivo affiancati, con le corrispondenze del glossario e le segnalazioni dei controlli di qualità. Confronta comandi, codice e segnaposto con il testo di partenza, corregge ciò che è cambiato e approva ogni segmento, oppure tutti i segmenti insieme dopo averli letti.
Come fare, passo per passo: 7. Translation Editor (in inglese)
- 5
Controllare il file consegnato
Il file torna nel formato originale, con tabelle, titoli, numerazione, intestazioni e piè di pagina conservati. Va aperto e controllato nei blocchi di codice, nelle tabelle e nelle didascalie. In un PDF i layout complessi richiedono un controllo manuale e alcuni font vengono sostituiti da uno simile.
Come fare, passo per passo: 8. Document Editor (in inglese)
- 6
Aggiornare per la release successiva
Quando arriva una nuova versione DOCX, il confronto delle revisioni mostra le modifiche al testo di partenza come redline, come DOCX con revisioni tracciate e come elenco delle modifiche. Nella modalità con traduzione, usata con la memoria di traduzione di Translator Pro, vengono ritradotti solo i segmenti interessati. Nulla viene addebitato prima della conferma.
Come fare, passo per passo: 9. Revision comparison (in inglese)
Tipi di documenti
Cosa traduciamo
- Guide utente e contenuti di assistenzaLe etichette dell'interfaccia citate nel testo devono corrispondere al software che il lettore ha aperto, altrimenti il pulsante non si trova.
- Documentazione APIEndpoint, parametri ed esempi di richiesta e risposta restano come sono; si traducono solo le descrizioni che li circondano.
- Guide di installazione e configurazioneI lettori copiano comandi, percorsi di file e chiavi di configurazione: un solo carattere cambiato rende inutilizzabile il passaggio.
- Note di rilascioBrevi e dense; deprecato, rimosso e modifica incompatibile hanno conseguenze diverse e devono restare distinti.
- Specifiche tecniche e schede tecnicheValori, tolleranze, unità e codici articolo sono il contenuto; il controllo dei numeri segnala le cifre modificate e il revisore conferma ciascuna.
- Manuali hardwareAvvertenze di sicurezza e ordine dei passaggi contano più dello stile; il revisore verifica che nessuna avvertenza o passaggio sia stato unito o omesso.
- Documenti di architetturaI nomi di componenti e servizi ricorrono molte volte; un glossario li mantiene identici dalla prima didascalia di diagramma all'ultima appendice.
- Policy e procedure di sicurezzaParole come deve, dovrebbe e può fissano livelli di obbligo, e una policy cambia significato se vengono confuse.
- Disegni tecnici e annotazioniLe annotazioni in un PDF si traducono solo se sono testo selezionabile; le etichette che fanno parte di un'immagine restano non tradotte.
- Specifiche di reteDocumenti lunghi con requisiti numerati e rimandi interni. Numerazione e titoli devono restare intatti, e parole come «shall» e «should» devono mantenere la loro diversa forza.
- Guide di installazione e messa in servizioComandi, nomi di parametri e valori compaiono all’interno delle istruzioni, e ciascuno deve corrispondere esattamente all’originale.
- Elenchi di allarmi e parametriSpesso in formato XLSX. Le descrizioni vengono tradotte e le formule restano al loro posto; il revisore verifica che codici e identificatori siano invariati.
Come fare, passo per passo: 6. Document translation (in inglese)
Controlli di qualità
Controlli integrati
Terminologia di dominio
Un glossario o termbase di dominio può aiutare a mantenere coerenti i termini approvati durante la revisione.
Come fare, passo per passo: 3. Terminology extraction (in inglese)
Controlli di formato e struttura
Struttura, numerazione, tabelle e sezioni restano visibili per i controlli del revisore.
Come fare, passo per passo: 8. Document Editor (in inglese)
Memoria di traduzione
Le traduzioni approvate possono essere riutilizzate quando ricompare un testo uguale o simile.
Come fare, passo per passo: 4. Translation memory (in inglese)
Registri di revisione
Azioni del revisore, impostazioni e timestamp di approvazione vengono registrati dove il flusso lo supporta.
Come fare, passo per passo: 7.3 Project tools (in inglese)
Filtro del glossario
Solo i termini del glossario presenti nel testo corrente vengono inviati con la richiesta di traduzione.
Come fare, passo per passo: 2.15 Use a glossary correctly (in inglese)
Impostazioni consigliate
Come impostare un lavoro in questo settore
Dominio per l'estrazione terminologica
Scegli «Tecnico» quando estrai i termini da questi documenti. Il dominio serve solo all'estrazione.
Passo per passo nella guida utente (in inglese)Glossario
Inserisci i termini approvati per questo cliente e questa coppia di lingue, una traduzione per termine, e seleziona il glossario quando traduci.
Passo per passo nella guida utente (in inglese)Esempi terminologici
Come vengono gestiti i termini
Endpoint API (API endpoint)
Percorsi come /v2/orders e metodi come GET restano come nel testo di partenza. Nulla impedisce al modello di modificarli, quindi il revisore li confronta uno per uno.
Segnaposto / variabile (placeholder / variable)
Stringhe come {user_name} o %s devono tornare invariate. Il controllo di qualità segnala un segnaposto modificato o mancante, e il revisore lo ripristina.
Autenticazione / autorizzazione (authentication / authorization)
Verifica dell'identità contro concessione dei permessi. Alcune lingue usano una sola parola comune per entrambe, perciò una voce di glossario per ciascuna le tiene distinte.
Latenza / throughput (latency / throughput)
Ritardo contro volume al secondo. Restano termini separati, e unità come ms o Mbit/s non vengono convertite.
Deprecato (deprecated)
Funziona ancora ma sarà rimosso in seguito. Non deve diventare “rimosso” od “obsoleto”; una voce di glossario fissa il termine di arrivo.
Modifica incompatibile (breaking change)
Una modifica che impedisce alle integrazioni esistenti di funzionare. Il termine di arrivo si concorda per lingua, a volte resta in inglese, e si aggiunge al glossario.
Valore predefinito (default value)
Il valore letterale (true, 30, en-GB) resta come è scritto. Il controllo dei numeri segnala le cifre modificate; parole come true le controlla il revisore.
Etichetta dell'interfaccia (UI label)
I nomi di pulsanti e menu devono corrispondere al software localizzato. Se il prodotto non è localizzato, l'etichetta resta di solito in inglese, e il glossario registra questa scelta.
Messaggio di errore (error message)
I lettori cercano il messaggio esatto mostrato dal software. Molti team mantengono il messaggio originale e aggiungono una traduzione tra parentesi; il revisore applica la regola del team.
Come fare, passo per passo: 2.4 Add terms (in inglese) · 2.15 Use a glossary correctly (in inglese)
Chi lo usa
Settori serviti
Aziende software, fornitori di servizi IT, società di ingegneria, data center, team di cybersicurezza ed enti di normazione.
Standard e riferimenti
Cosa supporta il flusso di lavoro
I revisori possono controllare comandi, percorsi di file, identificatori, frammenti di codice, unità, codici articolo e termini tecnici ripetuti.
Prima della consegna
Cosa controlla il revisore
- Comandi, blocchi di codice, percorsi di file e chiavi di configurazione sono identici al testo di partenza.
- Segnaposto e variabili come {name} o %s sono invariati e non ne manca nessuno.
- Numeri di versione, codici articolo, valori e unità corrispondono al testo di partenza; nulla è stato convertito o arrotondato.
- Le etichette dell'interfaccia corrispondono al software localizzato, o restano in inglese dove così concordato.
- Ogni segmento segnalato dai controlli di qualità è stato esaminato e risolto.
- I termini del glossario sono usati in modo coerente, anche in titoli, tabelle e didascalie.
- Avvertenze, precauzioni e ordine dei passaggi nelle procedure sono completi.
- I commenti negli esempi di codice sono tradotti o lasciati invariati, secondo la richiesta del cliente.
- Il testo nelle schermate e nei diagrammi non è tradotto; viene segnalato al cliente.
- Il file scaricato si apre correttamente; in un PDF si controllano layout complessi e font sostituiti.
Come fare, passo per passo: 7. Translation Editor (in inglese)
Trasparenza
Cosa DeepReference non fa
- Codice, comandi e segnaposto non sono protetti automaticamente. Il modello può tradurre un commento, il nome di una variabile o una parola dentro un comando. I controlli di qualità segnalano tag, numeri e segnaposto modificati, ma non ogni modifica, quindi una persona controlla ogni blocco di codice.
- I file di risorse software come JSON, YAML, PO, .strings o .resx non si possono tradurre come file. XLIFF sì: i target vuoti vengono compilati e torna lo stesso file (da Starter in su). DeepReference traduce file DOCX, PDF, PPTX, XLSX e XLIFF e testo incollato; non è uno strumento di localizzazione software.
- Unità, formati numerici e date non vengono convertiti da alcuna regola. Il risultato è ciò che ha scritto il modello, quindi è il revisore a decidere, per esempio, se 1.5 debba diventare 1,5 in italiano.
- Il testo all'interno delle immagini, come schermate e disegni salvati come immagini, non viene tradotto. Un PDF scansionato composto solo da immagini viene rifiutato; si carica il file originale o un PDF con testo selezionabile.
- Non esiste un collegamento a repository Git o a piattaforme di help center. I file entrano ed escono tramite caricamento, oppure tramite l'API REST con Business.
- Non esiste un modello separato per contenuti tecnici o IT, e DeepReference non fornisce traduttori né revisori tecnici. L'impostazione del dominio guida solo l'estrazione terminologica.
Domande
Domande frequenti
I blocchi di codice tornano invariati?
Non automaticamente. Il modello traduce l'intero segmento, codice compreso, e nulla blocca il codice. I controlli di qualità segnalano tag, numeri e segnaposto modificati, ma una persona deve comunque confrontare ogni blocco di codice e ogni comando con il testo di partenza.
Si possono caricare file JSON, PO o XLIFF del nostro software?
XLIFF sì (1.2 e 2.0, da Starter in su): i target vuoti vengono compilati e torna lo stesso file. JSON e PO no. I file traducibili sono DOCX, PDF, PPTX, XLSX e XLIFF, fino a 50 MB (75 MB con Business), oltre al testo incollato fino a 100.000 caratteri. La documentazione gestita in Markdown o in uno strumento di help center va prima esportata in uno di questi formati.
La documentazione di prodotti non ancora rilasciati viene inviata a una società di IA esterna?
No. Il modello funziona sui server di DeepReference nell'UE, e nessuna società di IA esterna vede il testo. I contenuti dei clienti non vengono mai usati per addestrare il modello. I caricamenti vengono cifrati nel browser prima dell'invio e i file archiviati sono cifrati a riposo; si tratta di cifratura tra il browser e i server di DeepReference.
Esiste un modello separato per contenuti tecnici e IT?
No. Un solo modello traduce tutti i settori. Il tono Tecnico cambia il registro del risultato, il glossario fornisce i termini approvati e l'impostazione del dominio guida solo l'estrazione terminologica. Non cambia il modo in cui il modello traduce.
Come si gestisce una nuova versione di un manuale?
Se entrambe le versioni sono DOCX, il confronto delle revisioni (da Freelance in su) mostra le modifiche al testo di partenza come redline, come DOCX con revisioni tracciate e come elenco delle modifiche. Nella modalità con traduzione, con la memoria di traduzione di Translator Pro, vengono ritradotti solo i segmenti interessati dalla revisione. Nulla viene addebitato prima della conferma.
DeepReference si può collegare alla nostra pipeline di build o di documentazione?
Con Business è disponibile un'API REST con chiavi API, quindi i propri script possono richiedere traduzioni. Non esistono connettori pronti per Git o per piattaforme di help center, e anche il risultato dell'API richiede la stessa revisione umana.
Quadro di revisione
Apri la piattaforma dalla dashboard quando sei pronto a lavorare sui file.
Vedi la documentazione sulla qualitàAvvia i progetti: Traduzione tecnica e IT
Apri la piattaforma dalla dashboard quando sei pronto a lavorare sui file.