Command Reference Printable Version

kilburnflyer · February 23, 2026, 12:23pm

Hi,

Has anyone found a way to print out the Command Reference?

It is an excellent resource but it would be good just to have a something physical to flick through rather than having to scroll with a screen.

I have tried various techniques - trying to print the central frame from Chrome and trying my luck with the LLMs to do some magic but can’t get anything that I can turn into a booklet.

I appreciate that some the “pseudo-screenshot” animated code examples are not easily printable but most are static and are printable but generally the remainder of textual and tabular content comes up too large for printing.

I understand the documentation is created using some kind of markdown system - is that correct? Can that system generate a PDF version as well or is it strictly for HTML generation?

Thanks.

ian · February 23, 2026, 12:51pm

Hey @kilburnflyer - I’m sorry the docs don’t print, thanks for letting me know.

Yes, the docs are markdown and built with Hugo. I’m not certain if there is a current/reliable way to make that into a PDF. The repo is here.

I see the weird formatting and space issues. I’m surprised it doesn’t print, I chose Hugo and this theme so it would be flexible.

kilburnflyer · February 23, 2026, 3:48pm

Thanks for your reply - Fom a quick search I see there is some ancient discussion regarding this topic in the Hugo discussion forums - I will a dig a bit deeper.

ian · February 23, 2026, 10:57pm

Let me know!

I’m concerned about this because we did a significant amount of work to put everything in a single place to make it printable, so if we didn’t actually achieve it…

kilburnflyer · March 9, 2026, 9:02pm

Before I give up and try and run Hugo under WSL instead of Windows does anyone know why I might get these errors when trying to run the docs?

PS C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo> hugo version

hugo v0.157.0-7747abbb316b03c8f353fd3be62d5011fa883ee6+extended windows/amd64 BuildDate=2026-02-25T16:38:33Z VendorInfo=gohugoio

PS C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo> hugo server
Watching for changes in C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/archetypes, C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/assets/{docs,images,opengraph}, C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/content/docs, C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/data, C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/layouts/{docs,partials,shortcodes}, C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/static/{screencast,sizzle,snippets}
Watching for config changes in C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo\hugo.toml, C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo\go.mod
Start building sites …
hugo v0.157.0-7747abbb316b03c8f353fd3be62d5011fa883ee6+extended windows/amd64 BuildDate=2026-02-25T16:38:33Z VendorInfo=gohugoio

WARN  calling IsSet with unsupported type "invalid" (<nil>) will always return false.
Built in 810 ms
ERROR error building site: render: [en v1.0.0 guest] failed to render pages: render of "C:/Users/XXXXXX/source/repos/BusPirateDocs/BusPirate-docs-hugo/content/docs/binmode-reference/protocol-air.md" failed: "C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo\layouts\docs\baseof.html:12:8": execute of template failed: template: docs/single.html:12:8: executing "docs/single.html" at <partial (printf "%s/%s" ($.Scratch.Get "pathName") "head.html") .>: error calling partial: "C:\Users\XXXXXX\AppData\Local\hugo_cache\modules\filecache\modules\pkg\mod\github.com\colinwilson\lotusdocs@v0.2.0\layouts\partials\docs\head.html:33:8": execute of template failed: template: _partials/docs/head.html:33:8: executing "_partials/docs/head.html" at <partial (printf "%s/%s" ($.Scratch.Get "pathName") "head/opengraph") .>: error calling partial: "C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo\layouts\partials\docs\head\opengraph.html:10:17": execute of template failed: template: _partials/docs/head/opengraph.html:10:17: executing "_partials/docs/head/opengraph.html" at <partial (printf "%s/%s" ($.Scratch.Get "pathName") "head/get-featured-image.html") .>: error calling partial: "C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo\layouts\partials\docs\head\get-featured-image.html:30:24": execute of template failed: template: _partials/docs/head/get-featured-image.html:30:24: executing "_partials/docs/head/get-featured-image.html" at <$logo.Resize>: error calling Resize: failed to resize image "C:\\Users\\XXXXXX\\source\\repos\\BusPirateDocs\\BusPirate-docs-hugo\\assets\\images\\logos\\logo.png": resize /images/logos/logo.png: image: unknown format
PS C:\Users\XXXXXX\source\repos\BusPirateDocs\BusPirate-docs-hugo>

mbrugman · March 9, 2026, 10:57pm

I remember seeing an error very much like that. (I’m using Ubuntu, not Windows or WSL). Something about a module failing.

