Il glossario non è una ricerca e sostituzione: definisci prima i confini delle parole, i casi e le eccezioni

Potrebbe sembrare che un glossario stia semplicemente scambiando una parola con un'altra, ma in pratica i confini delle parole, le maiuscole, le inflessioni e gli identificatori del codice influenzano tutti i risultati. Se non viene maneggiato bene, potrebbe essere sostituito per errore, oppure potrebbe non essere individuato il punto in cui dovrebbe essere sostituito.

Questo articolo è rivolto a redattori e sviluppatori che necessitano di mantenere la terminologia per traduzioni o documentazione. Di seguito viene utilizzata la libreria standard Python per scrivere un esempio di verifica conservativa, fornisce una lista di controllo di accettazione e spiega come verificare la traduzione con la funzione terminologica di OmniDoc. Dopo averlo letto, puoi decidere quali parole dovrebbero essere candidate, quali dovrebbero essere protette e come trasformare il glossario in una convenzione che il team può controllare.

L'esempio è dimostrato utilizzando campioni sintetici. Il codice è stato controllato in un ambiente isolato, ma ciò non rappresenta una garanzia di tutti i file autentici o delle prestazioni del prodotto. Prima di elaborare documenti importanti, conservare gli originali e rivederli rispettando i limiti e gli elementi di accettazione riportati di seguito.

Come sostituire il glossario senza commettere errori? Conclusione di una frase

Trova prima i candidati e poi decidi se sostituirli in base al glossario e al contesto. Non eseguire direttamente una ricerca e sostituzione globale.

Ogni lingua richiede la propria convenzione di corrispondenza

Questo articolo fornisce un esempio inglese deliberatamente conservatore: API da solo ignora la corrispondenza tra maiuscole e minuscole e lettere, numeri e caratteri di sottolineatura non corrispondono se adiacenti. L'esempio è implementato utilizzando la libreria standard Python re.

Si noti che questa convenzione non è una regola completa di segmentazione delle parole per le lingue naturali, né si occupa della disambiguazione del plurale, del possessivo o del contesto.

Prova con stringhe vicine ma che non dovrebbero colpire

Durante il test, non solo guardare cosa dovrebbe colpire, ma anche inserire stringhe vicine ma non dovrebbero colpire, come APIs e api_gateway.

import re

def english_candidates(text, term):
    if not term:
        raise ValueError("empty term")
    pattern = re.compile(r"(?<!\w)" + re.escape(term) + r"(?!\w)", re.IGNORECASE)
    return [(m.start(), m.end(), m.group()) for m in pattern.finditer(text)]

text = "API and api; APIs, rapid, api_gateway."
found = english_candidates(text, "API")
assert [item[2] for item in found] == ["API", "api"]
assert all(text[start:end] == raw for start, end, raw in found)
assert english_candidates("api_gateway", "API") == []
assert english_candidates("APIs", "API") == []
assert english_candidates("(API)", "API")[0][2] == "API"
try:
    english_candidates(text, "")
except ValueError:
    pass
else:
    raise AssertionError("empty glossary term accepted")

Il candidato corrispondente non è un comando sostitutivo

Il codice conserva la posizione e il testo originale e non modifica direttamente il testo. In questo modo il revisore può distinguere il testo, i collegamenti e le aree di codice e può anche vedere se è opportuno mantenere le parole originali.

Anche le posizioni candidate in HTML o Word devono essere mappate sui nodi della struttura. Non puoi semplicemente prendere la posizione dell'intera stringa giuntata e riscriverla nel testo originale.

La sensibilità a maiuscole e le maiuscole ha dei confini

Le abitudini di caso e linguaggio Unicode non sono sempre uno a uno. Questo articolo si concentra su termini semplici inglesi e non può essere generalizzato come un riconoscimento di termini applicabile a tutte le lingue.

I glossari grandi devono anche affrontare candidati sovrapposti, corrispondenze più lunghe e problemi di gestione delle versioni per evitare di creare ripetutamente suggerimenti contrastanti nello stesso paragrafo.

📊 Confronto tra i nuclei

Rendere il glossario una convenzione verificabile

Il sito ufficiale di OmniDoc (Voce prodotto) introduce la funzione glossario. Durante la valutazione, puoi selezionare campioni anonimizzati contenenti testo del corpo, identificatori di codice e modifiche alla forma delle parole, e confrontarli con la traduzione per verificare se la terminologia rientra nel contesto corretto.

Il valore del glossario non è sostituire meccanicamente più parole, ma rendere più stabili le convenzioni di formulazione del team.

🎯 Quale metodo ti si addice?

Se ......

• Documenti che devono essere gestiti con identificatori di codice: proteggere prima l'area del codice, poi esaminare i candidati.
• Termini con modifiche alla forma delle parole: Mantieni in anticipo le regole della forma delle parole e non aspettarti che le partite indipendenti sovrascrivano APIs.
• Gestire la terminologia cinese: Non applicare le regole di confine delle parole inglesi; utilizzare invece la segmentazione delle parole o regole adatte al cinese.
• Term book di grandi dimensioni: devono anche gestire candidati sovrapposti, corrispondenze più lunghe e gestione delle versioni.

❓ Domande Frequenti (FAQ)

1. Perché l'abbinamento dei glossari non può essere sostituito direttamente a livello globale?

Perché le parole contenenti la stessa lettera non devono necessariamente essere sostituite. Ad esempio, APIs è un'inflessione di parola, mentre api_gateway può essere un identificatore di codice.

2. Questo esempio può gestire forme plurali e possessive?

No. È un esempio deliberatamente conservatore di inglese, non responsabile del plurale, possessivo o della disambiguazione.

3. Le posizioni dei candidati possono essere scritte direttamente nell'intero testo?

Le posizioni candidate in HTML o Word devono essere mappate prima ai nodi di struttura; non puoi semplicemente scrivere le posizioni dell'intera stringa concatenata.

4. A cosa dovresti prestare attenzione nei glossari grandi?

È necessario affrontare candidati sovrapposti, il matching più lungo e la gestione delle versioni per evitare di generare ripetutamente suggerimenti contrastanti nello stesso paragrafo.

📝 Riassunto

Il valore del glossario risiede nel rendere la formulazione del team più stabile. Durante la valutazione, confrontare il campione desensibilizzato con la traduzione è più affidabile rispetto alla sostituzione diretta.

Esperienza ora: carica il tuo documento per iniziare a tradurre, mantenendo la formattazione originale