.phpdoc/template/: Redo external links to GitHub using JS

Author: adriendupuis

tools/php_api_ref/.phpdoc/template/base.html.twig

@@ -6,6 +6,7 @@
     {{ parent() }}
 
     <script>
+        window.symfonyVersion = '5.4';
         window.addEventListener('keyup', (event) => {
             if (event.key === '/') {
                 event.stopImmediatePropagation();

tools/php_api_ref/.phpdoc/template/class.html.twig

@@ -8,7 +8,7 @@
 
 {% block content %}
     {% include 'components/breadcrumbs.html.twig' %}
-    {% include 'components/class-title.html.twig' with { symfony_version: symfony_version } %}
+    {% include 'components/class-title.html.twig' %}
     {% include('components/element-header.html.twig') %}
     {% include 'components/constants.html.twig' %}
     {% include 'components/properties.html.twig' %}

tools/php_api_ref/.phpdoc/template/components/class-title.html.twig

@@ -14,14 +14,7 @@
 
         {% if node.parent %}
             <div class="content-header__subheader">
-                {% if node.parent.__toString starts with '\\Symfony\\' %}
-                    Extends
-                    <a href="{{ 'https://github.com/symfony/symfony/blob/' ~ symfony_version ~ '/src' ~ node.parent|replace({'\\': '/'}) ~ '.php' }}" class="external">
-                        <abbr title="{{ node.parent }}">{{ node.parent.name }}</abbr>
-                    </a>
-                {% else %}
-                    Extends {{ node.parent|route('class:short') }}
-                {% endif %}
+                Extends {{ node.parent|route('class:short') }}
             </div>
         {% endif %}
 

tools/php_api_ref/.phpdoc/template/js/external-links.js

@@ -0,0 +1,10 @@
+$(() => {
+    $('abbr').each((index, element) => {
+        let $this = $(element);
+        let fqcn = $this.attr('title');
+        if (fqcn.startsWith('\\Symfony\\') && 'a' != $this.parent().prop('tagName')) {
+            let href = 'https://github.com/symfony/symfony/blob/' + symfonyVersion + '/src' + fqcn.replaceAll('\\', '/') + '.php';
+            $this.wrap('<a href="' + href + '" class="external">');
+        }
+    });
+})

tools/php_api_ref/.phpdoc/template/layout.html.twig

@@ -68,5 +68,6 @@
     <script src="js/search_custom.js"></script>
     <script src="js/copy_to_clipboard.js"></script>
     <script src="js/version_switcher_custom.js"></script>
+    <script src="js/external-links.js"></script>
 </body>
 </html>

tools/php_api_ref/.phpdoc/template/trait.html.twig

@@ -8,7 +8,7 @@
 
 {% block content %}
     {% include 'components/breadcrumbs.html.twig' %}
-    {% include 'components/trait-title.html.twig' with { symfony_version: symfony_version } %}
+    {% include 'components/trait-title.html.twig' %}
     {% include('components/element-header.html.twig') %}
     {% include 'components/constants.html.twig' %}
     {% include 'components/properties.html.twig' %}