Miért veszíti el a DOCX fordítás vastagságát? Először tartsa meg a futást, majd beszéljen a teljes szakasz cseréjéről.

A DOCX félkövér és a dőlt betű elveszett a fordítás után? Valószínűleg az a probléma, hogy az egész szakaszt kicserélik, és a futást elmossák. Ez a cikk a python-docx használatával menti egyenként a futtatási formátumot, majd a mentés után olvassa el újra és fogadja el. Ha bonyolult szerkezettel találkozik, vagy a szegmens nem egyezik, akkor közvetlenül megtagadja a cserét.

A DOCX fordítás után a vastagság, a dőlt betűk és a betűméret elvesznek. A gyakori ok az, hogy a bekezdés tartalmát közvetlenül a teljes szöveg helyettesíti, ami elmossa az eredeti futási szintű formátumot. Miután sok csapat megkapta a fordítást, gyakori reakció az, hogy a Word-ből hiányzik a kiemelés formátuma. Ez a cikk azoknak a fejlesztőknek szól, akik a python-docx-ot használják a DOCX feldolgozásához, valamint azoknak a szerkesztőknek, akiknek kétnyelvű dokumentumokat kell kézbesíteniük.

Úgy tűnik, hogy egy bekezdés csak egy mondatot tartalmaz a Wordben, de a DOCX-ben több lefutásból is állhat: közönséges szövegből, kiemelt szövegből, betűméret-módosításokból, valamint hiperhivatkozásokból és egyéb struktúrákból, amelyek nem tartoznak a szokásos futtatási listához. Ennek elolvasása után tudni fogja, hogy általában hol van a probléma, hogyan kell visszaírni a futtatással futtatott fordításokat, és mikor kell elutasítani az automatikus cserét.

Mi a teendő, ha a DOCX formátuma a fordítás után elveszett? Egy mondatos következtetés

Először korlátozza a feldolgozást csak a szokásos szöveges futási bekezdésekre, írja vissza egyenként a fordítást az eredeti futási sorszám szerint, mentse el és olvassa el újra elfogadásra; Ha bonyolult szerkezettel találkozik, vagy a szegmens nem egyezik, közvetlenül utasítsa el a cserét.

a helyzetedAjánlott gyakorlatokok
A bekezdésekben csak normál szöveg futÍrja vissza egyenként a fordításokat a futási sorszám szerintAz egyes futtatások formátumhatárai megmaradnak
A bekezdések hiperhivatkozásokat, képeket, mezőket, sortöréseket vagy tabulátorokat tartalmaznakKifejezetten megtagadni és speciális eljárásra átvinniA kód nem csendesíti el ezeket az elemeket
A fordítási szegmensek száma vagy sorrendje nem egyeztethető össze az eredeti futtatássalAhelyett, hogy belevágna a meglévő futásokba, használjon újraformázási stratégiákat vagy manuális felülvizsgálatotA kényszerített levelezés megzavarja a formátumot
Meg kell erősíteni a visszaírás eredményétMentés után nyissa meg újra a fájlt, és fogadja el.Kerülje csak a memóriában lévő objektumok ellenőrzését
Közvetlenül hozzárendelhet értéket a paragraph.text-hezKerüld a használatátA bekezdés meglévő tartalma új szöveggel lesz helyettesítve, és a futási szintű formázás nem marad meg automatikusan.

Hol a probléma: A teljes bekezdés lecserélése kimossa a futtatási formátumot

A paragraph.text érték közvetlen hozzárendelése a bekezdés meglévő tartalmát új szövegre cseréli. A bekezdésszintű stílusok megtarthatók, de az eredeti futási szintű formázás nem marad meg automatikusan. Ezt a viselkedést kifejezetten dokumentálja a python-docx szöveges API.

A fordítás eredménye pontosnak tűnik, de a formátum teljesen eltűnt. Valószínűleg ez az oka.

Alkalmazási terület: A formátum megmaradt, de ez nem jelenti azt, hogy más problémák is megoldódtak.

A cikk tesztrekordjai helyben szintetizált DOCX-ből származnak, nem a szedésmotor képernyőképeiből. Amit megold, az a "korlátozott csere a formátum elvesztése nélkül". Nem oldja meg automatikusan a nyelvek közötti szintaxis átrendezéseket, és azt sem biztosítja, hogy a lapozás változatlan maradjon a fordítás után.

Először korlátozza a biztonságosan módosítható tartományt

Ez a sűrített példa csak az egyszerű szövegből álló bekezdéseket fogadja el. Ha egy bekezdés hiperhivatkozásokat, képeket, mezőket, sortöréseket, tabulátorokat vagy egyéb összetett XML-csomópontokat tartalmaz, kifejezetten utasítsa el, és irányítsa át a hívót egy speciális folyamatra. A kód nem simítja ezeket az elemeket csendben.

