Booklet

[chrisglein]

Use https://github.com/chrisglein/markdown-booklet to create an printable HTML booklet replacement for the Word doc

[brewingcode]

Slick! I added "Skipper Jan Rebec" and it came out great, though I had to fiddle a bit to figure out where to put the page separator, AND I also realized only ONE page separator is allowed (the second was printed as literal text). I cut out the repetitive chords in order to fit the song on two pages.

@chrisglein I did notice the TOC was not updated....is that a manual step?

[chrisglein]

I had to fiddle a bit to figure out where to put the page separator, AND I also realized only page separator is allowed. I cut out the repetitive chords in order to fit the song one two pages.

I think we only one one-page shanties or two-page shanties (left and right facing pages), and not longer. Because that's annoying. If we do need it, we'll figure it out. But from a reader experience perspective, I don't want longer.

@chrisglein I did notice the TOC was not updated....is that a manual step?

Yep, the Table of Contents is manual for now. Could be automated, just hadn't got to it. And it's not high churn, so 🤷‍♂️. Duplication between it and the book yaml isn't ideal but livable.

[brewingcode]

The TOC was just a bit more than trivially annoying because the songs are in alphabetical order, so inserting a new one messes with all the subsequent page numbering. So I need to skip around in the .html to find out where the existing songs ended up, and I just do not understand the order of the pages in the .html.

[brewingcode]

@chrisglein also this PR is based off an incredibly old commit:

commit 571d9b7fa2d939f5fcfd46e3ac6c68089e8f5b18 (chrisglein/master)
Merge: ea6e28e c89245d
Author: Alex <brewingcode@users.noreply.github.com>
Date:   Tue Jul 22 11:08:51 2025 -0700

    Merge pull request #45 from chrisglein/printableSongbook

    Add printable songbooks (version 2)

For instance, it's missing the QR code, and Mingualay Boat Song and South Australia

[chrisglein]

For instance, it's missing the QR code, and Mingualay Boat Song and South Australia

I was going to dig into what was wrong there. I thought I was using a recent branch but apparently not. It's actually pretty trivial to regenerate though; I didn't do any of it by hand.

[chrisglein]

The TOC was just a bit more than trivially annoying because the songs are in alphabetical order, so inserting a new one messes with all the subsequent page numbering. So I need to skip around in the .html to find out where the existing songs ended up, and I just do not understand the order of the pages in the .html.

Why were you editing the html directly? I'd assume you edit book.yaml to insert, contents.md to renumber, and then regenerate. Did that not work?

[brewingcode]

Also a content question: it could be argued that the original lyrics of Skipper Jan Rebec are problematic on this one verse:

Who sleeps with four girls every night.....One red, one yellow, one black, one white

I currently have this as "one up, one down, one left one right" but if you can come up with something saucier yet not racist (and rhymes "night"), feel free to change.

[chrisglein]

For instance, it's missing the QR code, and Mingualay Boat Song and South Australia

I was going to dig into what was wrong there. I thought I was using a recent branch but apparently not. It's actually pretty trivial to regenerate though; I didn't do any of it by hand.

Oh son of a bitch. I forgot to refresh my fork first:

🤦‍♂️

[brewingcode]

contents.md to renumber

Oh whoops, this is the step I was missing. Thanks

[chrisglein]

Oh son of a bitch. I forgot to refresh my fork first:

🤦‍♂️

@brewingcode Hold on pushing any updates until I get this updated. Won't be long.

[chrisglein]

Also a content question: it could be argued that the original lyrics of Skipper Jan Rebec are problematic on this one verse:

Who sleeps with four girls every night.....One red, one yellow, one black, one white

I currently have this as "one up, one down, one left one right" but if you can come up with something saucier yet not racist (and rhymes "night"), feel free to change.

Yep that verse is controversial for like five reasons. Let's replace it. Will ponder.

[chrisglein]

Also a content question: it could be argued that the original lyrics of Skipper Jan Rebec are problematic on this one verse:

Who sleeps with four girls every night.....One red, one yellow, one black, one white

Some variations:

1. Who sleeps with four girls every night.....One up, one down, one left, one right
2. Who sleeps with four folks every night.....Loves them hard then holds them tight
3. Who sleeps with four folks every night.....sneaks out before the morning light
4. Who finds a new bed every night.....his itchy crotch is such a fright
5. (leave it out, as the song has plenty of verses and people can improve their own)

[chrisglein]

Some variations:

1. Who sleeps with four girls every night.....One up, one down, one left, one right
2. Who sleeps with four folks every night.....Loves them hard then holds them tight
3. Who sleeps with four folks every night.....sneaks out before the morning light
4. Who finds a new bed every night.....his itchy crotch is such a fright
5. (leave it out, as the song has plenty of verses and people can improve their own)

I made her laugh with multiple of them, but Jessica chose a mix of 1 and 2, which is to say your edit but with "folks" instead of the eyebrow raising "girls".

[brewingcode]

Looks good to me, the CI error is just some ssh key bullshit that will get fixed when it runs under my own namespace.

Hey you can't blame the English language for not having a good one-syllable word for women. "Gals" comes close, I suppose.

Is the double consonant "four folks" an issue? "six folks" also has some alliteration, but at the end of the words. We'd have to go to "eight folks" for best results.

I say merge it and we can fine-tune the verse later.