make: cleanup builds

Previously we used additional attributes in the makefile.
Switch these out into new index_*.adoc files so they are easier to
reason about and build natively from the command line.

Author: willcl-ark

Makefile

@@ -50,16 +50,16 @@ html:
 	mkdir -p bin
 	## Single page HTML
 	## Set imagesdir to parent_dir/images to work with jekyll build
-	bundle exec asciidoctor --attribute imagesdir=./images --attribute mermaid-format=svg -r asciidoctor-diagram -o onboarding-to-bitcoin-core.html index.adoc
+	bundle exec asciidoctor -r asciidoctor-diagram -o onboarding-to-bitcoin-core.html index.adoc
 	## Delete non-deterministic asciidoctor output
 	sed -i '/^Last updated /d' onboarding-to-bitcoin-core.html
 	mv onboarding-to-bitcoin-core.html bin/
 	cp -r images bin/
 
 pdf:
-	bundle exec asciidoctor --attribute imagesdir=./images --attribute mermaid-format=png -r asciidoctor-pdf -b pdf -r asciidoctor-diagram -o onboarding-to-bitcoin-core.pdf index.adoc
+	bundle exec asciidoctor -r asciidoctor-pdf -b pdf -r asciidoctor-diagram -o onboarding-to-bitcoin-core.pdf index_pdf.adoc
 	mv onboarding-to-bitcoin-core.pdf bin/
 
 epub:
-	asciidoctor -b epub3 -r asciidoctor-epub3 -r asciidoctor-diagram --attribute mermaid-format=png --attribute doctype=book index.adoc
+	asciidoctor -b epub3 -r asciidoctor-epub3 -r asciidoctor-diagram -o index.epub index_epub.adoc
 	mv index.epub bin/onboarding-to-bitcoin-core.epub

_config.yml

@@ -72,6 +72,7 @@ mermaid:
 # their entries' file path in the `include:` list.
 exclude:
   - .jekyll-cache/
+  - all_chapters.adoc
   - 01_overview-and-development.adoc
   - 02_architecture.adoc
   - 03_consensus-and-validation.adoc
@@ -84,7 +85,8 @@ exclude:
   - 10_rpc.adoc
   - asciidoc_workflow.adoc
   - index.adoc
-  - old.index.adoc
+  - index_pdf.adoc
+  - index_epub.adoc
   - settings.adoc
   - README.adoc
   - book.html

all_chapters.adoc

@@ -0,0 +1,23 @@
+include::01_overview-and-development.adoc[]
+
+include::02_architecture.adoc[]
+
+include::03_consensus-and-validation.adoc[]
+
+include::04_wallet.adoc[]
+
+include::05_gui.adoc[]
+
+include::06_p2p.adoc[]
+
+include::07_mempool.adoc[]
+
+include::08_script.adoc[]
+
+include::09_build-system.adoc[]
+
+include::10_rpc.adoc[]
+
+include::appendix.adoc[]
+
+include::glossary.adoc[]

index.adoc

@@ -2,28 +2,6 @@
 include::settings.adoc[]
 :leveloffset: +1
 
-include::01_overview-and-development.adoc[]
-
-include::02_architecture.adoc[]
-
-include::03_consensus-and-validation.adoc[]
-
-include::04_wallet.adoc[]
-
-include::05_gui.adoc[]
-
-include::06_p2p.adoc[]
-
-include::07_mempool.adoc[]
-
-include::08_script.adoc[]
-
-include::09_build-system.adoc[]
-
-include::10_rpc.adoc[]
-
-include::appendix.adoc[]
-
-include::glossary.adoc[]
+include::all_chapters.adoc[]
 
 :leveloffset: -1

index_epub.adoc

@@ -0,0 +1,8 @@
+= Onboarding to Bitcoin Core
+include::settings.adoc[]
+:leveloffset: +1
+:mermaid-format: png
+
+include::all_chapters.adoc[]
+
+:leveloffset: -1

index_pdf.adoc

@@ -0,0 +1,8 @@
+= Onboarding to Bitcoin Core
+include::settings.adoc[]
+:leveloffset: +1
+:mermaid-format: png
+
+include::all_chapters.adoc[]
+
+:leveloffset: -1