ওয়ার্ড টেক্সট অনুবাদ করতে কোন সমস্যা নেই, তবে হেডারটি এখনও আসল লেখা।

যখন হেডার অনুবাদগুলি মিস করা হয়, তখন সমস্যাটি সাধারণত is_linked_to_previous এর উত্তরাধিকার প্রক্রিয়ার সাথে থাকে। আপনি যদি বহু-অধ্যায় ওয়ার্ড ডকুমেন্টগুলি ব্যাচ করার জন্য পাইথন ব্যবহার করেন, তবে মূল পাঠ্যটি অনুবাদ করা হয়, কিন্তু শিরোনামটি এখনও মূল পাঠ্য, বা স্ক্রিপ্টটি শিরোনামটি লিখে যা বারবার বিষয়বস্তু হিসাবে উত্তরাধিকার সূত্রে পাওয়া উচিত, এই নিবন্ধটি আপনাকে কারণটি সনাক্ত করতে সহায়তা করতে পারে।

নীচেরটি ব্যাখ্যা করবে কেন হেডারটি "আগের বিভাগে লিঙ্ক করে", লেআউটটি ধ্বংস না করে কীভাবে লিঙ্কটি সনাক্ত করতে এবং ভাঙতে হয় এবং একের পর এক চেক করা যেতে পারে এমন একটি গ্রহণযোগ্যতার মানদণ্ড দেয়। এটি পড়ার পরে, আপনি নির্ধারণ করতে সক্ষম হবেন কোন শিরোনামগুলি অনুবাদ করা উচিত, কোনটি এড়িয়ে যাওয়া উচিত এবং ডেলিভারির আগে কী ম্যানুয়ালি চেক করা দরকার৷

কেন হেডার অনুবাদ এখনও মূল লেখা? এক বাক্যে উপসংহার

শুধুমাত্র স্বাধীনভাবে সংজ্ঞায়িত শিরোনামগুলি অনুবাদ করা হয়, এবং লিঙ্কযুক্ত শিরোনামগুলি এড়িয়ে যায়; যখন একটি ভিন্ন অনুবাদ সত্যিই প্রয়োজন হয়, প্রথমে লিঙ্কটি সংযোগ বিচ্ছিন্ন করুন এবং তারপরে লিখুন।

কেন হেডার অনুবাদ সবসময় অনুপস্থিত বা পুনরাবৃত্তি হয়?

মাল্টি-চ্যাপ্টার ওয়ার্ড ডকুমেন্টের সাথে কাজ করার সময় দুটি সাধারণ ব্যর্থতা রয়েছে। একটি হল মূল পাঠ্যটি টার্গেট ভাষায় অনুবাদ করা হয়েছে এবং শিরোনাম এবং পাদচরণ এখনও মূল পাঠ্য। অন্যটি আরও সমস্যাযুক্ত: পূর্ববর্তী পরিস্থিতি ঠিক করার জন্য, স্ক্রিপ্টটি সমস্ত বিভাগের হেডার অবজেক্টগুলিকে অতিক্রম করতে এবং সেগুলি অনুবাদ করতে বাধ্য হয়৷ ফলস্বরূপ, পৃষ্ঠাটি মূলত "আগের বিভাগের মতোই" হিসাবে ডিজাইন করা হয়েছে অপ্রয়োজনীয় বিষয়বস্তু লিখিত, যা মূল নথির বিন্যাস উত্তরাধিকার যুক্তিকে ধ্বংস করে।

ওসিআর বা এনএমটি ইঞ্জিনের কারণে কোনো সমস্যা হয় না, কিন্তু OpenXML-এ is_linked_to_previous বৈশিষ্ট্যের পক্ষপাতদুষ্ট বোঝার কারণে।

python-docx এবং অন্তর্নিহিত XML কাঠামোতে, শিরোনাম প্রতিটি পৃষ্ঠায় একটি স্বাধীন সত্তা নয়, কিন্তু বিভাগে মাউন্ট করা একটি বস্তু। যখন একটি বিভাগের শিরোনাম "পূর্ববর্তী বিভাগের লিঙ্ক" অবস্থায় থাকে, তখন এটিতে একটি পাঠ্য সংজ্ঞা থাকে না, তবে শুধুমাত্র পূর্ববর্তী বৈধ শিরোনামের একটি রেফারেন্স ধারণ করে। এই সময়ে, যদি হেডারের অনুচ্ছেদ পাঠ্য সরাসরি পড়া হয়, যা পড়া হয় তা উত্তরাধিকারসূত্রে প্রাপ্ত বিষয়বস্তু হতে পারে; যদি অনুবাদটি বিচার ছাড়াই লেখা হয়, একটি নতুন শিরোনাম সংজ্ঞা অন্তর্নিহিতভাবে তৈরি করা হবে, মূল উত্তরাধিকার শৃঙ্খলটি কেটে ফেলবে। এটি কেবল অনুবাদের সংস্থানই নষ্ট করে না, তবে পরবর্তী লেআউট সামঞ্জস্যগুলিও সংযোগ হারাতে পারে।

