FilesExpand file tree

 simplify-node-modules

/

allhtml.mjs

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

116 lines (97 loc) · 4.42 KB

 simplify-node-modules

/

allhtml.mjs

Copy path

Top

File metadata and controls

• Code
• Blame

116 lines (97 loc) · 4.42 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

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

// Build all.html by combining the generated toc and apicontent from each

// of the generated html files.

import fs from 'fs';

import buildCSSForFlavoredJS from './buildCSSForFlavoredJS.mjs';

const source = new URL('../../out/doc/api/', import.meta.url);

// Get a list of generated API documents.

const htmlFiles = fs.readdirSync(source, 'utf8')

.filter((name) => name.includes('.html') && name !== 'all.html');

// Read the table of contents.

const toc = fs.readFileSync(new URL('./index.html', source), 'utf8');

// Extract (and concatenate) the toc and apicontent from each document.

let contents = '';

let apicontent = '';

// Identify files that should be skipped. As files are processed, they

// are added to this list to prevent dupes.

const seen = new Set(['all.html', 'index.html']);

for (const link of toc.match(/<a.*?>/g)) {

const href = /href="(.*?)"/.exec(link)[1];

if (!htmlFiles.includes(href) || seen.has(href)) continue;

const data = fs.readFileSync(new URL(`./${href}`, source), 'utf8');

// Split the doc.

const match = /(<\/ul>\s*)?<\/\w+>\s*<\w+ role="main" id="apicontent">/.exec(data);

// Get module name

const moduleName = href.replace(/\.html$/, '');

contents += data.slice(0, match.index)

.replace(/[\s\S]*?id="toc"[^>]*>\s*<\w+>.*?<\/\w+>\s*(<ul>\s*)?/, '')

// Prefix TOC links with current module name

.replace(/<a href="#(?!DEP[0-9]{4})([^"]+)"/g, (match, anchor) => {

return `<a href="#all_${moduleName}_${anchor}"`;

});

apicontent += '<section>' + data.slice(match.index + match[0].length)

.replace(/<!-- API END -->[\s\S]*/, '</section>')

// Prefix all in-page anchor marks with module name

.replace(/<a class="mark" href="#([^"]+)" id="([^"]+)"/g, (match, anchor, id) => {

if (anchor !== id) throw new Error(`Mark does not match: ${anchor} should match ${id}`);

return `<a class="mark" href="#all_${moduleName}_${anchor}" id="all_${moduleName}_${anchor}"`;

})

// Prefix all in-page links with current module name

.replace(/<a href="#(?!DEP[0-9]{4})([^"]+)"/g, (match, anchor) => {

return `<a href="#all_${moduleName}_${anchor}"`;

})

// Update footnote id attributes on anchors

.replace(/<a href="([^"]+)" id="(user-content-fn[^"]+)"/g, (match, href, id) => {

return `<a href="${href}" id="all_${moduleName}_${id}"`;

})

// Update footnote id attributes on list items

.replace(/<(\S+) id="(user-content-fn[^"]+)"/g, (match, tagName, id) => {

return `<${tagName} id="all_${moduleName}_${id}"`;

})

// Prefix all links to other docs modules with those module names

.replace(/<a href="((\w[^#"]*)\.html)#/g, (match, href, linkModule) => {

if (!htmlFiles.includes(href)) return match;

return `<a href="#all_${linkModule}_`;

})

.trim() + '\n';

// Mark source as seen.

seen.add(href);

}

// Replace various mentions of index with all.

let all = toc.replace(/index\.html/g, 'all.html')

.replace('<a href="all.html">', '<a href="index.html">')

.replace('index.json', 'all.json')

.replace('api-section-index', 'api-section-all')

.replace('data-id="index"', 'data-id="all"')

.replace(/<li class="edit_on_github">.*?<\/li>/, '');

// Clean up the title.

all = all.replace(/<title>.*?\| /, '<title>');

// Insert the combined table of contents.

const tocStart = /<!-- TOC -->/.exec(all);

all = all.slice(0, tocStart.index + tocStart[0].length) +

'<details id="toc" open><summary>Table of contents</summary>\n' +

'<ul>\n' + contents + '</ul>\n' +

'</details>\n' +

all.slice(tocStart.index + tocStart[0].length);

// Replace apicontent with the concatenated set of apicontents from each source.

const apiStart = /<\w+ role="main" id="apicontent">\s*/.exec(all);

const apiEnd = all.lastIndexOf('<!-- API END -->');

all = all.slice(0, apiStart.index + apiStart[0].length)

.replace(

'\n</head>',

buildCSSForFlavoredJS(new Set(Array.from(

apicontent.matchAll(/(?<=<pre class="with-)\d+(?=-chars">)/g),

(x) => Number(x[0]),

))) + '\n</head>',

) +

apicontent +

all.slice(apiEnd);

// Write results.

fs.writeFileSync(new URL('./all.html', source), all, 'utf8');

// Validate all hrefs have a target.

const idRe = / id="([^"]+)"/g;

const ids = new Set([...all.matchAll(idRe)].map((match) => match[1]));

const hrefRe = / href="#([^"]+)"/g;

const hrefMatches = all.matchAll(hrefRe);

for (const match of hrefMatches) {

if (!ids.has(match[1])) throw new Error(`link not found: ${match[1]}`);

}