Posting photos

Install the WebP tools once:

brew install webp

To add a photo to a post:

1. AirDrop the iPhone photo to the Mac.
2. From the repository root, run:

bin/add-photo PHOTO POST [NAME]

For example:

bin/add-photo ~/Downloads/IMG_1234.HEIC \
  _posts/workshop/2026-06-14-sensor-logger.md \
  enclosure-test

PHOTO is the HEIC or JPEG from the iPhone. POST is the Markdown post the photo belongs to. The optional NAME becomes the image filename; omit it to use the original photo filename.

3. Paste the Markdown printed by the command into the post. For a Workshop cover photo, paste the printed image: value into the post's front matter.
4. Check all post photos before committing:

bin/check-photos

The importer applies the photo orientation, limits the long edge to 2000 pixels, removes metadata, and writes a WebP to assets/img/posts/<post-slug>/.

If macOS cannot decode a particular HEIC file, export it from Photos as JPEG. For JPEG capture by default, use Settings > Camera > Formats > Most Compatible on the iPhone.

Welcome to GitHub Pages

You can use the editor on GitHub to maintain and preview the content for your website in Markdown files.

Whenever you commit to this repository, GitHub Pages will run Jekyll to rebuild the pages in your site, from the content in your Markdown files.

Markdown

Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for

Syntax highlighted code block

# Header 1
## Header 2
### Header 3

- Bulleted
- List

1. Numbered
2. List

**Bold** and _Italic_ and `Code` text

[Link](url) and ![Image](src)

For more details see GitHub Flavored Markdown.

Jekyll Themes

Your Pages site will use the layout and styles from the Jekyll theme you have selected in your repository settings. The name of this theme is saved in the Jekyll _config.yml configuration file.

Support or Contact

Having trouble with Pages? Check out our documentation or contact support and we’ll help you sort it out.