is_linked_to_previous এর উত্তরাধিকার ফাঁদ বোঝা

_Header.is_linked_to_previous হল এই সমস্যার সমাধান করার জন্য কী সুইচ।

• যখন এটি True হয়, তখন এর অর্থ হল বর্তমান বিভাগে একটি স্বাধীন শিরোনাম সংজ্ঞা নেই, এবং প্রদর্শিত বিষয়বস্তু চেইন বরাবর উপরের দিকে চিহ্নিত করা হয়েছে এবং সংজ্ঞা আছে এমন উচ্চতর বিভাগ থেকে উত্তরাধিকারসূত্রে প্রাপ্ত।
• নতুন নথিতে বা বিভাগগুলিতে যেখানে শিরোনামটি স্পষ্টভাবে সেট করা নেই, এই মানটি True তে ডিফল্ট।
• বিপরীতভাবে: এমনকি যদি বর্তমান বিভাগটি কেবলমাত্র বিষয়বস্তুর উত্তরাধিকারী হয়, যখনই header.paragraphs অ্যাক্সেস করা হয় বা পাঠ্য পরিবর্তন করার চেষ্টা করা হয়, python-docx স্বয়ংক্রিয়ভাবে একটি খালি হেডার সংজ্ঞা তৈরি করবে এবং is_linked_to_previous কে False এ সেট করবে।

তাই কেবল "সকল বিভাগে লুপ করুন এবং হেডার অনুবাদ করুন" ঝুঁকিপূর্ণ। লিঙ্ক স্ট্যাটাস হেডারের জন্য, সঠিক পদ্ধতি হল এড়িয়ে যাওয়া, অনুবাদ নয়। শুধুমাত্র যখন is_linked_to_previous == False বিভাগে একটি স্বাধীন উৎস পাঠ্য থাকে যা অনুবাদ প্রক্রিয়ায় পাঠানোর প্রয়োজন হয়।

যদি ব্যবসার সত্যিই প্রয়োজন হয় যে একটি বিভাগ কোথাও থেকে একটি ভিন্ন অনুবাদ শিরোনাম ব্যবহার করে, তাহলে আপনাকে স্পষ্টভাবে is_linked_to_previous কে False-এ সেট করতে হবে এবং তারপর বিষয়বস্তু প্রতিস্থাপন করতে হবে, যা Word ইন্টারফেসে "আনলিঙ্ক" অপারেশনের সমতুল্য।

📊 মূল তুলনা

সংশ্লেষণ উদাহরণ: সঠিক এবং ভুল সীমানা প্রক্রিয়াকরণ

প্রক্রিয়াকরণের যুক্তি যাচাই করার জন্য, তিনটি অবস্থা সম্বলিত সিন্থেটিক নমুনার একটি সেট নীচে তৈরি করা হয়েছে। দ্রষ্টব্য: এটি একটি সিন্থেটিক উদাহরণ যা যুক্তি প্রদর্শন করতে ব্যবহৃত হয়, একটি বাস্তব ক্লায়েন্ট ফাইল নয়। আপনি যদি একটি বাস্তব নথি পরীক্ষা করতে চান, তাহলে কমপক্ষে 3টি বিভাগ বিরতি সহ একটি .docx ফাইল প্রস্তুত করুন, "পূর্ববর্তী বিভাগের লিঙ্ক" এবং স্বাধীন শিরোনামের মিশ্রণ, এবং যাচাই করুন যে ফাইলটি IRM সুরক্ষিত নয় এবং শিরোনাম সামগ্রীটি একটি VBA ম্যাক্রো দ্বারা গতিশীলভাবে তৈরি হয়নি৷

ইনপুট সেটিংস:

• বিভাগ 0: "অধ্যায় এক" পাঠ্য সহ স্বাধীন শিরোনাম।
• বিভাগ 1: পূর্ববর্তী বিভাগের সাথে সংযুক্ত (is_linked_to_previous=True), কোন স্বাধীন সংজ্ঞা নেই।
• বিভাগ 2: "পরিশিষ্ট" পাঠ্য সহ স্বাধীন শিরোনাম।

প্রত্যাশিত সঠিক আউটপুট:

