fix: Clean up files in repo (#2963)

BREAKING CHANGE:

- remove built files from git repo.
  - If you need to use the latest version of marked on the web you can use a cdn to get marked.min.js from npm:
  - `https://cdn.jsdelivr.net/npm/marked/marked.min.js`

.gitignore

@@ -3,5 +3,8 @@
 node_modules/
 test/compiled_tests
 public
+lib
 docs/LICENSE.md
 vuln.js
+man/marked.1
+marked.min.js

build-docs.js → docs/build.js

@@ -1,6 +1,7 @@
+/* global marked */
+import '../marked.min.js';
 import { promises } from 'fs';
 import { join, dirname, parse, format } from 'path';
-import { Marked } from './lib/marked.esm.js';
 import { markedHighlight } from 'marked-highlight';
 import { HighlightJS } from 'highlight.js';
 import titleize from 'titleize';
@@ -13,7 +14,7 @@ const outputDir = join(cwd, 'public');
 const templateFile = join(inputDir, '_document.html');
 const isUppercase = str => /[A-Z_]+/.test(str);
 const getTitle = str => str === 'INDEX' ? '' : titleize(str.replace(/_/g, ' ')) + ' - ';
-const marked = new Marked(markedHighlight((code, language) => {
+const markedInstance = new marked.Marked(markedHighlight((code, language) => {
   if (!language) {
     return highlightAuto(code).value;
   }
@@ -24,28 +25,38 @@ async function init() {
   console.log('Cleaning up output directory ' + outputDir);
   await rm(outputDir, { force: true, recursive: true });
   await mkdir(outputDir);
+  console.log(`Copying file ${join(inputDir, 'LICENSE.md')}`);
   await copyFile(join(cwd, 'LICENSE.md'), join(inputDir, 'LICENSE.md'));
+  console.log(`Copying file ${join(outputDir, 'marked.min.js')}`);
+  await copyFile(join(cwd, 'marked.min.js'), join(outputDir, 'marked.min.js'));
   const tmpl = await readFile(templateFile, 'utf8');
   console.log('Building markdown...');
   await build(inputDir, tmpl);
   console.log('Build complete!');
 }
 
+const ignoredFiles = [
+  join(cwd, 'docs', 'build.js'),
+  join(cwd, 'docs', '.eslintrc.json'),
+  join(cwd, 'docs', '_document.html')
+];
+
 async function build(currentDir, tmpl) {
   const files = await readdir(currentDir);
   for (const file of files) {
     const filename = join(currentDir, file);
+    if (ignoredFiles.includes(filename)) {
+      continue;
+    }
     const stats = await stat(filename);
     const { mode } = stats;
     if (stats.isDirectory()) {
-      // console.log('Found directory ' + filename);
       await build(filename, tmpl);
     } else {
-      // console.log('Reading file ' + filename);
       let html = await readFile(filename, 'utf8');
       const parsed = parse(filename);
       if (parsed.ext === '.md' && isUppercase(parsed.name)) {
-        const mdHtml = marked.parse(html);
+        const mdHtml = markedInstance.parse(html);
         html = tmpl
           .replace('<!--{{title}}-->', getTitle(parsed.name))
           .replace('<!--{{content}}-->', mdHtml);
@@ -55,7 +66,6 @@ async function build(currentDir, tmpl) {
       }
       parsed.dir = parsed.dir.replace(inputDir, outputDir);
       const outfile = format(parsed);
-      // console.log('Ensure directory ' + dirname(outfile));
       await mkdir(dirname(outfile), { recursive: true });
       console.log('Writing file ' + outfile);
       await writeFile(outfile, html, { mode });

docs/demo/demo.css

@@ -5,6 +5,7 @@ html, body {
 	color: #333;
 	background-color: #fbfbfb;
 	height: 100%;
+	overflow: auto;
 }
 
 textarea {