book-notes/make.js at master · philc/book-notes · GitHub

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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
#!/usr/bin/env deno run --allow-read --allow-write --allow-env --allow-run
// This generates the website which displays all of the notes.

import { micromark } from "npm:micromark";
import { gfm, gfmHtml } from "npm:micromark-extension-gfm";
import * as path from "@std/path";
import * as fs from "@std/fs";
import * as mustache from "https://deno.land/x/mustache@v0.3.0/mod.ts";
import { abort, desc, run, shCapture, task } from "https://deno.land/x/drake@v1.7.0/mod.ts";

const buildDir = "dist";

async function generatePage(path) {
  const bytes = await Deno.readFile(path);
  let str = (new TextDecoder("UTF-8")).decode(bytes);

  let html = micromark(str, {
    extensions: [gfm()],
    htmlExtensions: [gfmHtml()],
  });

  // We replace mdashes and ellipses, but do so only on text not in a code block. This code block
  // detection is an imperfect but simple approach.
  let lines = html.split("\n");
  let inCodeBlock = false;
  lines = lines.map((line) => {
    if (line.includes("</code>")) {
      inCodeBlock = false;
    } else if (line.includes("<code>")) {
      inCodeBlock = true;
    }
    if (inCodeBlock) return line;

    line = line.replaceAll(" --", " &mdash;");
    line = line.replaceAll("...", "&hellip;");
    return line;
  });

  return lines.join("\n");
}

async function wrapInLayout(html, title) {
  return await mustache.renderFile("website/layout.html", { title: title, body: html });
}

function slug(filename) {
  return path.basename(filename)
    .replaceAll(" - ", "-") // Collapse into one dash
    .replaceAll(" ", "-")
    .replace(".md", ".html");
}

async function processPages(files) {
  if (!(await fs.exists(buildDir))) {
    await Deno.mkdir(buildDir, { recursive: true });
  }
  for (const file of files) {
    let html = await generatePage(file);
    const match = html.match(/<h1>(.+)<\/h1>/);
    if (match == null) {
      throw new Error("Title not found in " + file);
    }
    const title = match[1];
    // Remove the title from the HTML so we can treat it separately.
    html = html.replace(match[0], "");
    html = await wrapInLayout(html, title);
    const dest = path.join(buildDir, slug(file));
    await Deno.writeTextFile(dest, html);
  }

  const resources = ["styles.css", "favicon.png", "github.svg", "robots.txt"];
  for (const file of resources) {
    await Deno.copyFile(path.join("website", file), path.join(buildDir, file));
  }
}

function capitalize(str) {
  return str.charAt(0).toUpperCase() + str.slice(1);
}

async function getTitleFromFile(filename) {
  // Pull out the value of the <h1> tag, which will have the proper title capitalization.
  const text = await Deno.readTextFile(path.join(buildDir, filename));
  const match = text.match(/<h1>(.+)<\/h1>/s);
  if (!match || match.length < 2) {
    throw new Error("h1 title not found in " + filename);
  }
  return match[1];
}

async function createIndex(files) {
  if (!(await fs.exists(buildDir))) {
    await Deno.mkdir(buildDir, { recursive: true });
  }

  const filesByCategory = {};
  for (const file of files) {
    const category = file.split("/")[0];
    const list = filesByCategory[category] ?? [];
    list.push(file);
    filesByCategory[category] = list;
  }
  const html = [];
  for (const [category, list] of Object.entries(filesByCategory)) {
    html.push(`<h2>${capitalize(category)}</h2>`);
    html.push("<ul>");
    for (const file of list) {
      const path = slug(file);
      const title = await getTitleFromFile(path);
      html.push(`<li><a href="${path}">${title}</a></li>`);
    }
    html.push("</ul>");
  }
  let htmlStr = html.join("\n");
  htmlStr = await wrapInLayout(htmlStr, "Book Notes");
  // Label this as the index page, so we can style it differently in CSS.
  if (!htmlStr.includes("<body>")) {
    throw new Error("Error styling <body> when bulding the index page.");
  }
  htmlStr = htmlStr.replace("<body>", '<body id="index-page">');
  // Use a plain title without the "- Book Notes" suffix.
  htmlStr = htmlStr.replace(/<title>.+?<\/title>/, "<title>Book Notes</title>");
  await Deno.writeTextFile(path.join(buildDir, "index.html"), htmlStr);
}

