feat(api): Fix API reference tag-based section template

.claude/agents/ts-component-dev.md

@@ -197,7 +197,7 @@ assets/js/
 │   ├── api-nav.ts             # API navigation behavior
 │   ├── api-toc.ts             # Table of contents
 │   ├── api-tabs.ts            # Tab switching
-│   └── api-scalar.ts          # Scalar/RapiDoc integration
+│   └── api-rapidoc.ts         # RapiDoc integration
 └── utils/
     ├── dom-helpers.ts         # Shared DOM utilities
     └── debug-helpers.js       # Debugging utilities

.claude/skills/hugo-template-dev/SKILL.md

@@ -345,7 +345,7 @@ assets/
 │   │   ├── api-nav.ts             # API navigation behavior
 │   │   ├── api-toc.ts             # Table of contents
 │   │   ├── api-tabs.ts            # Tab switching (if needed beyond CSS)
-│   │   └── api-scalar.ts          # Scalar/RapiDoc integration
+│   │   └── api-rapidoc.ts         # RapiDoc integration
 │   └── utils/
 │       └── dom-helpers.ts         # Shared DOM utilities
 └── styles/

api-docs/scripts/generate-openapi-articles.ts

@@ -159,7 +159,7 @@ interface GeneratePagesOptions {
  * Generate Hugo content pages from article data
  *
  * Creates markdown files with frontmatter from article metadata.
- * Each article becomes a page with type: api that renders via Scalar.
+ * Each article becomes a page with type: api that renders via RapiDoc.
  *
  * @param options - Generation options
  */
@@ -689,7 +689,7 @@ ${yaml.dump(frontmatter)}---
 const productConfigs: ProductConfigMap = {
   // TODO: v2 products (cloud-v2, oss-v2) are disabled for now because they
   // have existing Redoc-based API reference at /reference/api/
-  // Uncomment when ready to migrate v2 products to Scalar
+  // Uncomment when ready to migrate v2 products to RapiDoc
   // 'cloud-v2': {
   //   specFile: path.join(API_DOCS_ROOT, 'influxdb/cloud/v2/ref.yml'),
   //   pagesDir: path.join(DOCS_ROOT, 'content/influxdb/cloud/api'),

assets/js/components/api-toc.ts

@@ -131,7 +131,7 @@ function buildOperationsTocHtml(operations: OperationMeta[]): string {
   let html = '<ul class="api-toc-list api-toc-list--operations">';
 
   operations.forEach((op) => {
-    // Generate anchor ID from operationId (Scalar uses operationId for anchors)
+    // Generate anchor ID from operationId (RapiDoc uses operationId for anchors)
     const anchorId = op.operationId;
     const methodClass = getMethodClass(op.method);
 

layouts/_default/api.html

@@ -10,8 +10,8 @@
   (api/section.html, api/list.html, api/single.html) should be preferred.
 */}}
 
-{{/* Section pages should render content directly, not use RapiDoc */}}
-{{ if .IsSection }}
+{{/* Section pages without staticFilePath should render content directly, not use RapiDoc */}}
+{{ if and .IsSection (not .Params.staticFilePath) }}
 
 {{ partial "header.html" . }}
 {{ partial "topnav.html" . }}
@@ -54,7 +54,7 @@ <h4 class="api-toc-header">ON THIS PAGE</h4>
 {{ partial "footer.html" . }}
 
 {{ else }}
-{{/* Non-section pages with staticFilePath use RapiDoc renderer */}}
+{{/* Pages with staticFilePath (operation pages) use RapiDoc renderer */}}
 
 {{ partial "header.html" . }}
 {{ partial "topnav.html" . }}