Function process_section

scripts/translate_fulltext.py:242–297

Translate all fulltext files in a section (e.g. nmpa/guidance).

(section: str, limit: int = 0, dry_run: bool = False,
                    force: bool = False)

def process_section(section: str, limit: int = 0, dry_run: bool = False,
                    force: bool = False):
    """Translate all fulltext files in a section (e.g. nmpa/guidance)."""
    parts = section.split('/')
    if len(parts) != 2:
        logger.error(f"Section must be framework/type (e.g. nmpa/guidance)")
        return

    framework, doc_type = parts
    fulltext_dir = KNOWLEDGE_ROOT / framework / doc_type / "fulltext"

    if not fulltext_dir.exists():
        logger.error(f"Directory not found: {fulltext_dir}")
        return

    zh_files = sorted(fulltext_dir.glob("*.md"))
    zh_files = [f for f in zh_files if not f.stem.endswith('.en')]

    candidates = []
    already_done = 0
    for zh_path in zh_files:
        en_path = get_en_path(zh_path)
        if not force and en_path.exists():
            already_done += 1
            continue
        candidates.append(zh_path)

    total_candidates = len(candidates)
    if limit > 0:
        candidates = candidates[:limit]

    logger.info(f"Translating {len(candidates)} files from {fulltext_dir}")
    logger.info(f"  Total ZH files: {len(zh_files)}, "
                f"Already translated: {already_done}, "
                f"Remaining: {total_candidates}")

    success = 0
    failed = 0

    for i, zh_path in enumerate(candidates):
        logger.info(f"[{i+1}/{len(candidates)}] {zh_path.name}")

        if dry_run:
            continue

        en_text = translate_document(zh_path)
        if not en_text:
            failed += 1
            continue

        en_path = get_en_path(zh_path)
        en_path.write_text(en_text, encoding="utf-8")
        logger.info(f"  Saved: {en_path.name} ({len(en_text)} chars)")
        success += 1

    logger.info(f"\nTranslation complete: {success} succeeded, {failed} failed")