Function updateOrCreateToc

script/update-tocs.js:36–71

(directory)

)

function updateOrCreateToc(directory) {
  const children = fs.readdirSync(directory).filter((subpath) => !subpath.endsWith('index.md'))
  if (!children.length) return

  const tocFile = path.posix.join(directory, 'index.md')

  let content, data

  // If the index.md file already exists, read it (to be updated later).
  if (fs.existsSync(tocFile)) {
    const parsed = readFrontmatter(fs.readFileSync(tocFile, 'utf8'))
    content = parsed.content
    data = parsed.data
  }
  // If the index.md file does not exist, create it.
  else {
    content = ''
    data = {
      title: sentenceCase(path.basename(directory)), // fake the title of the index.md from the directory name
      versions: '*', // default to all versions
    }
  }

  // Add the children - this will default to the alphabetical list of files in the directory.
  data.children = children.map((child) => `/${child.replace('.md', '')}`)

  // Write the file.
  const newContents = readFrontmatter.stringify(content, data, { lineWidth: 10000 })
  fs.writeFileSync(tocFile, newContents)

  // Process any child directories recursively.
  children.forEach((child) => {
    if (child.endsWith('.md')) return
    updateOrCreateToc(path.posix.join(directory, child))
  })
}