FreeCAD / FreeCAD/FreeCAD-Homepage
Python script shown on manual homepage does not work after deployment of Anubis
Nobody has claimed this yet.
- Dominant language
- CSS
- Stars
- 89
- Forks
- 71
- PR merge metrics
- No merged PRs in 30d
Description
A python script is provided to convert the current FreeCAD manual wiki pages to an offline PDF. However, it does not work as expected since the deployment of the Anubis content protection system on the FreeCAD website. The extract_manual_links() function returns the href links on the Anubis page, not the Manual:Introduction page, so it finds no chapters or subchapters to extract.
The issue can be worked around by changing the user-agent string presented by the script. Simply search for two occurrences of "Mozilla" and replace it with "Curl". However that isn't really a proper solution.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Python script linked as FreeCAD_Manual_Converter and inspect extract_manual_links(). Reproduce its request for Manual:Introduction after Anubis deployment and compare the returned hrefs with the manual page links. Done means the converter identifies chapter and subchapter links and can proceed toward the offline PDF without relying on the temporary user-agent workaround.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100