jpw3.com Generation Instructions

This article provides instructions for managing this project in case anything happens to me.

My brother Adrian adriangwest@gmail.com will likely take over my github account and can provide you with my credentials, grant you access to projects, or just get the files to you, but you may have to walk him through the process of logging in to github and changing permissions.

Markdown Source

This project contains source markdown files. It is currently private.

• https://github.com/deliverystack/jpw3

In these three files, set avoid_generation and exclude_from_nav to false, or just delete those lines:

• /life-story/index.md
• /letters/index.md
• /scraps/index.md

HTML Generation

This project contains a Rust program that converts markdown to static HTML.

• https://github.com/deliverystack/jpw3gen

This script shows how to build and run it:

• https://github.com/deliverystack/jpw3gen/blob/main/jpw3gen.sh

If you use that script, you might want to change these variables:

• GEN: Where you installed jpw3gen
• SOURCE: Where you installed the jpw3 project containing markdown files.
• TARGET: Directory for building HTML files.

After you run the script with no command line parameters (or after you run equivalent commands), TARGET should contain the static HTML files, which is basically a self-contained website, which you can host anywhere.

HTML Deployment

If you push the static HTML files in to this project, Vercel should deploy them automatically to jpw3.com. For that, you would need write access to this project.

• https://github.com/deliverystack/vercel

The script for the build process can do that automatically if you pass -d, truncating revision history for all files (which otherwise gets long because generation typically regenerates every file, since each contains the entire navigation).

More Details

This article provides some information about the approach used:

• https://www.jpw3.com/articles/2025/December/static-site.html