A fordítási bemenet nem egy tetszőleges karakterlánclista: minden eredménynek rendelkeznie kell az eredeti futás sorozatszámával, és a számnak, sorrendnek és típusnak meg kell egyeznie a módosítás megkezdése előtt. Az érvényesítés az írás előtt történik, hogy elkerülje a következő mezőkkel kapcsolatos problémák felfedezését a félidőben történő frissítés után.

Egy minimális teszt, amely többször is futtatható

A tesztkörnyezet a python-docx==1.2.0. Az angol itt kézzel írt, fix referenciakódokból származik, amelyeket struktúrák ellenőrzésére használnak, gépi fordítás nélkül.

from docx import Document
from docx.oxml.ns import qn

def replace_plain_runs(paragraph, translated):
    if any(child.tag not in {qn("w:pPr"), qn("w:r")}
           for child in paragraph._p):
        raise ValueError("paragraph contains unsupported structures")
    runs = paragraph.runs
    for run in runs:
        if any(child.tag not in {qn("w:rPr"), qn("w:t")}
               for child in run._r):
            raise ValueError("run contains a field, image or control")
    if len(translated) != len(runs):
        raise ValueError("segment count mismatch")
    for index, item in enumerate(translated):
        if (not isinstance(item, dict) or item.get("id") != index
                or not isinstance(item.get("text"), str)
                or any(ch in item["text"] for ch in "\t\r\n")):
            raise ValueError("segment identity or text mismatch")
    for run, item in zip(runs, translated):
        run.text = item["text"]

def signature(paragraph):
    return [(r.text, r.bold, r.italic) for r in paragraph.runs]

doc = Document()
p = doc.add_paragraph()
p.add_run("请在 ")
p.add_run("周五之前").bold = True
p.add_run(" 提交报告。")
before = signature(p)
try:
    replace_plain_runs(p, [{"id": 0, "text": "Incomplete"}])
    raise AssertionError("bad segments accepted")
except ValueError:
    assert signature(p) == before

replace_plain_runs(p, [
    {"id": 0, "text": "Submit the report "},
    {"id": 1, "text": "before Friday"},
    {"id": 2, "text": "."},
])
doc.save("translated-runs.docx")
restored = Document("translated-runs.docx").paragraphs[0]
assert restored.text == "Submit the report before Friday."
assert restored.runs[1].bold is True
assert len(restored.runs) == 3
complex_p = doc.add_paragraph("keep")
complex_p.runs[0].add_break()
try:
    replace_plain_runs(complex_p, [{"id": 0, "text": "reject"}])
    raise AssertionError("line break accepted")
except ValueError:
    assert complex_p.text == "keep\n"
print("PASS count mismatch: no partial write")
print("PASS save/reopen: 3 runs, emphasis preserved")
print("PASS unsupported control: rejected")
print(signature(restored))

Mentés után nyissa meg újra a translated-runs.docx-t elfogadásra, elkerülve a memória objektumainak ellenőrzését.

Miért ne rendelnénk minden futást külön a fordítóhoz?

A run formátumhatár, nem szemantikai határ. A Word szerkesztési előzményei akár több futásra is bonthatnak egy szót. Az egyes fordítások egyenként történő elkülönítése elveszíti a kontextust; Különböző nyelvekben a szórend a mondat elejére vagy végére is áthelyezheti a hangsúlyt.

A tényleges fordítás generálása teljes mondatokban és bekezdésekben adja meg a kontextust, majd visszaadja az érvényesített, strukturált bekezdéseket. Ha a visszaadott eredmény nem ugyanolyan hosszú, mint az eredeti, ne kényszerítse rá a meglévő futtatásba; világos átrendezési stratégia vagy kézi felülvizsgálat szükséges. A cikkben szereplő egyszerű példa csak három töredéket tartalmazhat, de ezt nem lehet általánosítani minden olyan nyelvre, amely egyenként leképezi.

Az elfogadás három rétegre bontása

SzintekEllenőrizze a tartalmatLefedett ez a cikk?
AdatszerkezetFuttatások száma, sorrend, félkövér aláírások, valamint mentési és visszaállítási műveletekFedezze le ezt a korlátozott példát
Szemantikai tartalomKifejezések, negatív szavak, dátumok, összegek, kihagyásokNincs lefedettség; Független korrektúra szükséges
Vizuális elrendezésBetűtípus visszaállítások, sortörések, oldalszámok, táblázat túlcsordulásaNincs lefedettség; További vizsgálathoz renderelés szükséges

A _p és _r belső tulajdonságok, amelyeket itt használnak XML ellenőrzésére. Python-docx frissítésekor javítani kell a verziót és újra futtatni a teszteket; nem feltételezheted, hogy a belső struktúra soha nem változik. Táblázatok, fejlécek, láblécek, szövegdobozok és átdolgozó nyomok kezelésekor a tartalmi tartományokat is külön kell felsorolni, mert a document.paragraphs nem reprezentálja a dokumentum teljes szövegét.

Megállási feltételek szállítás előtt

Nem támogatott struktúrák, szegmenseltérések, hiányzó betűtípusok, fontos mezők változásai – bármelyik blokkolja az automatikus kézbesítést. Az eredeti fájl csak olvashatóként mentése, a fordítás írása az új fájlba, valamint a nyelv, feldolgozási verzió és kézi elfogadási rekordok csatolása – ez még a minőséget is jobban mutatja, mint a "sikeres mentés".

Ha a fordítási és átnézési folyamatot dokumentumok feltöltésével kell elkezdenie, ellenőrizze a OmniDoc termékbejegyzés-t. A cikkben szereplő kódpéldák független, nyílt forráskódú könyvtári oktatóanyagok, és nem tükrözik az OmniDoc importáló vagy elrendezési motorjának jelenlegi megvalósítását. Csak egy alapelv van: a formátumot elfogadandó adatként kezelni, ne pedig fordítás utáni bónuszként.

📊 Alap összehasonlítás

MódszerFő kockázatokA cikkben adott tanácsok
Érték hozzárendelése közvetlenül a paragraph.text-hezA futásszintű formázás nem marad meg automatikusanNem használják olyan bekezdésekhez, amelyek formázás megőrzését igénylik
Futtasd le az árva fordításokat egyenkéntA kontextus elvesztése és a szórend megváltoztatása elmozdíthatja a kiemelt részeketTeljes mondatokban adj kontextust
A teljes mondat fordítása után írja vissza a futás-ellenőrző összeggelHa a visszaadott eredmény hossza nem egyezik meg az eredeti futtatással, a kemény illesztés nem végezhető elEhelyett alkalmazz átrendezési stratégiákat vagy kézi felülvizsgálatot

🎯 Melyik megközelítés illik hozzád?

Ha a bekezdésed csak egyszerű szöveget tartalmaz, futtasd

A cikk legkisebb példája alapján először ellenőrizd a sorozatszámot, mennyiséget, sorozatot és típust, majd írd vissza az egyes elemeket, mentsd el, és olvasd el újra az elfogadáshoz.

Ha a bekezdésed hivatkozásokat, domaineket vagy képeket tartalmaz

Közvetlenül utasítsa el az automatikus cserét, és helyezze át egy dedikált feldolgozási folyamatba. A kódex nem csendben simítja le ezeket a szerkezeteket.

Ha formális, kétnyelvű dokumentumokat kell kézbesítenie

Mentse el az eredeti fájlt csak olvashatóként, írja meg a fordítást az új fájlba, és csatolja a nyelvet, feldolgozási verziót és kézi elfogadási rekordokat. Olyan helyzeteket, mint a hiányzó betűtípusok, a fontos mezők változása vagy az össze nem illő szegmensek mind blokkolhatók az automatikus kézbesítésből.

❓ Gyakran ismételt kérdések (GYIK)

1. Mi a paragraph.text definíciója?

Igen. A bekezdésszintű stílusok megőrizhetők, de az eredeti futásszintű formázás nem marad meg automatikusan.

2. Miért ne rendelhetnénk minden futást külön a fordítóhoz?

A run formázási határ, nem szemantikai határ. A fordítások egyenként történő elkülönítése elveszítheti a kontextust, és a különböző nyelveken a hangsúlyos részek a mondatok elejére vagy végére tolhatók.

3. A sikeres mentés azt jelenti, hogy a formátum helyes?

Nem. Mentés után nyissa meg újra a fájlt az adatstruktúra elfogadásához; A szemantikai tartalmat és a vizuális elrendezést is külön kell ellenőrizni.

4. Mire kell figyelni a python-docx frissítésekor?

A kód a _p és _r belső tulajdonságait használja, ezért javítani kell a verziót és újra futtatni a teszteket; nem feltételezheted, hogy a belső struktúra soha nem fog megváltozni.

📝 Összefoglaló

Csak egy alapelv van: a formátumot elfogadandó adatként kezelni, ne pedig fordítás utáni bónuszként. A cikkben szereplő kódpéldák független, nyílt forráskódú könyvtári oktatóanyagok, és nem tükrözik az OmniDoc importáló vagy elrendezési motorjának jelenlegi megvalósítását.

Próbáld ki most: Töltsd fel a dokumentumodat a fordítás megkezdéséhez, megőrizve az eredeti formázást

Frissítve: 2026-11-17