I am sorry, but I can’t remember what I did to fix it. I know it was a Google search that got me going, but can’t remember the specifics. It’s been a while

You’re not alone, at least.

kilburnflyer · March 9, 2026, 11:47pm

I was feeling good when after calling:

hugo server

it started downloading lots of modules from github but then that batch of errors started!

Cursory Google search said something about needed “extended” version but already have that.

Will have another stab.

ian · March 10, 2026, 10:27pm

Probably a stray < in proticol-air.md. I’ll have a look.

ian · March 10, 2026, 10:28pm

I also use it exclusively on widows not wsl so it should “just work”.

mbrugman · March 13, 2026, 6:37pm

I spent a few minutes looking at my notes. The only thing I noted was to install “hugo extended version”.

I run Ubuntu on this machine (my daily driver). Checking apt, I see:

$ apt list --installed | grep hugo 

WARNING: apt does not have a stable CLI interface. Use with caution in scripts.

hugo/now 0.147.9 amd64 [installed,local]

I pulled from upstream and verified it runs and serves the docs:

$ hugo serve -D                    
Watching for changes in /home/XXXXX/data/projects/BusPirate-docs-hugo/{archetypes,assets,content,data,layouts,static}
Watching for config changes in /home/XXXXX/data/projects/BusPirate-docs-hugo/hugo.toml, /home/XXXXX/data/projects/BusPirate-docs-hugo/go.mod
Start building sites … 
hugo v0.147.9-29bdbde19c288d190e889294a862103c6efb70bf+extended+withdeploy linux/amd64 BuildDate=2025-06-23T08:22:20Z VendorInfo=gohugoio

WARN  calling IsSet with unsupported type "invalid" (<nil>) will always return false.

                  │  EN  
──────────────────┼──────
 Pages            │  156 
 Paginator pages  │    0 
 Non-page files   │  345 
 Static files     │ 1089 
 Processed images │  121 
 Aliases          │    0 
 Cleaned          │    0 

Built in 2512 ms
Environment: "development"
Serving pages from disk
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at //localhost:1313/ (bind address 127.0.0.1) 
Press Ctrl+C to stop

I remember I had an issue that sounded similar to yours, and I usually keep notes because if I solved something once, I figure it’ll pop up again later.

kilburnflyer · March 13, 2026, 6:56pm

Thanks. Hoping to find some time next week to attack it again.

ian · March 14, 2026, 3:19pm

Sorry for the delay, a bit scattered this week. Based on the error, I believe it is because logo.png was secretly WEBP (first four bytes RIFF). I replaced it with a proper PNG and did a scan for any other assets with the same issue. I pushed the fix.

mbrugman · March 14, 2026, 3:51pm

I remember another detail from my experience.

I originally set hugo up in a VM to try to help docs development separate. Possibly a Windows VM, but not sure. Anyway, I had issues and just installed Hugo and dependencies on the physical machine and it worked.

Linux would know the image was a webp even though extension is png; maybe that was it?

mbrugman · March 14, 2026, 3:57pm

When I spec’d out the system 76, I got 24G of RAM and an extra terabyte of hard drive with the intention of installing seldom used software tools/suites in VMs to try to keep the base/physical machine more stable. I’ve done that for the most part, but have gotten lazier over the years since I purchased it.

henrygab · March 14, 2026, 10:17pm

Technically, RIFF @ 0x0000 is just the ID of the container type (or more accurately, the ID of the chunk).
It could be a gazillion file formats, such as many .WAV files, just by the RIFF. It’s the WEBPVP8 starting at 0x0008 that makes this a WebP image.

Decoding the file format...

RIFF is an ages-old specification Microsoft made to define the .wav file format. The indication of the format of the chunk is at offset 0x0008, which here clearly indicates the file is of type WEBP.

The next three bytes VP8 @ 0x000c are also required for a WebP container, and indicate the main WebP image chunk. The L @ 0x000Findicates this chunk uses lossless compression (would be ` aka 0x20 if lossy compression).

The container’s length field @ 0x0004 show a total file length of 0x0E72 (add offset + field == total file size of 0x0E7A).

The WebP image chunk @ offset 0x0010 gives an additional length of 0x0E66, and thus a next chunk (if any) would start at 0x0E7A.

That’s the file size, so this RIFF container only had a single chunk, which was the lossless WebP image format.

kilburnflyer · March 16, 2026, 12:32pm

Cleared out the files.

Re-installed all the relevant binaries.

Re-cloned the repo.

All working now.