Move from Python to Twig

[adriendupuis]

Question	Answer
JIRA Ticket	N/A
Versions	5.0, 4.6
Edition	All

Use index.html as the reference to get the navigation sidebar from (instead of having an external file to store it and a Python script to extract it).
Use sidebar.html.twig template to have the JS in every pages but index.html and reports/*.html (so no Python script needed to make the replacement).

I fixed an issue with the highlight of the current nav menu item.

Some previews (browse in private mode to not have too much cache):

• https://ez-systems-developer-documentation--3014.com.readthedocs.build/en/3014/api/php_api/php_api_reference/ (index.html which include the nav)
• https://ez-systems-developer-documentation--3014.com.readthedocs.build/en/3014/api/php_api/php_api_reference/namespaces/ibexa-contracts-activitylog-values-activitylog.html (a namespace which have to load the nav from HTTP or session cache
• https://ez-systems-developer-documentation--3014.com.readthedocs.build/en/3014/api/php_api/php_api_reference/classes/Ibexa-Contracts-ActivityLog-Values-ActivityLog-ActionInterface.html (a class also having to load the nav)
• https://ez-systems-developer-documentation--3014.com.readthedocs.build/en/3014/api/php_api/php_api_reference/reports/errors.html (the hidden error report includes the nav) (see ibexa/connector-ai#168 for the reported error)

Main changes compare to 5.0 branch are in tools/api_refs/.phpdoc/template/components:

• tools/api_refs/.phpdoc/template/components/sidebar.html.twig with the if to generate the menu or set the JS
• tools/api_refs/.phpdoc/template/js/active-menu.js exports activeMenu function so it can be executed by the nav loader.

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[github-actions]

Preview of modified files: no change to preview.

[mnocon]

Thank you, it's great 🎉