\documentclass[12pt]article \usepackagefontspec \usepackagepolyglossia \setmainlanguagearabic \setotherlanguageenglish \newfontfamily\arabicfont[Script=Arabic]Noto Sans Arabic \newfontfamily\englishfontLatin Modern Roman
# Restore code blocks for key, block in placeholders.items(): translated = translated.replace(key, block) ktab my system mtrjm llrbyt pdf
Optional: Add a ( openssl ) if the document must be tamper‑proof. | | pandoc -s src
# macOS (Homebrew) brew install pandoc brew install --cask mactex-no-gui # includes XeLaTeX | | pdftotext final
openssl dgst -sha256 -sign private_key.pem -out system_xyz_ar.pdf.sig output/system_xyz_ar.pdf | Command | What it does | |---------|--------------| | git init && git add . && git commit -m "init" | Version‑control the source docs. | | pandoc -s src.md -o src.pdf | Test a simple PDF export (English). | | python translate.py | Run the MT + placeholder script (see 2.4.1). | | pandoc --template=arabic.tex --pdf-engine=xelatex -o final.pdf arabic.md | Produce the final Arabic PDF. | | pdftotext final.pdf - | grep -q "[\x0600-\x06FF]" && echo OK | Verify Arabic text is real, not an image. | 4ï¸âƒ£ Common Pitfalls & How to Avoid Them | Pitfall | Fix | |---------|-----| | Arabic letters appear disconnected | Use a Unicode‑aware engine (XeLaTeX) and a proper Arabic font (Noto Sans Arabic). |
# Preserve code fences & markdown syntax by not translating them def protect_blocks(txt): # replace code fences with placeholders blocks = {} def repl(m): key = f"__CODE_len(blocks)__" blocks[key] = m.group(0) return key txt = re.sub(r'```[\s\S]*?```', repl, txt) # triple backticks txt = re.sub(r'`[^`\n]+`', repl, txt) # inline code return txt, blocks