Add Hadith data integration, output generation, website (all 10 collections), Khattab book PDFs, /docs/how Ethical & Duty Guide, and Hindi + English + Unicode transliteration + Roman Urdu print-ready HTML exports

.gitignore

@@ -13,9 +13,17 @@ latex/qup.tex
 latex/qus.tex
 latex/qut.tex
 latex/qupk.tex
+latex/quk.tex
+# Generated intermediate Khattab book content (regenerated by src/gen_khattab_book.py)
+latex/khattab_book_content.tex
+# Compiled PDFs inside latex/ (build artefacts)
+latex/*.pdf
 
 # Compiled PDFs (large binary build artefacts; regenerated via `make all`)
 output/*.pdf
+# Tracked PDF outputs (committed for convenience — regenerate via make targets)
+!output/khattab.pdf
+!output/quran_khattab_english_a5.pdf
 
 # Python cache
 __pycache__/

Makefile

@@ -4,16 +4,28 @@ LATEX    = xelatex
 LATEX_DIR = latex
 OUTPUT_DIR = output
 
-.PHONY: all generate-tex generate-txt generate-docs clean help
+.PHONY: all generate-tex generate-txt generate-hadith generate-hadith-html generate-how-html generate-docs generate-khattab-pdf generate-khattab-book-pdf generate-hindi-mokhtasar-print-html generate-hindi-farooq-print-html generate-hindi-suhail-print-html generate-english-ummmuhammad-print-html generate-translit-unicode-print-html generate-roman-urdu-maududi-print-html generate-english-khattab-print-html clean help
 
 ## Show available targets.
 help:
 	@echo "Available targets:"
-	@echo "  make generate-tex   Generate intermediate LaTeX content files (run first for PDFs)"
-	@echo "  make all            Compile all PDFs (requires generate-tex first)"
-	@echo "  make generate-txt   Generate formatted plain-text output files"
-	@echo "  make generate-docs  Regenerate the docs/ HTML pages (requires generate-txt first)"
-	@echo "  make clean          Remove LaTeX build artefacts"
+	@echo "  make generate-tex    Generate intermediate LaTeX content files (run first for PDFs)"
+	@echo "  make all             Compile all PDFs (requires generate-tex first)"
+	@echo "  make generate-khattab-pdf       Generate Khattab English+Transliteration PDF (output/khattab.pdf)"
+	@echo "  make generate-khattab-book-pdf  Generate professional A5 book PDF, English only (output/quran_khattab_english_a5.pdf)"
+	@echo "  make generate-txt    Generate formatted plain-text output files"
+	@echo "  make generate-hadith      Generate plain-text Hadith output files (output/hadith/)"
+	@echo "  make generate-hadith-html Generate Hadith HTML website (docs/hadith/)"
+	@echo "  make generate-how-html    Generate Ethical & Duty Guide website (docs/how/)"
+	@echo "  make generate-hindi-mokhtasar-print-html  Generate print-ready Hindi Mokhtasar HTML (output/hindi_mokhtasar_print.html)"
+	@echo "  make generate-hindi-farooq-print-html     Generate print-ready Hindi Farooq A5 HTML (output/hindi_farooq_print.html)"
+	@echo "  make generate-hindi-suhail-print-html     Generate print-ready Hindi Suhail A5 HTML (output/hindi_suhail_print.html)"
+	@echo "  make generate-english-ummmuhammad-print-html  Generate print-ready English Umm Muhammad A5 HTML (output/english_ummmuhammad_print.html)"
+	@echo "  make generate-translit-unicode-print-html  Generate print-ready Unicode transliteration A5 HTML (output/translit_unicode_print.html)"
+	@echo "  make generate-roman-urdu-maududi-print-html  Generate print-ready Roman Urdu Maududi A5 HTML (output/roman_urdu_maududi_print.html)"
+	@echo "  make generate-english-khattab-print-html  Generate print-ready English Khattab A5 HTML (output/english_khattab_print.html)"
+	@echo "  make generate-docs        Regenerate the docs/ HTML pages (requires generate-txt first)"
+	@echo "  make clean                Remove LaTeX build artefacts"
 
 ## Build all PDFs (requires generate-tex to have been run first).
 all: $(OUTPUT_DIR)/farooq.pdf $(OUTPUT_DIR)/suhail.pdf \
@@ -37,11 +49,64 @@ $(OUTPUT_DIR)/suhail.pdf:   $(LATEX_DIR)/qup.tex
 $(OUTPUT_DIR)/sahih.pdf:    $(LATEX_DIR)/qus.tex
 $(OUTPUT_DIR)/translit.pdf: $(LATEX_DIR)/qut.tex
 $(OUTPUT_DIR)/pickthall.pdf: $(LATEX_DIR)/qupk.tex
+$(OUTPUT_DIR)/khattab.pdf:  $(LATEX_DIR)/quk.tex
+
+## Generate Khattab English translation + Unicode transliteration PDF (no Arabic).
+## Requires generate-tex to have been run first.
+generate-khattab-pdf: $(OUTPUT_DIR)/khattab.pdf
+
+## Generate professional A5 book PDF — English translation only, no transliteration.
+## Self-contained: runs gen_khattab_book.py then compiles with XeLaTeX (two passes for TOC).
+generate-khattab-book-pdf: | $(OUTPUT_DIR)
+	$(PYTHON) src/gen_khattab_book.py
+	cd $(LATEX_DIR) && $(LATEX) -interaction=nonstopmode khattab_book.tex && \
+	  $(LATEX) -interaction=nonstopmode khattab_book.tex && \
+	  mv khattab_book.pdf ../$(OUTPUT_DIR)/quran_khattab_english_a5.pdf
 
 ## Generate formatted plain-text output files.
 generate-txt:
 	$(PYTHON) src/gentxtforquran.py
 
+## Generate plain-text Hadith output files.
+generate-hadith:
+	$(PYTHON) src/gen_hadith_txt.py
+
+## Generate Hadith HTML website (docs/hadith/).
+generate-hadith-html:
+	$(PYTHON) src/gen_hadith_html.py
+
+## Generate Ethical & Duty Guide website (docs/how/).
+generate-how-html:
+	$(PYTHON) src/gen_how_html.py
+
+## Generate print-ready Hindi Mokhtasar HTML (output/hindi_mokhtasar_print.html).
+generate-hindi-mokhtasar-print-html:
+	$(PYTHON) src/gen_hindi_mokhtasar_print_html.py
+
+## Generate print-ready Hindi Farooq A5 HTML (output/hindi_farooq_print.html).
+generate-hindi-farooq-print-html:
+	$(PYTHON) src/gen_hindi_farooq_print_html.py
+
+## Generate print-ready Hindi Suhail A5 HTML (output/hindi_suhail_print.html).
+generate-hindi-suhail-print-html:
+	$(PYTHON) src/gen_hindi_suhail_print_html.py
+
+## Generate print-ready English Umm Muhammad A5 HTML (output/english_ummmuhammad_print.html).
+generate-english-ummmuhammad-print-html:
+	$(PYTHON) src/gen_english_ummmuhammad_print_html.py
+
+## Generate print-ready Unicode transliteration A5 HTML (output/translit_unicode_print.html).
+generate-translit-unicode-print-html:
+	$(PYTHON) src/gen_translit_unicode_print_html.py
+
+## Generate print-ready Roman Urdu Maududi A5 HTML (output/roman_urdu_maududi_print.html).
+generate-roman-urdu-maududi-print-html:
+	$(PYTHON) src/gen_roman_urdu_maududi_print_html.py
+
+## Generate print-ready English Khattab A5 HTML (output/english_khattab_print.html).
+generate-english-khattab-print-html:
+	$(PYTHON) src/gen_english_khattab_print_html.py
+
 ## Regenerate the docs/ HTML pages (GitHub Pages).
 ## Requires generate-txt to have been run first.
 generate-docs: