chore: small tweakings of the Markdown viewer

Author: mmanciop

templates/registry/markdown/entity_readme.md.j2

@@ -21,10 +21,9 @@ Currently, the following namespaces exist:
 | Namespace | Entity | Stability |
 | --------- | ------ | --------- |
 {%- for bundle in ctx %}
-| {{ bundle.id | title_case | acronym }} | | |
 {%- for group in bundle.groups | sort(attribute='name') -%}
     {%- set my_file_name = bundle.id | kebab_case ~ ".md#" ~ (group.name | kebab_case) %}
-| | [{{ group.name }}]({{my_file_name}}) | {{ stability.badge(group.stability, group.deprecated) | trim }} |
+| {{ bundle.id | title_case | acronym if loop.first }} | [{{ group.name }}]({{my_file_name}}) | {{ stability.badge(group.stability, group.deprecated) | trim }} |
 {%- endfor %}
 {%- endfor %}
 

templates/registry/markdown/event_readme.md.j2

@@ -19,9 +19,8 @@ Currently, the following namespaces exist:
 | Namespace | Event | Stability |
 | --------- | ----- | --------- |
 {%- for bundle in ctx %}
-| {{ bundle.id | title_case | acronym }} | | |
 {%- for group in bundle.groups | sort(attribute='name') -%}
     {%- set my_file_name = bundle.id | kebab_case ~ ".md#" ~ (group.name | kebab_case) %}
-| | [{{ group.name }}]({{my_file_name}}) | {{ stability.badge(group.stability, group.deprecated) | trim }} |
+| {{ bundle.id | title_case | acronym if loop.first }} | [{{ group.name }}]({{my_file_name}}) | {{ stability.badge(group.stability, group.deprecated) | trim }} |
 {%- endfor %}
 {%- endfor %}

templates/registry/markdown/index.html.j2

@@ -258,32 +258,44 @@
 (function() {
   const content = document.getElementById('content');
 
-  function loadPage(path) {
+  function loadPage(path, fragment) {
     fetch(path)
       .then(r => { if (!r.ok) throw new Error(r.status); return r.text(); })
       .then(md => {
         content.innerHTML = marked.parse(md);
         // Rewrite .md links to hash links
         content.querySelectorAll('a[href]').forEach(a => {
           const href = a.getAttribute('href');
-          if (href && href.endsWith('.md') && !href.startsWith('http')) {
-            const base = path.substring(0, path.lastIndexOf('/') + 1);
-            const resolved = new URL(href, location.origin + '/' + base).pathname.replace(/^\//, '');
-            a.setAttribute('href', '#' + resolved);
+          if (href && !href.startsWith('http')) {
+            const match = href.match(/^(.+\.md)(#.*)?$/);
+            if (match) {
+              const base = path.substring(0, path.lastIndexOf('/') + 1);
+              const resolved = new URL(match[1], location.origin + '/' + base).pathname.replace(/^\//, '');
+              a.setAttribute('href', '#' + resolved + (match[2] || ''));
+            }
           }
         });
         // Update active nav link
         document.querySelectorAll('nav a').forEach(a => {
           a.classList.toggle('active', a.getAttribute('href') === '#' + path);
         });
+        if (fragment) {
+          const el = document.getElementById(fragment);
+          if (el) { el.scrollIntoView(); return; }
+        }
         window.scrollTo(0, 0);
       })
       .catch(() => { content.innerHTML = '<p>Page not found.</p>'; });
   }
 
   function onHashChange() {
-    const path = location.hash.slice(1) || 'README.md';
-    loadPage(path);
+    const raw = location.hash.slice(1) || 'README.md';
+    const parts = raw.match(/^(.+\.md)(?:#(.*))?$/);
+    if (parts) {
+      loadPage(parts[1], parts[2]);
+    } else {
+      loadPage(raw);
+    }
   }
 
   window.addEventListener('hashchange', onHashChange);

templates/registry/markdown/metric_readme.md.j2

@@ -20,9 +20,8 @@ Currently, the following namespaces exist:
 {%- import 'stability.j2' as stability -%}
 {%- import 'metric_macros.j2' as metrics -%}
 {%- for bundle in ctx %}
-| {{ bundle.id | title_case | acronym }} | | | | |
 {%- for group in bundle.groups | sort(attribute='metric_name') -%}
     {%- set my_file_name = bundle.id | kebab_case ~ ".md#" ~ (group.metric_name | kebab_case) %}
-| | [{{ group.metric_name }}]({{my_file_name}}) | {{ metrics.instrument(group.instrument) | trim }} | `{{ group.unit }}` | {{ stability.badge(group.stability, group.deprecated) | trim }} |
+| {{ bundle.id | title_case | acronym if loop.first }} | [{{ group.metric_name }}]({{my_file_name}}) | {{ metrics.instrument(group.instrument) | trim }} | `{{ group.unit }}` | {{ stability.badge(group.stability, group.deprecated) | trim }} |
 {%- endfor %}
 {%- endfor %}