Generate output/hilali.pdf — Hilali-Khan English translation PDF (644 pages)

[Copilot]

The repository lacked a compiled PDF for the Hilali-Khan English translation (data/en.hilali.txt), while similar PDFs existed for other translations (Farooq, Suhail, Hindi Mokhtasar).

Changes

• latex/hilali.tex — new XeLaTeX wrapper; Scheherazade font for Arabic (×2), English as main language, inputs generated quhilali.tex
• src/gentexforquran.py — new generator block at end; parses sura|ayah|text pipe format from data/en.hilali.txt; escapes LaTeX specials ($, %, &, #, ^, ~) in English text; emits per-ayah Arabic + English pairs
• output/hilali.pdf — compiled artifact: 644 pages, A4, 3.4 MB (2 XeLaTeX passes)
• Makefile — output/hilali.pdf added to all target with explicit dep on latex/quhilali.tex
• .gitignore — !output/hilali.pdf negation to track the PDF; latex/quhilali.tex excluded (generated)
• README.md — updated data file tree, LaTeX tree, output tree, PDF table, data source table, build commands, and txt mapping table
• CHANGELOG.md — entry added for Hilali & Khan PDF

Generator pattern

with open('latex/quhilali.tex', 'w', encoding='utf-8') as hilali_out, \
     open('data/en.hilali.txt', 'r', encoding='utf-8') as hilali_in:
    for sura_idx in range(114):
        ...
        raw_line = hilali_in.readline().rstrip('\n')
        text = raw_line.split('|', 2)[2] if raw_line.count('|') >= 2 else raw_line
        text = text.replace('$', '\\$').replace('%', '\\%').replace('&', '\\&')...
        hilali_out.write("\\flushleft{%s}\n" % text)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.