jpshackelford.info blog site

This blog is built with love and WASM. We use Bartholomew for the blog engine and Spin for the supporting serverless framework and local app server.

This example has diverged from the base template somewhat in that we use Pico.css instead of bootstrap.

Installation

To use Bartholomew, install Spin.

For MacOS:

Use Homebrew by first adding a tap and then installing spin.

$ brew tap fermyon/tap

$ brew install fermyon/tap/spin

For Linux:

The installer script installs Spin along with a starter set of language templates and plugins:

$ curl -fsSL https://developer.fermyon.com/downloads/install.sh | bash

Once you have run the installer script, it is highly recommended to add Spin to a folder, which is on your path, e.g.:

$ sudo mv spin /usr/local/bin/

See the complete install instructions for source builds and other platforms.

Edit & View Changes

To start your website, run the following command from this directory:

$ spin watch --skip-build

Serving HTTP on address http://127.0.0.1:3000
Available Routes:
  bartholomew: http://127.0.0.1:3000 (wildcard)
  fileserver: http://127.0.0.1:3000/static (wildcard)

Point your web browser to http://localhost:3000/ to preview the site. The watch command will pick up changes as you save them so you only need to refresh the browser rather then restarting spin.

Directory Structure:

• config/site.toml: The main configuration file for the site.
• content/: Markdown files for blog content.
• scripts/ (advanced): Rhai scripts.
• spin.toml: The configuration file for the Spin application.
• static/: Static assets like images, CSS, and downloads.
• templates/: Handlebars templates
• shortcodes/: shortcodes

Point your web browser to http://localhost:3000/ to see the blog site.

Other examples

Other examples of Bartholomew sites are at:

• https://github.com/fermyon/developer
• https://github.com/coderoflagos/bartholomew-sample (See also Opemipo Disu's accompanying article.)

About the License

Content in the following directory trees are licensed under CC0 (see LICENSE for details). To the greatest extent possible, you are free to use this content however you want.

/config
/scripts
/shortcodes
/static/css
/templates

No license is granted for content in the following directory trees (and all others) as this material is copyright John-Mason Shackelford and all rights are reserved.

/content
/static/media