connorjs / connorjs.github.io

My GitHub Pages

connorjs.github.io

My GitHub Pages website.

Project structure

• decisions - Decision records
• docs - Markdown files for the mdBook site
• packages - npm packages
  • presentations - Reveal.js Markdown presentations
• theme - Theming for mdBook

Getting started

1. Install mdbook: mdBook installation

   cargo install mdbook

   Note: This project does not set up a Cargo.toml. Instead, it assumes a local installation.

2. Preview the book. This will rebuild on changes.

   mdbook serve

3. Explore other mdbook commands in the documentation

4. Build the presentations. You must install npm dependencies first (npm ci).

   npm run build

Publishing

The mdbook GitHub Action deploys the generated static website. It runs mdbook build and uploads the book directory.