Set edit links dynamically for RtD preview and PR builds (#3280)

* Set edit links dynamically for RtD preview and PR builds

* Replaced edit with blob

Author: mnocon

.gitignore

@@ -1,6 +1,7 @@
 /vendor/
 **/.DS_Store
 __pycache__/*
+hooks/__pycache__/*
 /site/
 **/.idea/
 .php-cs-fixer.cache

hooks/edit_uri.py

@@ -0,0 +1,12 @@
+import os
+
+def on_config(config, **kwargs):
+    if os.environ.get("READTHEDOCS_VERSION_TYPE") == "external":
+        ref = os.environ.get("READTHEDOCS_GIT_COMMIT_HASH")
+    else:
+        ref = os.environ.get("GITHUB_HEAD_REF")
+
+    if ref:
+        config["edit_uri"] = f"blob/{ref}/docs/"
+
+    return config

mkdocs.yml

@@ -2,8 +2,10 @@ INHERIT: plugins.yml
 
 site_name: Developer Documentation
 repo_url: https://github.com/ibexa/documentation-developer
-edit_uri: edit/5.0/docs
+edit_uri: blob/5.0/docs
 site_url: https://doc.ibexa.co/en/latest/
+hooks:
+    - hooks/edit_uri.py
 copyright: "Copyright 1999-2026 Ibexa AS and others"
 validation:
     omitted_files: warn

theme/partials/source.html

@@ -1,5 +1,5 @@
 {% import "partials/language.html" as lang with context %}
-<a href="{{ page.edit_url|replace('/edit/', '/blob/') }}" title="{{ lang.t('source.link.title') }}" class="source-github">
+<a href="{{ page.edit_url }}" title="{{ lang.t('source.link.title') }}" class="source-github">
     <div class="md-source__icon md-icon">
         {% include ".icons/fontawesome/brands/github-alt.svg" %}
     </div>