• বিভাগ 0 শিরোনাম "অধ্যায় এক" এ অনুবাদ করে।
• বিভাগ 1 সংযুক্ত থাকে, অনুবাদ সম্পাদন করে না এবং উত্তরাধিকারসূত্রে পাওয়া "অধ্যায় 1" প্রদর্শন করতে থাকে।
• বিভাগ 2 হেডার "পরিশিষ্ট" হিসাবে অনুবাদ করে।

ত্রুটি এবং প্রান্তের ক্ষেত্রে:

যদি স্ক্রিপ্ট লিঙ্কের স্থিতি উপেক্ষা করে এবং বিভাগ 1 এ paragraph.text = translate(...) চালায়, বিভাগ 1 একটি নতুন শিরোনাম সংজ্ঞা তৈরি করবে। দৃশ্যত এটি আপাতত সঠিক মনে হতে পারে, তবে নথির কাঠামো পরিবর্তন করা হয়েছে।

একটি আরও গুরুতর প্রান্তের ক্ষেত্রে একটি খালি নথি বা একটি সম্পূর্ণ লিঙ্কযুক্ত নথি: যদি সমস্ত বিভাগ True হয় এবং কোনও সংজ্ঞা না থাকে, অনুচ্ছেদগুলি অ্যাক্সেস করা একটি নতুন বিল্ডকে ট্রিগার করবে৷ নিরাপদ কোডটি পড়ার এবং লেখার আগে বুলিয়ান ফ্ল্যাগগুলি পরীক্ষা করতে হবে এবং অন্ধভাবে মান নির্ধারণের পরিবর্তে "সমস্ত লিঙ্ক, কোনও উত্স নেই" পরিস্থিতির বিরুদ্ধে প্রতিরক্ষামূলক রায় দিতে হবে।

পাইথন নিরাপদ হেডার নিষ্কাশন এবং লিঙ্ক ব্রেকিং প্রয়োগ করে

নীচের কোডটি দেখায় কিভাবে মেমরিতে নমুনা তৈরি করতে হয় এবং হেডার অনুবাদ যুক্তিকে নিরাপদে পরিচালনা করতে হয়। এটি python-docx লাইব্রেরির উপর নির্ভর করে। আপনার নিজস্ব সংস্করণ-লক নির্ভরতা পরিবেশে এটি চালান. সংস্করণটি অবশ্যই API 0.8.11 এবং তার বেশির সাথে সামঞ্জস্যপূর্ণ হতে হবে।

দ্রষ্টব্য: এই কোডটি একটি শিক্ষণ প্রদর্শনী। এটি সম্পূর্ণ রান-লেভেল ফরম্যাট ধারণ এবং ডোমেন কোড সুরক্ষা বাস্তবায়ন করে না এবং উৎপাদন পরিবেশে সরাসরি ব্যবহার করা যাবে না।

from docx import Document
from docx.shared import Pt

def safe_translate_headers(doc, translate_fn):
    """
    安全翻译页眉：仅处理独立定义的页眉，保留继承关系。
    translate_fn: 接受字符串返回译文的函数
    """
    processed_count = 0
    for i, section in enumerate(doc.sections):
        header = section.header
        # 核心守卫：仅当存在独立定义时才处理
        if header.is_linked_to_previous:
            print(f"Section {i}: Linked, skipping to preserve inheritance.")
            continue

        # 此时才安全访问 paragraphs，不会意外创建新定义
        for para in header.paragraphs:
            original_text = para.text.strip()
            if original_text:
                new_text = translate_fn(original_text)
                # 安全替换：保留run格式，避免直接赋值para.text
                # 实际生产环境应增加域代码(Field)检测与跳过逻辑
                full_text = ''.join(run.text for run in para.runs)
                if full_text.strip() == original_text:
                    # 简单场景：文本完全由runs组成
                    for run in para.runs:
                        run.text = ""
                    if para.runs:
                        para.runs[0].text = new_text
                    else:
                        para.add_run(new_text)
                else:
                    # 复杂场景：包含域代码或其他元素，此处仅作标记
                    print(f"Warning: Section {i} contains complex elements, manual review needed.")
                    continue

                processed_count += 1
                print(f"Section {i}: Translated '{original_text}' -> '{new_text}'")
    return processed_count

# --- 合成示例构建与断言 ---
doc = Document()
# Sec 0: 独立页眉
doc.sections[0].header.is_linked_to_previous = False
doc.sections[0].header.paragraphs[0].text = "Original Title"

# Sec 1: 添加新节并保持链接(默认即为True)
new_section = doc.add_section()
assert new_section.header.is_linked_to_previous is True

# Sec 2: 添加新节并断开链接
appendix_sec = doc.add_section()
appendix_sec.header.is_linked_to_previous = False
appendix_sec.header.paragraphs[0].text = "Appendix Data"

# 模拟翻译函数
mock_translate = lambda x: f"[ZH]{x}"
count = safe_translate_headers(doc, mock_translate)

# 验收断言
assert count == 2, "Should only translate 2 independent headers"
assert doc.sections[1].header.is_linked_to_previous is True, "Link must be preserved"
assert "[ZH]Original Title" in doc.sections[0].header.paragraphs[0].text
print("Logic validation passed.")

🎯 কোন পদ্ধতি আপনার জন্য উপযুক্ত?

যদি আপনার শুধুমাত্র ইউনিফাইড অনুবাদের প্রয়োজন হয়

শুধুমাত্র স্বতন্ত্রভাবে সংজ্ঞায়িত শিরোনামগুলি অনুবাদ করা হয়, এবং লিঙ্কযুক্ত বিভাগগুলি অক্ষত থাকে, Word কে মূল বিভাগের শিরোনামগুলি ব্যবহার করা চালিয়ে যেতে দেয়৷

যদি প্রতিটি সেকশনের হেডার কন্টেন্ট আলাদা হয়

বিভাগ দ্বারা is_linked_to_previous বিভাগ দেখুন। স্বাধীনভাবে সংজ্ঞায়িত বিভাগগুলি অনুবাদ করা হয় এবং আবার লেখা হয়; যে বিভাগগুলির পূর্ববর্তী বিভাগ থেকে একটি ভিন্ন অনুবাদ প্রয়োজন সেগুলি লেখার আগে স্পষ্টভাবে সংযোগ বিচ্ছিন্ন করা আবশ্যক৷

যদি নথির কাঠামো জটিল বা সুরক্ষিত হয়

যেসব নথিতে নেস্টেড টেবিল শিরোনাম, VBA ম্যাক্রো দ্বারা তৈরি হেডার সামগ্রী, বা IRM সুরক্ষা অন্তর্ভুক্ত রয়েছে, তাদের জন্য স্বয়ংক্রিয় প্রক্রিয়াকরণ ত্যাগ করার এবং ম্যানুয়াল পর্যালোচনাতে স্যুইচ করার পরামর্শ দেওয়া হয়।

গ্রহণযোগ্যতার মানদণ্ড এবং ম্যানুয়াল পর্যালোচনা লাল লাইন

কোডটি ত্রুটি ছাড়াই চলে তার মানে এই নয় যে ডেলিভারি যোগ্য। শিরোনাম অনুবাদে লেআউট শব্দার্থবিদ্যা জড়িত এবং মূল পাঠ্য থেকে আলাদা একটি স্বীকৃতি চেকলিস্ট স্থাপনের প্রয়োজন। নিচের সারণীতে অটোমেশনের পর মূল চেকপয়েন্ট তালিকা করা হয়েছে।

প্রযোজ্য নয়: উপরের যুক্তিটি শুধুমাত্র স্ট্যান্ডার্ড ক্রমাগত বিভাগ বিরতি নথিতে প্রযোজ্য। জটিল নেস্টেড টেবিল শিরোনাম, VBA ম্যাক্রো থেকে গতিশীলভাবে তৈরি সামগ্রী, বা IRM দ্বারা সুরক্ষিত নথিগুলিকে স্বয়ংক্রিয় স্ক্রিপ্ট দ্বারা সক্রিয়ভাবে বাতিল করা উচিত এবং মানুষের পর্যালোচনার জন্য চিহ্নিত করা উচিত। "কোড চালাতে পারে" এর অর্থ এই নয় যে "সমস্ত সীমানা পরিস্থিতি কভার করা হয়েছে"।

তথ্যসূত্র এবং পরবর্তী পদক্ষেপ

• python-docx: হেডার এবং ফুটারের সাথে কাজ করা

নথি অনুবাদের জন্য এই চেকলিস্ট ব্যবহার করুন

শব্দ অনুবাদ সহজেই বিষয়বস্তুর সমস্যাগুলিকে বিন্যাস সংক্রান্ত সমস্যাগুলির সাথে বিভ্রান্ত করতে পারে৷ ডেলিভারি তালিকায় স্টাইল, শিরোনাম, টেবিল ইত্যাদির মতো চেক আইটেমগুলিকে আলাদাভাবে তালিকাভুক্ত করার মাধ্যমে, পর্যালোচক জানতে পারবেন কোথায় পরিদর্শন ফোকাস করতে হবে।

OmniDoc (পণ্য পোর্টাল) একটি মাল্টি-ফরম্যাট নথি অনুবাদ পোর্টাল প্রদান করে, এবং অফিসিয়াল ওয়েবসাইট OCR, শব্দকোষ এবং দ্বিভাষিক তুলনা ফাংশনগুলি প্রবর্তন করে। যদি আপনার দল সরাসরি ফাইল থেকে প্রক্রিয়াকরণ শুরু করতে চায়, তাহলে আপনি বাস্তব নমুনা দিয়ে এই পথটি মূল্যায়ন করতে পারেন। অনুগ্রহ করে একটি অসংবেদনশীল ফাইল ব্যবহার করুন যা আপনার কাছে এই নিবন্ধের চেকলিস্টগুলি ব্যবহার করে ফলাফলগুলি আপলোড এবং পর্যালোচনা করার অনুমতি রয়েছে৷ এখানে কোন দাবি নেই যে OmniDoc এই নিবন্ধে উল্লিখিত ওপেন সোর্স লাইব্রেরি বা অভ্যন্তরীণ অ্যালগরিদম ব্যবহার করে এবং উদাহরণগুলি পণ্যের কার্যক্ষমতা পরীক্ষার বিকল্প নয়।

❓ প্রায়শই জিজ্ঞাসিত প্রশ্ন (FAQ)

1. হেডার অনুচ্ছেদ অ্যাক্সেস করার পরে লিঙ্কের অবস্থা কেন পরিবর্তন হয়?

যখন python-docx অনুচ্ছেদগুলি অ্যাক্সেস করে বা পাঠ্য সংশোধন করে, তখন এটি স্বয়ংক্রিয়ভাবে একটি খালি হেডার সংজ্ঞা তৈরি করবে এবং is_linked_to_previous কে False এ সেট করবে৷ তাই এই পতাকা পড়ার আগে চেক করা উচিত।

2. সমস্ত বিভাগ লিঙ্ক অবস্থায় আছে এবং এর কোন সংজ্ঞা নেই। আমি কি করব?

পড়া এবং লেখার আগে বুলিয়ান পতাকা পরীক্ষা করুন, "সমস্ত লিঙ্ক, কোন উৎস নেই" এর পরিস্থিতির উপর প্রতিরক্ষামূলক বিচার করুন এবং অন্ধভাবে মান নির্ধারণ করবেন না।

৩. কোড রান হয়ে গেলে কি ডেলিভারি করা যাবে?

না অনুবাদের দৈর্ঘ্য ওভারফ্লো হয় কিনা, বিজোড়-জোড় পৃষ্ঠা এবং হোম পৃষ্ঠা শিরোনামগুলি সঠিক কিনা সেগুলির জন্য ম্যানুয়াল পর্যালোচনার প্রয়োজন, এবং কোডটি ভিজ্যুয়াল রেন্ডারিং ফলাফলগুলি উপলব্ধি করতে পারে না।

4. পৃষ্ঠা সংখ্যা একসাথে অনুবাদ করা যেতে পারে?

এটি অনুবাদ করা উচিত নয়। ফিল্ড কোড যেমন পৃষ্ঠা নম্বর এবং তারিখ বজায় রাখা উচিত। স্ক্রিপ্ট শুধুমাত্র প্লেইন টেক্সট Run অনুবাদ করে এবং FieldRun এড়িয়ে যায়।

5. এই কোডটি কি সরাসরি উৎপাদন পরিবেশে ব্যবহার করা যেতে পারে?

পারে না এটি একটি শিক্ষণীয় প্রদর্শন এবং সম্পূর্ণ রান-লেভেল ফরম্যাট সংরক্ষণ এবং ডোমেন কোড সুরক্ষা বাস্তবায়ন করে না। এই অংশগুলি অনলাইনে যাওয়ার আগে বাস্তব ফাইলগুলির সাথে সম্পূর্ণ এবং পরীক্ষা করা দরকার।

📝 সারাংশ

হেডার ট্রান্সলেশনের চাবিকাঠি হল প্রথমে বিভাগের উত্তরাধিকার স্থিতি নির্ধারণ করা এবং তারপরে অনুবাদ করা বা এড়িয়ে যাওয়ার সিদ্ধান্ত নেওয়া। স্বীকৃতি তালিকার মধ্য দিয়ে চলার পরে, লেআউটের জন্য ম্যানুয়াল পর্যালোচনাতে এটি হস্তান্তর করুন।

এটি এখনই চেষ্টা করুন: অনুবাদ শুরু করতে নথিটি আপলোড করুন, মূল বিন্যাস বজায় রেখে৷