Maintaining The Wiki¶
This wiki is designed to keep growing with the folder. The generator scans the research sources, refreshes the archive pages, copies public-safe original files into the site, and rebuilds the listings catalog automatically.
- Add new research files anywhere in this repository except
docs/,site/, ortools/. - Run
python tools/generate_wiki.py. - Run
python -m mkdocs build. - Open
site/index.htmlto review the result, or runpython -m mkdocs servefor a local preview server.
What the generator does:
- It inventories the source files and creates a source-archive page for each one.
- It copies public-safe original files into the site so they can be downloaded later.
- It withholds raw money-transfer source files from the public site and replaces them with redacted archive pages.
- It groups the files into property research, money and tax research, audio notes, and general background material.
- It links audio archive pages to matching transcript text files whenever those transcript files are present in the folder.
- It extracts property links from the Lahore listing and market-research documents, then classifies them into plot versus house and 5 Marla versus 10 Marla buckets wherever the source makes that visible.
- It keeps an all-links audit page so missed links are easier to spot when new files are added.
- It keeps uncategorized or new files visible in the archive so they do not disappear from view.
Current limitation:
If a new transcript file is added, it will be archived automatically and linked to its matching audio file, but any clean English translation or family-facing summary page still needs a manual pass so the meaning is not distorted by rough machine transcription.