pdf: generate pdf book version

Author: willcl-ark

Gemfile

@@ -19,6 +19,7 @@ group :jekyll_plugins do
   gem "jekyll-feed", "~> 0.12"
   gem "jekyll-asciidoc", "~> 3.0.0"
   gem "asciidoctor-diagram"
+  gem "asciidoctor-pdf"
   gem 'rouge'
 end
 

Gemfile.lock

@@ -13,6 +13,16 @@ GEM
       rexml
     asciidoctor-diagram-ditaamini (1.0.3)
     asciidoctor-diagram-plantuml (1.2023.10)
+    asciidoctor-pdf (2.3.9)
+      asciidoctor (~> 2.0)
+      concurrent-ruby (~> 1.1)
+      matrix (~> 0.4)
+      prawn (~> 2.4.0)
+      prawn-icon (~> 3.0.0)
+      prawn-svg (~> 0.32.0)
+      prawn-table (~> 0.2.0)
+      prawn-templates (~> 0.1.0)
+      treetop (~> 1.6.0)
     async (2.6.3)
       console (~> 1.10)
       fiber-annotation
@@ -25,6 +35,8 @@ GEM
     console (1.23.2)
       fiber-annotation
       fiber-local
+    css_parser (1.16.0)
+      addressable
     em-websocket (0.5.3)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
@@ -93,6 +105,7 @@ GEM
     listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
+    matrix (0.4.2)
     mdl (0.12.0)
       kramdown (~> 2.3)
       kramdown-parser-gfm (~> 1.1)
@@ -110,12 +123,28 @@ GEM
     parslet (2.0.0)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
+    pdf-core (0.9.0)
     pdf-reader (2.11.0)
       Ascii85 (~> 1.0)
       afm (~> 0.2.1)
       hashery (~> 2.0)
       ruby-rc4
       ttfunk
+    polyglot (0.3.5)
+    prawn (2.4.0)
+      pdf-core (~> 0.9.0)
+      ttfunk (~> 1.7)
+    prawn-icon (3.0.0)
+      prawn (>= 1.1.0, < 3.0.0)
+    prawn-svg (0.32.0)
+      css_parser (~> 1.6)
+      prawn (>= 0.11.1, < 3)
+      rexml (~> 3.2)
+    prawn-table (0.2.2)
+      prawn (>= 1.3.0, < 3.0.0)
+    prawn-templates (0.1.2)
+      pdf-reader (~> 2.0)
+      prawn (~> 2.2)
     public_suffix (5.0.3)
     racc (1.7.1)
     rainbow (3.1.1)
@@ -135,6 +164,8 @@ GEM
     toml (0.3.0)
       parslet (>= 1.8.0, < 3.0.0)
     tomlrb (2.0.3)
+    treetop (1.6.12)
+      polyglot (~> 0.3)
     ttfunk (1.7.0)
     typhoeus (1.4.0)
       ethon (>= 0.9.0)
@@ -148,6 +179,7 @@ PLATFORMS
 
 DEPENDENCIES
   asciidoctor-diagram
+  asciidoctor-pdf
   html-proofer
   jekyll (~> 4.3.2)
   jekyll-asciidoc (~> 3.0.0)

Makefile

@@ -47,8 +47,12 @@ test-after-build: build
 
 build-other-versions:
 	mkdir -p bin
+	## Single page HTML
 	## Set imagesdir to parent_dir/images to work with jekyll build
-	bundle exec asciidoctor -r asciidoctor-diagram -o book.html index.adoc --attribute imagesdir=../images
+	bundle exec asciidoctor -r asciidoctor-diagram -o onboarding-to-bitcoin-core.html index.adoc --attribute imagesdir=../images
 	## Delete non-deterministic asciidoctor output
-	sed -i '/^Last updated /d' book.html
-	mv book.html bin/
+	sed -i '/^Last updated /d' onboarding-to-bitcoin-core.html
+	mv onboarding-to-bitcoin-core.html bin/
+	## PDF version
+	bundle exec asciidoctor -r asciidoctor-pdf -b pdf -r asciidoctor-diagram -o onboarding-to-bitcoin-core.pdf index.adoc --attribute imagesdir=../images
+	mv onboarding-to-bitcoin-core.pdf bin/

index.html

@@ -32,8 +32,10 @@
 <div class="dah_container">
   <div class="dah_card">
     <p><b>Get onboarded</b></p>
-    <p>Read the <a href="bin/book.html">entire onboarding guide</a> in a
+    <p>Read the <a href="./bin/onboarding-to-bitcoin-core.html">entire onboarding guide</a> in a
     convenient single-page format.</p>
+    <p>Or view the <a href="./bin/onboarding-to-bitcoin-core.pdf">entire guide</a>
+    (excluding mermaid charts) as a PDF.</p>
   </div>
 
   <div class="dah_card">