Archived
1
0
Fork
You've already forked blog2
0
Another attempt at making a blog, this time with less dependencies.
This repository has been archived on 2026年06月24日. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
  • Makefile 48.5%
  • M4 24.2%
  • Shell 16%
  • CSS 6.4%
  • HTML 4.9%
2026年06月13日 08:45:11 -05:00
LICENSES Licensing 2026年06月06日 15:42:36 -05:00
src MUCH better font flow 2026年06月12日 16:52:24 -05:00
.gitignore First shot at bare bones build system. 2026年06月10日 12:11:35 -05:00
build.sh MUCH better font flow 2026年06月12日 16:52:24 -05:00
Makefile Missed a spot 2026年06月10日 12:50:37 -05:00
package-lock.json MUCH better font flow 2026年06月12日 16:52:24 -05:00
package.json MUCH better font flow 2026年06月12日 16:52:24 -05:00
README.md Documentation architecting. 2026年06月13日 08:45:11 -05:00

Blog

Another attempt at making a blog, this time with less dependencies.

Development

Pre-Requisites

One wants to have the following tools in order to work with this project.

POSIX Compliant Tooling

Have access to a posix compliant shell with the following tools installed:

  • make
  • m4
  • cat
  • sh
  • touch
  • rm
  • mkdir
  • find

See https://pubs.opengroup.org/onlinepubs/9799919799/ for more detail about what should be required, behavior wise, from these tools and what it means to have a posix compliant shell.

Node

Have the following installed:

  • Node v20.19.2
  • npm 9.2.0

The architecture of this project is designed such that node and npm are not essential requirements. To get rid of the node dependency, all you need to do is:

  • Find a dev server solution which can run the static website found in site, i.e. replace the npm run dev command found in package.json.
  • Find a new tex to mathml core compiler and refactor <single script or command> to call that new compiler instead of temml.

fontmake

See: https://github.com/googlefonts/fontmake

I currently use version 3.10.0.

This tool can in principle be easily replaced, one just needs to find a tool that can handle the UFO formatted fonts in src/font and then replace the <whatever command> found in build.sh.

See: https://unifiedfontobject.org/ for the UFO 3 specification (which is what we use here).

I also use FontForge found here: https://fontforge.org/en-US/ in order to orient myself sometimes, but please be certain that I maintain these UFO folders by hand and they are meant to be read and interacted with by hand.

Build

In the shell, run:

  • npm install
  • sh build.sh

This builds the static website in site.

Run Locally

In the shell, run:

  • npm run dev

Cleanup

In the shell, run:

  • rm -rf node_modules
  • make clean_build

This will remove everything that the build steps generated.

Documentation

Pre-Requisites

In order to read and interact with the documentation, one must have the following:

emacs with org mode

TeX Live

Build

  • Run make docs in the shell.

Navigate

  • Check out the index.org. The rest is navigable from there.

Cleanup

  • Run make clean_docs in the shell. This will remove anything that make docs generated.

Licensing

All code is under AGPL as described in LICENSES/agpl.txt and anything else is under CC-BY-SA 4.0 as described in LICENSES/cc-by-sa-4-0.txt.