.ukulelesongbook docs updating

nomike's Ukulele Songbook is an ever evolving project which will never be finished. New songs will be added from time to time and existing songs will receive corrections and improvements.

The regular variant of the songbook is designed to be updateable and the procedure for doing so is outlined on this page.

Upgrading old generations

The current songbooks are already the third generation of nomike's Ukulele Songbook. If you happen to own an older generation, you need to upgrade to the latest version of your generation first and then follow the unstructions to upgrade to the next generation, which you can then upgrade to it's latest version. The different generations could be distinguished by their cover page as shown below.

Updating

Printing the update

To update your songbook, navigate to your edition below and download the regular variant of the songbook (be sure to choose the edition for your instrument).

On the download page you will find dropdown box where you can select the songs version printed on your songbook (second cover page). This will give you the "print-string".

You can now print the PDF you just downloaded. In the print dialog, select the option to only print specific pages and copy-paste the print string in the field.

It may look similar to this (though this varies with operating system and software you use):

print dialog firefox print dialog ubuntu

Note: While I dont' own a mac to confirm this, it looks like there is no such option in macos's preview app. If you know how to do this in macos, please let me know. In Linux/Ubuntu/Gnome and Windows an option like that is right there.

Merging in the update

Merging the update takes little practice. I figured out this simple algorithm that always works:

To prepare, remove the book rings from your songbook and put it on the table in front of you (the todo-pile). Punch holes in the update-pages and put them face up on a pile to the right of your songbook (the update pile). You will create two more piles on the left. One for the sorted out pages (which you throw away at the end so I'll call it the burn pile) and one for the updated songbook (the done pile).

So at the end you have these piles:

[A] [B] [C] [D]

[A] = Burn pile (face down)
[B] = Done pile (face down)
[C] = Todo pile (face up)
[D] = Update pile (face up)

The steps for the upgrade

Compare the sort order of the top pages on piles [C] and [D].

If the pages on both piles have the same sort order, put the page from pile [C] face down on pile [A] and the page from pile [D] face down on pile [B].

If the pages don't have the same sort order, put the page which comes first face down on pile [B].

Repeat this until piles [C] and [D] are empty.

Pile [A] could no be thrown away, pile [B] contains the updated songbook and you can assemble it back together.

Pseudocode version

If you feel more comfortable reading this as pseudocode, here you are:

while len(C) > 0 or len(D) > 0:
  if C[0].sortorder == D[0].sortorder:
    move C[0] -> A
    move D[0] -> B
  else if C[0].sortorder < D[0].sortorder:
    move C[0] -> B
  else if D[0].sortorder < C[0].sortorder:
    move D[0] -> B

Editions

There are several generations and versions of this songbook. Please click on the images which looks like the cover page of your copy:

Classic

classic songbook

Noble gases - First edition

helium1 neon1
helium1 songbook neon1 songbook

Noble gases - Second edition

helium argon neon xenon
helium songbook argon songbook neon songbook xenon songbook