FilesExpand file tree

main

/

build-docs-gallery-nav.mjs

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

47 lines (44 loc) · 2.04 KB

main

/

build-docs-gallery-nav.mjs

Copy path

Top

File metadata and controls

• Code
• Blame

47 lines (44 loc) · 2.04 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

#!/usr/bin/env node

// Rebuilds the Catalog tab's sidebar from catalog-gallery-data.mdx, so counts and grouping

// are generated, not hand-maintained. Adapted from a reference implementation of this same

// transform, re-pointed at this repo's own docs.json.

import fs from "node:fs";

import path from "node:path";

import {

getCatalogTab,

readCatalogGalleryData,

readJson,

resolveDocsRoot,

} from "./docs-catalog-shared.mjs";

export function buildNav(docs) {

const data = readCatalogGalleryData(docs);

const config = readJson(path.join(docs, "docs.json"));

const tab = getCatalogTab(config);

const groups = data.groups.map((g) => {

const items = data.items.filter((i) => i.group === g.id);

const sections = [...new Set(items.map((i) => i.section))];

// Flattening a single section into the group's own page list loses that section's label

// (sync-docs-catalog.mjs's walk() re-derives it from nav depth); only safe when the label

// is the same as the group's, so nothing is lost.

const pages =

sections.length === 1 && sections[0] === g.label

? items.map((i) => i.href.slice(1))

: sections.map((section) => {

const selected = items.filter((i) => i.section === section);

return {

group: section,

tag: String(selected.length),

expanded: false,

pages: selected.map((i) => i.href.slice(1)),

};

});

// Collapsed by default; catalog-gallery.css fills the column with a one-line

// description per group instead (Mintlify's group schema has no description field).

return { group: g.label, tag: String(items.length), expanded: false, pages };

});

tab.groups = [{ group: "Catalog", pages: ["catalog/index", ...groups] }];

fs.writeFileSync(path.join(docs, "docs.json"), JSON.stringify(config, null, 2) + "\n");

console.log(`Rebuilt Catalog nav: ${groups.length} groups, ${data.items.length} items.`);

}

if (import.meta.url === `file://${process.argv[1]}`)

buildNav(resolveDocsRoot(process.argv[2]).docs);