add "fixture flowchart" to docs (#4440)

- add "fixture flowchart wizard" to docs - added source `.sketch` file to repo - enabled skip of supporter image download in 11ty via env var `MOCHA_DOCS_SKIP_IMAGE_DOWNLOAD` for faster iteration - made the links underline on hover - Ref: #4308 Signed-off-by: Christopher Hiller <[email protected]>
mochajs · Oct 12, 2020 · 478ca6a · 478ca6a
1 parent 9c28990
commit 478ca6a
Show file tree

Hide file tree

Showing 5 changed files with 487 additions and 25 deletions.
diff --git a/assets/mocha-fixture-wizard.sketch b/assets/mocha-fixture-wizard.sketch
diff --git a/docs/_data/supporters.js b/docs/_data/supporters.js
@@ -99,32 +99,40 @@ const nodeToSupporter = node => ({
   categories: node.fromAccount.categories
 });
 
-const fetchImage = async supporter => {
-  try {
-    const {avatar: url} = supporter;
-    const {body: imageBuf, headers} = await needle('get', url, {timeout: 2000});
-    if (headers['content-type'].startsWith('text/html')) {
-      throw new TypeError('received html and expected a png; outage likely');
+const fetchImage = process.env.MOCHA_DOCS_SKIP_IMAGE_DOWNLOAD
+  ? async supporter => {
+      invalidSupporters.push(supporter);
     }
-    debug('fetched %s', url);
-    const canvasImage = await loadImage(imageBuf);
-    debug('ok %s', url);
-    supporter.dimensions = {
-      width: canvasImage.width,
-      height: canvasImage.height
+  : async supporter => {
+      try {
+        const {avatar: url} = supporter;
+        const {body: imageBuf, headers} = await needle('get', url, {
+          timeout: 2000
+        });
+        if (headers['content-type'].startsWith('text/html')) {
+          throw new TypeError(
+            'received html and expected a png; outage likely'
+          );
+        }
+        debug('fetched %s', url);
+        const canvasImage = await loadImage(imageBuf);
+        debug('ok %s', url);
+        supporter.dimensions = {
+          width: canvasImage.width,
+          height: canvasImage.height
+        };
+        // debug('dimensions %s %dw %dh', url, canvasImage.width, canvasImage.height);
+        const filePath = resolve(SUPPORTER_IMAGE_PATH, supporter.id + '.png');
+        await writeFile(filePath, imageBuf);
+        debug('wrote %s', filePath);
+      } catch (err) {
+        console.error(
+          `failed to load ${supporter.avatar}; will discard ${supporter.tier} "${supporter.name} (${supporter.slug}). reason:\n`,
+          err
+        );
+        invalidSupporters.push(supporter);
+      }
     };
-    // debug('dimensions %s %dw %dh', url, canvasImage.width, canvasImage.height);
-    const filePath = resolve(SUPPORTER_IMAGE_PATH, supporter.id + '.png');
-    await writeFile(filePath, imageBuf);
-    debug('wrote %s', filePath);
-  } catch (err) {
-    console.error(
-      `failed to load ${supporter.avatar}; will discard ${supporter.tier} "${supporter.name} (${supporter.slug}). reason:\n`,
-      err
-    );
-    invalidSupporters.push(supporter);
-  }
-};
 
 /**
  * Retrieves donation data from OC