add support for passing an option to open sections by default

sarahs · sarahs · commit 9236898431f2 · 2022-08-11T11:21:20.000-04:00
diff --git a/script/dev-toc/generate.js b/script/dev-toc/generate.js
@@ -3,6 +3,7 @@
 import fs from 'fs'
 import path from 'path'
 import { execSync } from 'child_process'
+import { program } from 'commander'
 import fpt from '../../lib/non-enterprise-default-version.js'
 import { allVersionKeys } from '../../lib/all-versions.js'
 import { liquid } from '../../lib/render-content/index.js'
@@ -15,6 +16,19 @@ const staticDirName = 'script/dev-toc/static'
 const staticDir = path.posix.join(process.cwd(), staticDirName)
 if (!fs.existsSync(staticDir)) fs.mkdirSync(staticDir)
 
+program
+  .description('Generate a local TOC of the docs website and open it in your browser')
+  .option(
+    '-o, --openSections [product-ids...]',
+    'open sections for one or more product IDs by default (e.g., "-o codespaces pull-requests")'
+  )
+  .parse(process.argv)
+
+const options = program.opts()
+
+const openSections = options.openSections || ''
+const defaultOpenSections = Array.isArray(openSections) ? openSections : [openSections]
+
 main()
 
 async function main() {
@@ -38,6 +52,9 @@ async function main() {
     // Add the tree to the req.context.
     req.context.currentEnglishTree = req.context.siteTree.en[req.context.currentVersion]
 
+    // Add any defaultOpenSections to the context.
+    req.context.defaultOpenSections = defaultOpenSections
+
     // Parse the layout in script/dev-toc/layout.html with the context we created above.
     const outputHtml = await liquid.parseAndRender(layout, Object.assign({}, req.context))
 
diff --git a/script/dev-toc/layout.html b/script/dev-toc/layout.html
@@ -25,7 +25,12 @@ <h2 class="mt-3 mb-3"><abbr>TOC</abbr> for {{ allVersions[currentVersion].versio
 <div/>
 
 {% for productPage in currentEnglishTree.childPages %}
+{% assign productId = productPage.page.relativePath | replace: "/index.md", "" %}
+{% if defaultOpenSections contains productId %}
+<details open class="mb-1"><summary>{{productPage.renderedFullTitle}}</summary>
+{% else %}
 <details class="mb-1"><summary>{{productPage.renderedFullTitle}}</summary>
+{% endif %}
 <ul class="products-list">
 <li title="{{productPage.renderedFullTitle}}" style="margin: 3px 0 0 30px;">
   <a title="{{ productPage.page.documentType }}" href="{{ docsRoot }}{{productPage.href}}">{{ productPage.renderedFullTitle }}</a>
