[jsdoc] Add per-release GitHub release-notes link to sidebar

minggangw · minggangw · commit 3d8d9c16cc9a · 2026-06-24T10:19:21.000+08:00
diff --git a/tools/jsdoc/static/styles/jsdoc-default.css b/tools/jsdoc/static/styles/jsdoc-default.css
@@ -211,6 +211,17 @@ samp,
     color: var(--text-soft);
 }
 
+.brand-release-notes {
+    width: fit-content;
+    color: var(--accent-strong);
+    font-size: 0.82rem;
+    font-weight: 700;
+}
+
+.brand-release-notes:hover {
+    text-decoration: underline;
+}
+
 .nav-toggle {
     display: none;
     border: 0;
diff --git a/tools/jsdoc/tmpl/layout.tmpl b/tools/jsdoc/tmpl/layout.tmpl
@@ -19,6 +19,13 @@
     var packageName = packageInfo.name || 'rclnodejs';
     var packageVersion = packageInfo.version || '';
     var packageDescription = packageInfo.description || 'ROS 2 client library for Node.js and TypeScript';
+    var repository = packageInfo.repository;
+    var repositoryUrl = '';
+    if (repository) {
+        var repositoryString = typeof repository === 'string' ? repository : (repository.url || '');
+        repositoryUrl = repositoryString.replace(/^git\+/, '').replace(/^git:\/\//, 'https://').replace(/\.git$/, '');
+    }
+    var releaseNotesUrl = (repositoryUrl && packageVersion) ? repositoryUrl + '/releases/tag/' + packageVersion : '';
 ?>
 <body>
 <div class="site-backdrop"></div>
@@ -34,6 +41,9 @@
                 <?js } ?>
             </a>
             <p class="brand-description"><?js= packageDescription ?></p>
+            <?js if (releaseNotesUrl) { ?>
+            <a class="brand-release-notes" href="<?js= releaseNotesUrl ?>" target="_blank" rel="noopener noreferrer">Release notes &#8599;</a>
+            <?js } ?>
         </div>
 
         <button class="nav-toggle" type="button" aria-expanded="false" aria-controls="site-nav">
