Fix links VS version in hub cards

[adriendupuis]

Question	Answer
JIRA Ticket
Versions
Edition

Bug

Example:
https://doc.ibexa.co/projects/userguide/en/4.5/persona_paths/author_content/ "Edit image"
In persona_paths/author_content.md, content_management/edit_images/ refers to 4.5 file which doesn't exist on master or 4.6 (moved to image_management/edit_images/).

Solution Comparison

• main.py: cards: get right version from abs_url #271: Tries to get right URL from main.py side. Failed as a standalone solution as to retrieve the real URL seems impossible. It removes the host from href attribute which is good for Ibexa DXP editions > Ibexa Headless documentation-developer#2242 if ported to dev doc. At least, it cleans up the code a bit.
• cards: force_version="4.5" #285: Uses cards already existing feature to force 4.5 from 4.5 branch. Success on production but breaks the link on localhost which could disturb doc writers. The fix must be installed on each branch except the one corresponding to last (actually 4.6 but this will change). Too hard to maintain.
• cards.js to fix links #287: Works perfectly but might be in conflict with IBX-4175: Add links checker documentation-developer#2130 when ported to dev doc.

When on projects/userguide/en//persona_paths/author_content/
"✅ Yes": The "Edit images" link leads to the expected location.
"✔️ Yes, but…": The "Edit images" link works but leads to a less accurate location (change the server and/or the version). Weak links that break as soon as master differs from latest.
":x: No": The "Edit images" is broken.

branch+env	none	#271	#285	#287
latest Production	✅ Yes	✅ Yes	✅ Yes	✅ Yes
4.5 Production	❌ No	❌ No	✅ Yes	✅ Yes
4.5 ReadTheDocs	❌ No	❌ No	✔️ Yes, but….	✅ Yes
4.5 localhost	✅ Yes	✅ Yes.	❌ No	✅ Yes
master Production	✔️ Yes, but…	✔️ Yes, but…	✔️ Yes, but…	✅ Yes
master ReadTheDocs	✔️ Yes, but…	❌ No	✔️ Yes, but…	✅ Yes
master localhost	✅ Yes	✅ Yes	✔️ Yes, but…	✅ Yes

"latest Prodution": https://doc.ibexa.co/projects/userguide/en/latest/persona_paths/author_content/
"4.5 Production": https://doc.ibexa.co/projects/userguide/en/4.5/persona_paths/author_content/
"master Production": https://doc.ibexa.co/projects/userguide/en/master/persona_paths/author_content/

"master ReadTheDocs": The preview of a pull request from master to master
"4.5 ReadTheDocs": The preview of a pull request from 4.5 branch to 4.5
"master localhost": The local run of mkdocs serve on branch master

Fix

#287 + #271

https://doc.ibexa.co/projects/userguide/en/4.5/persona_paths/author_content/ example:

1. main.py: cards: get right version from abs_url #271: The HTML is generated with href="/projects/userguide/en/latest/content_management/edit_images"
2. cards.js to fix links #287: card.js sees it as an internal link and replace it with href="/projects/userguide/en/4.5/content_management/edit_images"

https://ez-systems-developer-documentation--288.com.readthedocs.build/projects/userguide/en/288/persona_paths/author_content/

1. main.py: cards: get right version from abs_url #271: The HTML is generated with href="/projects/userguide/en/latest/image_management/edit_images"
2. cards.js to fix links #287: card.js sees it as an internal link and replace it with href="/projects/userguide/en/288/image_management/edit_images"

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Added link to this PR in relevant JIRA ticket or code PR

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[adriendupuis]

Of course, it also happens on developer doc (see ibexa/documentation-developer#2541).

[github-actions]

Preview of modified files: no change to preview.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud