build: implementing standard Fedran project layout

.editorconfig

@@ -0,0 +1,26 @@
+# EditorConfig is awesome: http://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 80
+tab_width = 4
+trim_trailing_whitespace = true
+
+[*.{js,ts}]
+quote_type = double
+
+[*.yaml]
+indent_size = 4
+tab_width = 4
+indent_style = space
+
+[package.json]
+indent_size = 2
+tab_width = 2

.envrc

@@ -0,0 +1,2 @@
+export PATH=$PWD/scripts:$PWD/node_modules/.bin:$PATH
+use flake || use nix

.gitignore

@@ -0,0 +1,13 @@
+*~
+node_modules/
+.direnv/
+tmp/
+build/
+
+.*-swp
+dmoonfire*.pdf
+dmoonfire*.docx
+dmoonfire*.html
+dmoonfire*.mobi
+dmoonfire*.epub
+*.bz2

.prettierignore

@@ -0,0 +1,17 @@
+CHANGELOG.md
+package-lock.json
+yarn.lock
+
+*~
+
+archives/
+build/
+extras/
+others/
+node_modules/
+submissions/
+sample-edits/
+maps/
+.direnv/
+tmp/
+edit/

.woodpecker.yml

@@ -0,0 +1,36 @@
+clone:
+    git:
+        image: woodpeckerci/plugin-git
+        settings:
+            tags: true
+
+pipeline:
+    build:
+        image: registry.gitlab.com/dmoonfire/nix-flake-docker:latest
+        commands:
+            - nix develop --command scripts/build.sh
+        secrets:
+            - gitea_token
+            - git_credentials
+            - s3_bucket
+            - s3_endpoint
+            - s3_access_key_id
+            - s3_secret_access_key
+        when:
+            event: [push, pull_request, tag]
+            tag: v*
+
+    release:
+        image: registry.gitlab.com/dmoonfire/nix-flake-docker:latest
+        commands:
+            - nix develop --command scripts/release.sh
+        secrets:
+            - gitea_token
+            - git_credentials
+            - s3_bucket
+            - s3_endpoint
+            - s3_access_key_id
+            - s3_secret_access_key
+        when:
+            event: push
+            branch: main

chapters/chapter-01.md

@@ -2,34 +2,34 @@
 title: I Will Hurt You Only Once
 date: 2019-11-15
 summary: >
-  Late at night, Gichyòbi is interrupted by his daughter who has questions about Rutejìmo's anger toward his clan. It is up to him to decide if he is going to risk his daughter's future magic to promise her that he would only ever hurt her once.
+    Late at night, Gichyòbi is interrupted by his daughter who has questions about Rutejìmo's anger toward his clan. It is up to him to decide if he is going to risk his daughter's future magic to promise her that he would only ever hurt her once.
 characters:
-  primary:
+    primary:
-    - Gichyòbi
+        - Gichyòbi
-  secondary:
+    secondary:
-    - Rutejìmo
+        - Rutejìmo
-    - Mapábyo
+        - Mapábyo
-    - Kidóri
+        - Kidóri
-    - Nifaópi
+        - Nifaópi
-    - Galdinol (Epigraph)
+        - Galdinol (Epigraph)
 locations:
-  primary:
+    primary:
-    - Wamifuko City
+        - Wamifuko City
 concepts:
-  secondary:
+    secondary:
-    - hichifūma
+        - hichifūma
 organizations:
-  secondary:
+    secondary:
-    - Shimusògo
+        - Shimusògo
 warnings:
-  primary:
+    primary:
-    - Anxiety
+        - Anxiety
-  referenced:
+    referenced:
-    - Physical Abuse
+        - Physical Abuse
-    - Emotional Abuse
+        - Emotional Abuse
 ---
 
-> The strongest magic comes from the deepest trauma. That's the cruel price of magic. --- Galdinol Misfanic, *Civilization, or The Cause for Magic Leaving Our World*
+> The strongest magic comes from the deepest trauma. That's the cruel price of magic. --- Galdinol Misfanic, _Civilization, or The Cause for Magic Leaving Our World_
 
 Gichyòbi yawned as he headed to the front door. Joints in his knees and shoulder popped and cracked from sitting too long. He reached the entrance and pushed it open to let the cold desert air in.
 

commitlint.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+    extends: ["@commitlint/config-conventional"],
+    rules: {
+        "body-max-line-length": [0],
+    },
+};

fedran.json

@@ -25,9 +25,15 @@
         "genres": [
             "Drama"
         ],
+        "state": {
+            "public_source": true,
+            "started_chapters": true,
+            "finished_chapters": true
+        },
         "languages": {
             "miwafu": true
         },
+        "has_dedication": false,
         "git": {
             "http_url": "https://src.mfgames.com/fedran-sources/i-will-hurt-you-only-once.git",
             "branch": "main"

flake.lock

@@ -0,0 +1,58 @@
+{
+  "nodes": {
+    "flake-utils": {
+      "locked": {
+        "lastModified": 1642700792,
+        "narHash": "sha256-XqHrk7hFb+zBvRg6Ghl+AZDq03ov6OshJLiSWOoX5es=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "846b2ae0fc4cc943637d3d1def4454213e203cba",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1643805626,
+        "narHash": "sha256-AXLDVMG+UaAGsGSpOtQHPIKB+IZ0KSd9WS77aanGzgc=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "554d2d8aa25b6e583575459c297ec23750adb6cb",
+        "type": "github"
+      },
+      "original": {
+        "id": "nixpkgs",
+        "ref": "nixos-unstable",
+        "type": "indirect"
+      }
+    },
+    "nixstable": {
+      "locked": {
+        "lastModified": 1622516815,
+        "narHash": "sha256-ZjBd81a6J3TwtlBr3rHsZspYUwT9OdhDk+a/SgSEf7I=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "7e9b0dff974c89e070da1ad85713ff3c20b0ca97",
+        "type": "github"
+      },
+      "original": {
+        "id": "nixpkgs",
+        "ref": "21.05",
+        "type": "indirect"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs",
+        "nixstable": "nixstable"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,28 @@
+{
+  inputs = {
+    nixstable.url = "nixpkgs/21.05";
+    nixpkgs.url = "nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, nixstable, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = nixpkgs.legacyPackages.${system};
+        stable = nixstable.legacyPackages.${system};
+      in {
+        devShell = pkgs.mkShell {
+          buildInputs = [
+            pkgs.epubcheck
+            pkgs.nixfmt
+            pkgs.nodejs-16_x
+            pkgs.pandoc
+            pkgs.pdftk
+            pkgs.python39Full
+            pkgs.python39Packages.weasyprint
+            pkgs.jq
+            pkgs.s3cmd
+          ];
+        };
+      });
+}

matter/about.md

@@ -0,0 +1,11 @@
+---
+title: About D. Moonfire
+---
+
+D. Moonfire is the remarkable intersection of a computer nerd and a scientist. He inherited a desire for learning, endless curiosity, and a talent for being a polymath from both of his parents. Instead of focusing on a single genre, he writes stories and novels in many different settings ranging from fantasy to science fiction. He also throws in the occasional romance or forensics murder mystery to mix things up.
+
+In addition to having a borderline unhealthy obsession with the written word, he is also a developer who loves to code as much as he loves writing.
+
+He lives near Cedar Rapids, Iowa with his wife, numerous pet computers, and a pair of highly mobile things of the male variety.
+
+You can see more work by D. Moonfire at his website at [https://d.moonfire.us/](https://d.moonfire.us/). His fantasy world, Fedran, can be found at [https://fedran.com/](https://fedran.com/).

matter/fedran.md

@@ -0,0 +1,13 @@
+---
+title: Fedran
+---
+
+Fedran is a world caught on the cusp of two great ages.
+
+For centuries, the Crystal Age shaped society through the exploration of magic. Every creature had the ability to affect the world using talents and spells. The only limitation was imagination, will, and the inescapable rules of resonance. But as society grew more civilized, magic became less reliable and weaker.
+
+When an unexpected epiphany seemingly breaks the laws of resonance, everything changed. Artifacts no longer exploded when exposed to spells, but only if they were wrapped in cocoons of steel and brass. The humble fire rune becomes the fuel for new devices, ones powered by steam and pressure. These machines herald the birth of a new age, the Industrial Age.
+
+Now, the powers of the old age struggle against the onslaught of new technologies and an alien way of approaching magic. Either the world will adapt or it will be washed away in the relentless march of innovation.
+
+To explore the world of Fedran, check out [https://fedran.com/](https://fedran.com/). There you'll find stories, novels, character write-ups and more.

matter/legal.md

@@ -0,0 +1,27 @@
+---
+title: Legal
+---
+
+Copyright © 2019 D. Moonfire\
+Some Rights Reserved\
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+
+Cover art by D. Moonfire
+
+All characters, events, and locations are fictitious. Any resemblance to persons, past, present, and future is coincidental and highly unlikely.
+
+This story contains scenes where the primary character and others experience anxiety. There are off-page references to emotional abuse and physical abuse. There is no sexual assault.
+
+Broken Typewriter Press\
+5001 1st Ave SE\
+Ste 105 #243\
+Cedar Rapids, IA 52402
+
+Broken Typewriter Press\
+[https://broken.typewriter.press/](https://broken.typewriter.press/)
+
+{% if (edition.isbn) %}
+ISBN {{edition.isbn}}
+{% endif %}
+
+Version {{edition.version}}

matter/license.md

@@ -0,0 +1,32 @@
+---
+title: License
+---
+
+This book is distributed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license. More info can be found at [https://creativecommons.org/licenses/by-nc-sa/4.0/](https://creativecommons.org/licenses/by-nc-sa/4.0/). This means:
+
+### You are free to:
+
+-   Share — copy and redistribute the material in any medium or format
+-   Adapt — remix, transform, and build upon the material
+
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+
+### Under the following terms:
+
+-   Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+-   NonCommercial — You may not use the material for commercial purposes.
+-   ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
+
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+
+### Preferred Attribution
+
+The preferred attribution for this novel is:
+
+> "I Will Hurt You Only Once" by D. Moonfire is licensed under CC BY-NC-SA 4.0
+
+In the above attribution, use the following links:
+
+-   Flight of the Scions: [https://fedran.com/i-will-hurt-you-only-once/](https://fedran.com/i-will-hurt-you-only-once/)
+-   D. Moonfire: https://d.moonfire.us/
+-   CC BY-NC-SA 4.0: https://creativecommons.org/licenses/by-nc-sa/4.0/

matter/miwafu.html

@@ -0,0 +1,61 @@
+---
+title: Miwāfu
+---
+
+<p>
+    This novel has characters who come from the Mifuno Desert where the native
+    language is Miwāfu. Names in this language are significantly different from
+    English, so here is a short guide on pronunciation and usage.
+</p>
+
+<p>
+    The biggest difference is that every name is gendered, which is identified
+    by the accent on the penultimate syllable. There are three types of accents:
+</p>
+
+<ul>
+    <li>
+        <em>Grave</em> (as in hèru for stallion) is a tiny tick that goes down
+        to the right. The grave accent indicates a masculine aspect, either in
+        physical gender, size, or power. Names with grave accents either end in
+        a lower pitch or the entire word is spoken in a lower tone.
+    </li>
+
+    <li>
+        <em>Macron</em> (for example, hēru for colt) is a bar over the vowel.
+        This is a neuter term, used for many gender-free words or expressions
+        within the language. It is also used for mechanical devices, abstract
+        concepts, and children—both human and beast. Macrons are spoken as a
+        long vowel or drawing out the word just a beat longer than normal.
+    </li>
+
+    <li>
+        <em>Acute</em> (héru for mare) is a tiny tick that goes to the upper
+        right. The acute indicates feminine aspects of the word. It can
+        represent control without power or precision. These words end on a high
+        note or the entire word is spoken in a higher pitch.
+    </li>
+</ul>
+
+<p>
+    The only instances where accents aren’t used is adjectives or indication of
+    ownership. So, if a valley is owned by the clan Shimusògo, it is known as
+    Shimusogo Valley.
+</p>
+
+<p>
+    The names themselves are phonetic. A syllable is always from a consonant
+    cluster to the vowel. For examples: Mi.wā.fu (IPA
+    <span class="ipa">/mi.waː.ɸɯ̥/</span>), Shi.mu.sò.go (<span class="ipa"
+        >/ɕi.mɯ.ꜜso.ɡo/</span
+    >), and De.sò.chu (<span class="ipa">/de.ꜜso.tɕɯ̥/</span>). The only
+    exception is the letter “n” which is considered part of the syllable before
+    it when not followed by a vowel. For example, ga.n.ré.ko (<span class="ipa"
+        >/ɡa.ŋꜛɾe.ko/</span
+    >) and ka.né.ko (<span class="ipa">/ka.ꜛne.ko/</span>).
+</p>
+
+<p>
+    Miwāfu has no capital letters, they are added to satisfy English
+    conventions.
+</p>

matter/pad.html

@@ -0,0 +1 @@
+<br />

matter/title.html

@@ -0,0 +1,15 @@
+---
+title: Title
+---
+
+<div class="title">
+    <div class="title-area">
+        <div class="large">I Will</div>
+        <div class="large">Hurt You</div>
+        <div class="large">Only Once</div>
+    </div>
+
+    <div class="author">D. Moonfire</div>
+
+    <div class="publisher">Broken Typewriter Press &#8226; Cedar Rapids</div>
+</div>

package.json

@@ -0,0 +1,53 @@
+{
+  "name": "i-will-hurt-you-only-once",
+  "version": "0.0.1",
+  "private": true,
+  "description": "\"I Will Hurt You Only Once\" is a story by D. Moonfire.",
+  "author": {
+    "name": "D. Moonfire"
+  },
+  "license": "CC-BY-NC-SA-4.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://src.mfgames.com/fedran-sources/i-will-hurt-you-only-once.git"
+  },
+  "homepage": "https://fedran.com/i-will-hurt-you-only-once/",
+  "scripts": {
+    "build:pdf": "mfgames-writing-format build pdf",
+    "build:epub": "mfgames-writing-format build epub",
+    "build:docx": "mfgames-writing-format build docx",
+    "build": "run-s build:*",
+    "prebuild": "npm run format",
+    "prepare": "husky install"
+  },
+  "dependencies": {
+    "@fedran/writing-hyphen": "^1.0.0",
+    "@fedran/writing-theme": "^4.0.2",
+    "@mfgames-writing/contracts": "^4.4.0",
+    "@mfgames-writing/docx-format": "^1.0.2",
+    "@mfgames-writing/epub2-format": "^2.1.1",
+    "@mfgames-writing/format": "^3.3.1",
+    "@mfgames-writing/guillemet": "^1.0.0",
+    "@mfgames-writing/hyphen-pipeline": "^1.0.2",
+    "@mfgames-writing/liquid-theme": "^2.1.1",
+    "@mfgames-writing/weasyprint-format": "^5.0.4",
+    "markdown-it-multimd-table": "^4.1.3"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^15.0.0",
+    "@commitlint/config-conventional": "^15.0.0",
+    "@semantic-release/changelog": "^6.0.1",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/gitlab": "^7.0.4",
+    "@semantic-release/npm": "^8.0.3",
+    "@semantic-release/release-notes-generator": "^10.0.3",
+    "commitizen": "^2.10.1",
+    "cz-conventional-changelog": "^2.1.0",
+    "husky": "^7.0.2",
+    "markdowny": "^0.2.1",
+    "npm-run-all": "^4.1.5",
+    "prettier": "^2.0.5",
+    "semantic-release": "^18.0.1"
+  }
+}

publication.json

@@ -0,0 +1,119 @@
+{
+    "metadata": {
+        "title": "{{edition.fedran.source.title}}",
+        "author": "D. Moonfire",
+        "language": "en",
+        "theme": "@fedran/writing-theme",
+        "outputDirectory": ".",
+        "outputFilename": "dmoonfire-{{edition.fedran.source.title_slug}}-{{edition.name}}-{{edition.version}}.{{edition.ext}}",
+        "markdown": {
+            "extensions": [
+                {
+                    "package": "markdown-it-multimd-table",
+                    "options": {
+                        "headerless": true
+                    }
+                }
+            ]
+        },
+        "style": {
+            "css": "td { width: 6em; } td[colspan=\"2\"] { width: 12em; }"
+        }
+    },
+    "includes": [
+        {
+            "json": "./fedran.json",
+            "merge": "metadata.fedran"
+        }
+    ],
+    "editions": {
+        "epub": {
+            "format": "@mfgames-writing/epub2-format",
+            "ext": "epub"
+        },
+        "pdf": {
+            "format": "@mfgames-writing/weasyprint-format",
+            "isbn": "",
+            "images": {
+                "grayscale": true,
+                "opaque": true
+            },
+            "ext": "pdf"
+        },
+        "docx": {
+            "format": "@mfgames-writing/docx-format",
+            "ext": "docx"
+        }
+    },
+    "contents": [
+        {
+            "element": "bastard",
+            "source": "matter/title.html",
+            "linear": false,
+            "exclude": {
+                "editions": ["epub", "html"],
+                "toc": true
+            }
+        },
+        {
+            "element": "title",
+            "source": "matter/title.html",
+            "linear": false,
+            "exclude": {
+                "toc": true
+            }
+        },
+        {
+            "element": "legal",
+            "source": "matter/legal.md",
+            "liquid": true,
+            "linear": false
+        },
+        {
+            "element": "toc",
+            "linear": false,
+            "title": "Contents",
+            "exclude": {
+                "editions": ["pdf"]
+            }
+        },
+        {
+            "element": "preface",
+            "source": "matter/miwafu.html",
+            "linear": false
+        },
+        {
+            "element": "chapter",
+            "number": 1,
+            "directory": "chapters",
+            "source": "/^chapter-\\d+.(markdown|md)$/",
+            "start": true,
+            "page": 1,
+            "pipeline": [
+                {
+                    "module": "@mfgames-writing/guillemet"
+                },
+                {
+                    "module": "@fedran/writing-hyphen"
+                },
+                {
+                    "module": "@mfgames-writing/hyphen-pipeline",
+                    "exclude": ["`.*?`", "<code>.*?</code>"]
+                }
+            ]
+        },
+        {
+            "element": "appendix",
+            "source": "matter/about.md"
+        },
+        {
+            "element": "appendix",
+            "source": "matter/fedran.md"
+        },
+        {
+            "element": "appendix",
+            "id": "license",
+            "source": "matter/license.md"
+        }
+    ]
+}

release.config.js

@@ -0,0 +1,38 @@
+module.exports = {
+    branches: ["main"],
+
+    extends: ["@commitlint/config-conventional"],
+    message:
+        "chore(release): v${nextRelease.version} [skip ci]\n\n${nextRelease.notes}",
+
+    plugins: [
+        [
+            "@semantic-release/commit-analyzer",
+
+            {
+                preset: "conventionalcommits",
+            },
+        ],
+        "@semantic-release/release-notes-generator",
+        "@semantic-release/npm",
+        [
+            "@semantic-release/exec",
+            {
+                prepareCmd: "npm run build",
+            },
+        ],
+        "@semantic-release/changelog",
+        "@semantic-release/git",
+
+        [
+            "@semantic-release/gitlab",
+            {
+                assets: [
+                    { path: "*.epub", label: "EPUB2", type: "other" },
+                    { path: "*.pdf", label: "PDF", type: "other" },
+                    { path: "*.docx", label: "DOCX", type: "other" },
+                ],
+            },
+        ],
+    ],
+};

scripts/build.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+# Set up logging.
+log() { echo "🛠️ $(basename $0): $@"; }
+
+# Move into the root folder.
+cd $(dirname $(dirname $0))
+
+# Make sure everything is set up.
+log "setting up project"
+./scripts/setup.sh || exit 1
+
+# Build the project outputs.
+log "building PDF"
+npm run build:pdf || exit 1
+
+log "building EPUB"
+npm run build:epub || exit 1

scripts/check-env-bucket.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# Checks the environment to see if we have all the requisite components needed
+# to upload or download from the S3 bucket.
+
+# Set up logging.
+log() { echo "⚗️ $(basename $0): $@"; }
+
+# Move into the root folder.
+cd $(dirname $(dirname $0))
+
+for i in S3_ACCESS_KEY_ID S3_SECRET_ACCESS_KEY S3_ENDPOINT S3_BUCKET
+do
+  if [ "x${!i}" = "x" ]
+  then
+    log "missing environment variable $i"
+    exit 1
+  fi
+done
+
+if [ ! which s3cmd 2> /dev/null ]
+then
+  log "cannot find 's3cmd' to execute"
+  exit 1
+fi
+
+exit 0

scripts/release.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+# Builds the final versions of the book and then upload the results to various
+# locations.
+
+# Set up logging.
+log() { echo "️🚢 $(basename $0): $@"; }
+
+# Move into the root folder.
+cd $(dirname $(dirname $0))
+
+# Perform the basic environment checks and setup.
+./scripts/setup.sh || exit 1
+./scripts/check-env-bucket.sh || exit 1
+
+# Clean up old versions of the file.
+log "cleaning up prior mess"
+rm -f dmoonfire*
+
+# Perform the release process.
+log "performing semantic release"
+npx semantic-release
+
+# Create a tarball of the output files and upload them to S3.
+if ls dmoonfire* &> /dev/null
+then
+    log "packaging output into a tarball"
+    tar -cjf i-will-hurt-you-only-once.tar.bz2 dmoonfire*
+
+    log "uploading tarball to bucket
+    s3cmd --access_key=$S3_ACCESS_KEY_ID --access_token=$S3_SECRET_ACCESS_KEY --host=$S3_ENDPOINT --host-bucket=$S3_ENDPOINT -P put i-will-hurt-you-only-once.tar.bz2 s3://$AWS_BUCKET || exit 1
+else
+    log "no files to upload"
+fi
+

scripts/setup-fonts.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+# Sets up the fonts for building the PDF output. It doesn't do it if we are not
+# in a CI environment.
+
+# Set up logging.
+log() { echo "✒️ $(basename $0): $@"; }
+
+# Move into the root directory.
+cd $(dirname $(dirname $0))
+
+# We only insert the fonts if we are on a CI server.
+if [ "x$CI" == "x" ]
+then
+  log "not in CI environment, not installing fonts"
+else
+  log "installing fonts"
+  mkdir -p ~/.local/share/fonts
+  cp $(nix-build --no-out-link '<nixpkgs>' -A source-serif-pro)/share/fonts/opentype/*.otf ~/.local/share/fonts
+  cp $(nix-build --no-out-link '<nixpkgs>' -A source-sans-pro)/share/fonts/opentype/*.otf ~/.local/share/fonts
+
+  log "updating font caches"
+  fc-cache
+fi

scripts/setup-node.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+# Installs the required Node packages
+
+# Set up logging.
+log() { echo "📦️ $(basename $0): $@"; }
+
+# Move into the root directory.
+cd $(dirname $(dirname $0))
+
+if [ -d ./node_modules ]
+then
+  log "node_modules already exists"
+else
+  log "setting up node"
+  npm install --ci
+fi

scripts/setup.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+
+# Move into the root folder.
+cd $(dirname $(dirname $0))
+
+# Run the setup commands.
+./scripts/setup-fonts.sh || exit 1
+
+./scripts/setup-node.sh || exit 1