This week I’ve published a detailed guide for installing Linux to a USB drive, compatible with UEIF boot, all with minimal changes to the host environment. The full tutorial is hosted on GitHub pages https://install-linux-guides.github.io/usb-uefi-compatible/, the source code and content that builds the tutorial is available for cloning too install-linux-guides/usb-uefi-compatible, and this post will be a bit meta in that I’ll be writing about how I wrote the guide.

This project required that I learn much more about publishing web content in a fashion that is respectful of device/network limitations. After learning about how to utilize HTML picture element for allowing web-browsers a choice of image source, I researched tools for Linux image conversion, then because I had organized pages and images with number prefixes, eg…

_virtual-box/00-create-virtual-machine.md
_virtual-box/01-virtual-machine-storage.md

… which was unnecessary thanks to Jekyll Collection Ordering, I learned about configuring Ranger for bulk renaming via Vim buffers.

Next week I’ll likely pick a slightly easier project to publish so that a bit more time can be dedicated to polishing the tutorial navigation and instructions.