desc("Create the website");
task("website", [], async () => {
  // TODO(philc): For now, these are hard-coded. Once I've reviewed all of the notes, just list all
  // files in each category.
  const files = [
    "architecture/suburban nation - andres duany.md",
    "business/7 powers - hamilton helmer.md",
    "business/better simpler strategy - felix oberholzer-gee.md",
    "business/creativity inc - ed catmull.md",
    "business/founders - jimmy soni.md",
    "business/it doesnt have to be crazy at work - jason fried.md",
    "business/powerful - patty mccord.md",
    "business/radical candor - kim scott.md",
    "business/slack - tom demarco.md",
    "business/the score takes care of itself - bill walsh.md",
    "business/zero to one - peter thiel.md",
    "engineering/an elegant puzzle - will larson.md",
    "engineering/how big things get done - bent flyvbjerg.md",
    "engineering/mythical man month - fred brooks.md",
    "engineering/shape up - ryan singer.md",
    "engineering/thinking in systems - donella meadows.md",
    "engineering/working in public - nadia eghbal.md",
    "health/simple and sinister - pavel tsatsouline.md",
    "lifestyle/destination earth - nicos hadjicostis.md",
    "lifestyle/how to travel - school of life.md",
    "lifestyle/the dream of solomeo - brunello cucinelli.md",
    "lifestyle/the little book of hygge - meik wiking.md",
    "lifestyle/the psychology of money - morgan housel.md",
    "lifestyle/tidying up - marie kondo.md",
    "lifestyle/vagabonding - rolf potts.md",
    "lifestyle/what is culture for - school of life.md",
    "lifestyle/writing about your life - william zinsser.md",
    "philosophy/a guide to the good life - william irvine.md",
    "philosophy/mans search for meaning - viktor frankl.md",
    "philosophy/stillness is the key - ryan holiday.md",
    "philosophy/the obstacle is the way - ryan holiday.md",
    "psychology/50th law - 50 cent and robert greene.md",
    "psychology/deep work - cal newport.md",
    "psychology/digital minimalism - cal newport.md",
    "psychology/four thousand weeks - oliver burkeman.md",
    "psychology/meditations for mortals - oliver burkeman.md",
    "psychology/principles - ray dalio.md",
    "psychology/reinforcements - heidi grant.md",
    "psychology/relentless - tim grover.md",
    "relationships/arguments - alain de botton.md",
    "relationships/bringing up bebe - pamela druckerman.md",
    "relationships/for men only - shaunti and jeff feldhahn.md",
    "relationships/for women only - shaunti feldhahn.md",
    "relationships/how to raise an adult - julie lythcott-haims.md",
    "relationships/how to talk so kids will listen - adele faber.md",
    "relationships/now say this - heather turgeon.md",
    "relationships/playful parenting - lawrence cohen.md",
    "relationships/the happy sleeper - heather turgeon.md",
    "relationships/the mans guide to women - john gottman and julie schwartz gottman.md",
    "relationships/the school of life - alain de botton.md",
  ];
  await processPages(files);
  await createIndex(files);
});

desc("Publish to GitHub Pages");
task("gh-pages", ["website"], async () => {
  const ensure = async (command) => {
    const result = await shCapture(command);
    if (result.code != 0) {
      throw new Error("Command failed: " + command);
    }
    return result;
  };

  let result = await ensure("git status --porcelain");
  if (result.output.trim().length > 0) {
    throw new Error("There are unstaged changes or untracked files in the repo.");
  }

  await ensure("git checkout gh-pages");
  // Preserve the CNAME file that allows this page to be hosted on a custom subdomain.
  await ensure("mv docs/CNAME ./");
  await ensure("rm -f docs/*");
  await ensure("cp dist/* docs/");
  await ensure("mv CNAME docs/");
  await ensure("git add docs");
  await ensure("git commit -a -m 'Update website'");
  await ensure("git push");
  await ensure("git checkout master");
});

run();