HaverLab
/
basic-book-builder
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

WIP: v1.1.0

This commit is contained in:
John Haverlack 2026-02-05 13:27:27 -09:00
parent 494d20f469
commit 0bdd903418
15 changed files with 801 additions and 518 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
.obsidian/workspace.json vendored
View File

@ -270,29 +270,32 @@
}, },
"active": "01161538f53367e8", "active": "01161538f53367e8",
"lastOpenFiles": [ "lastOpenFiles": [
"conf/sedO6HWQd", "conf/sedBapyXA",
"conf/sedLQxQGf", "conf/sedYZ2rBJ",
"conf/sedIsN7C4", "conf/sedbEPwZC",
"conf/sed8HHrHm",
"conf/sed0agSpY",
"conf/sed9gY2gw",
"conf/seddo6XG6",
"conf/sedyheY4U",
"conf/seduL1p1z",
"conf/sedltGqhZ",
"conf/sedv2m0sa",
"chapters/01_Getting_Started.md",
"templates/frontmatter-docx.md",
"chapters/00_Introduction.md",
"chapters/AppendixB.md",
"chapters/03_Features.md",
"chapters/02_Usage.md", "chapters/02_Usage.md",
"chapters/01_Getting_Started.md",
"chapters/04_Design.md",
"README.md",
"chapters/00_Introduction.md",
"chapters/04_Design",
"conf/odt.yaml",
"conf/frontmatter-docx.md",
"conf/docx.yaml",
"chapters/03_Features.md",
"conf/sedMSkcEz",
"conf/sedsOEcAe",
"conf/sedwM39Vv",
"conf/sedqNCjeN",
"conf/sedKOEUG1",
"chapters/AppendixA.md",
"templates/frontmatter-docx.md",
"chapters/AppendixB.md",
"chapters/02_Features.md", "chapters/02_Features.md",
"chapters/Preface.md", "chapters/Preface.md",
"chapters/Index.md", "chapters/Index.md",
"chapters/Glossary.md", "chapters/Glossary.md",
"chapters/Bibliography.md", "chapters/Bibliography.md",
"chapters/AppendixA.md",
"chapters/Appendix.md", "chapters/Appendix.md",
"lib/img/unit-circle-with-tau.png", "lib/img/unit-circle-with-tau.png",
"lib/img/unit-circle-with-pi.png.png", "lib/img/unit-circle-with-pi.png.png",
@ -307,14 +310,11 @@
"chapters/Terminology.md", "chapters/Terminology.md",
"chapters/Citations.md", "chapters/Citations.md",
"chapters/Appendix B.md", "chapters/Appendix B.md",
"conf/frontmatter-docx.md",
"build/md/basic-book-builder.md", "build/md/basic-book-builder.md",
"build/basic-book-builder.md", "build/basic-book-builder.md",
"LICENSE.md", "LICENSE.md",
"README.md",
"pm/Book Action Items.md", "pm/Book Action Items.md",
"chapters/Unitfication.md", "chapters/Unitfication.md",
"chapters/03_Cylindrical_Spacetime.md", "chapters/03_Cylindrical_Spacetime.md"
"chapters/07_Consciousness_Continued.md"
] ]
} }

BIN
build/docx/basic-book-builder.docx Normal file
View File

Binary file not shown.

290
build/html/basic-book-builder.html
View File

@ -24,71 +24,6 @@
vertical-align: middle; vertical-align: middle;
} }
.display.math{display: block; text-align: center; margin: 0.5rem auto;} .display.math{display: block; text-align: center; margin: 0.5rem auto;}
/* CSS for syntax highlighting */
html { -webkit-text-size-adjust: 100%; }
pre > code.sourceCode { white-space: pre; position: relative; }
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
pre > code.sourceCode > span:empty { height: 1.2em; }
.sourceCode { overflow: visible; }
code.sourceCode > span { color: inherit; text-decoration: inherit; }
div.sourceCode { margin: 1em 0; }
pre.sourceCode { margin: 0; }
@media screen {
div.sourceCode { overflow: auto; }
}
@media print {
pre > code.sourceCode { white-space: pre-wrap; }
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
}
pre.numberSource code
{ counter-reset: source-line 0; }
pre.numberSource code > span
{ position: relative; left: -4em; counter-increment: source-line; }
pre.numberSource code > span > a:first-child::before
{ content: counter(source-line);
position: relative; left: -1em; text-align: right; vertical-align: baseline;
border: none; display: inline-block;
-webkit-touch-callout: none; -webkit-user-select: none;
-khtml-user-select: none; -moz-user-select: none;
-ms-user-select: none; user-select: none;
padding: 0 4px; width: 4em;
color: #aaaaaa;
}
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
div.sourceCode
{ }
@media screen {
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
}
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
code span.at { color: #7d9029; } /* Attribute */
code span.bn { color: #40a070; } /* BaseN */
code span.bu { color: #008000; } /* BuiltIn */
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
code span.ch { color: #4070a0; } /* Char */
code span.cn { color: #880000; } /* Constant */
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
code span.dt { color: #902000; } /* DataType */
code span.dv { color: #40a070; } /* DecVal */
code span.er { color: #ff0000; font-weight: bold; } /* Error */
code span.ex { } /* Extension */
code span.fl { color: #40a070; } /* Float */
code span.fu { color: #06287e; } /* Function */
code span.im { color: #008000; font-weight: bold; } /* Import */
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
code span.op { color: #666666; } /* Operator */
code span.ot { color: #007020; } /* Other */
code span.pp { color: #bc7a00; } /* Preprocessor */
code span.sc { color: #4070a0; } /* SpecialChar */
code span.ss { color: #bb6688; } /* SpecialString */
code span.st { color: #4070a0; } /* String */
code span.va { color: #19177c; } /* Variable */
code span.vs { color: #4070a0; } /* VerbatimString */
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
/* CSS for citations */ /* CSS for citations */
div.csl-bib-body { } div.csl-bib-body { }
div.csl-entry { div.csl-entry {
@ -205,6 +140,41 @@ Builder</a></li>
<li><a href="#setting-up-build-environment" <li><a href="#setting-up-build-environment"
id="toc-setting-up-build-environment">Setting Up Build id="toc-setting-up-build-environment">Setting Up Build
Environment</a></li> Environment</a></li>
<li><a href="#testing" id="toc-testing">Testing</a></li>
<li><a href="#creating-a-new-project"
id="toc-creating-a-new-project">Creating a New Project</a>
<ul>
<li><a href="#zotero-configuration-optional"
id="toc-zotero-configuration-optional">Zotero Configuration
(Optional)</a></li>
</ul></li>
</ul></li>
<li><a href="#usage" id="toc-usage">Usage</a>
<ul>
<li><a href="#editing-content" id="toc-editing-content">Editing
Content</a></li>
<li><a href="#building" id="toc-building">Building</a>
<ul>
<li><a href="#pdf" id="toc-pdf">PDF</a></li>
<li><a href="#html" id="toc-html">HTML</a></li>
<li><a href="#docx" id="toc-docx">DocX</a></li>
<li><a href="#odt" id="toc-odt">ODT</a></li>
<li><a href="#make-all" id="toc-make-all">Make All</a></li>
</ul></li>
<li><a href="#callouts" id="toc-callouts">Callouts</a></li>
</ul></li>
<li><a href="#appendix-a-build-environment-notes"
id="toc-appendix-a-build-environment-notes">Appendix A: Build
Environment Notes</a>
<ul>
<li><a href="#installing-pre-requisites"
id="toc-installing-pre-requisites">Installing Pre-Requisites</a>
<ul>
<li><a href="#required" id="toc-required">Required</a></li>
<li><a href="#optional" id="toc-optional">Optional</a></li>
</ul></li>
<li><a href="#editing-the-configuration"
id="toc-editing-the-configuration">Editing the Configuration</a></li>
</ul></li> </ul></li>
<li><a href="#glossary" id="toc-glossary">Glossary</a></li> <li><a href="#glossary" id="toc-glossary">Glossary</a></li>
<li><a href="#bibliography" id="toc-bibliography">Bibliography</a></li> <li><a href="#bibliography" id="toc-bibliography">Bibliography</a></li>
@ -230,9 +200,8 @@ href="#ref-JohnHaverlackACEP" role="doc-biblioref"><em>John
<h2 id="cloning-the-basic-book-builder">Cloning the Basic Book <h2 id="cloning-the-basic-book-builder">Cloning the Basic Book
Builder</h2> Builder</h2>
<div class="callout-cli"> <div class="callout-cli">
<p><strong>Cloning the repository</strong></p> <p><strong>Clone the repository</strong></p>
<div class="sourceCode" id="cb1"><pre <pre><code>git clone https://github.com/jehaverlack/basic-book-builder.git</code></pre>
class="sourceCode bash"><code class="sourceCode bash"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="fu">git</span> clone https://github.com/jehaverlack/basic-book-builder.git</span></code></pre></div>
</div> </div>
<div class="callout-cli"> <div class="callout-cli">
<p><strong>Navigate to the repo directory</strong></p> <p><strong>Navigate to the repo directory</strong></p>
@ -240,17 +209,194 @@ class="sourceCode bash"><code class="sourceCode bash"><span id="cb1-1"><a href="
</div> </div>
<h2 id="setting-up-build-environment">Setting Up Build Environment</h2> <h2 id="setting-up-build-environment">Setting Up Build Environment</h2>
<div class="callout-caution"> <div class="callout-caution">
<p><strong>Debian Based Linux</strong></p> <p><strong>~Debian Linux</strong></p>
<p> This script only support Debian based linux system (Debian, Ubunutu, <p> This script only support Debian based Linux system (Debian, Ubunutu,
Zorin, etc) This script has not been widely tested across platforms</p> Zorin, etc) This script has not been widely tested across platforms</p>
</div> </div>
<div class="callout-cli"> <div class="callout-cli">
<p><strong>Setup Build Environment</strong></p> <p><strong>Setup Build Environment</strong></p>
<div class="sourceCode" id="cb3"><pre <pre><code>./scripts/setup-linux-deb.sh</code></pre>
class="sourceCode bash"><code class="sourceCode bash"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="ex">./scripts/setup-linux-deb.sh</span></span></code></pre></div>
</div> </div>
<p>For more information on setting up the build environment for your <p>For more information on setting up the build environment for your
system see Appendix A.</p> system see Appendix A.</p>
<h2 id="testing">Testing</h2>
<p>If you can build all format for the <strong>Basic Book Build</strong>
then you have a working build environment.</p>
<div class="callout-cli">
<p><strong>Testing Build Environment</strong></p>
<pre><code>make all</code></pre>
</div>
<h2 id="creating-a-new-project">Creating a New Project</h2>
<h3 id="zotero-configuration-optional">Zotero Configuration
(Optional)</h3>
<h1 id="usage">Usage</h1>
<h2 id="editing-content">Editing Content</h2>
<h2 id="building">Building</h2>
<h3 id="pdf">PDF</h3>
<pre><code>make pdf</code></pre>
<blockquote>
<p>NOTE: Building the PDF also builds the <strong>LaTeX</strong> version
of the book.</p>
</blockquote>
<h3 id="html">HTML</h3>
<pre><code>make html</code></pre>
<h3 id="docx">DocX</h3>
<pre><code>make docx</code></pre>
<blockquote>
<p>NOTE: DocX is a work in progress. Frontmatter and formatting need
work.</p>
</blockquote>
<h3 id="odt">ODT</h3>
<pre><code>make odt</code></pre>
<blockquote>
<p>NOTE: ODT is a work in progress. Frontmatter and formatting need
work.</p>
</blockquote>
<h3 id="make-all">Make All</h3>
<p>To build all supported formats</p>
<pre><code>make all</code></pre>
<h2 id="callouts">Callouts</h2>
<p>A few callout box styles have been added to easily highlight
content.</p>
<div class="callout-established">
<p><strong>Established Concept</strong></p>
<p> Einsteins Relativistic Dynamics Equations <span
class="math display"><em>E</em><sup>2</sup> = (<em>m</em><sub>0</sub> ⋅ <em>c</em><sup>2</sup>)<sup>2</sup> + (<em>p</em> ⋅ <em>c</em>)<sup>2</sup></span></p>
</div>
<div class="callout-proposed">
<p><strong>Proposed Concept</strong></p>
<p> With the speed of light, <span
class="math inline"><em>c</em> = 1</span>: <span
class="math display"><em>E</em><sup>2</sup> = <em>m</em><sub>0</sub><sup>2</sup> + <em>p</em><sup>2</sup></span></p>
</div>
<div class="callout-speculative">
<p><strong>Speculative Concept</strong></p>
<p> With the speed of light, <span
class="math inline"><em>c</em> = 1</span>: <span
class="math display"><em>E</em><sup>2</sup> = <em>m</em><sub>0</sub><sup>2</sup> + <em>p</em><sup>2</sup></span></p>
</div>
<div class="callout-caution">
<p><strong>Caution Note</strong></p>
<p> Beware of this section.</p>
</div>
<div class="callout-warning">
<p><strong>Warning Note</strong></p>
<p> Beware of this section.</p>
</div>
<div class="callout-danger">
<p><strong>Alerts</strong></p>
<p> Extreme Highlight</p>
</div>
<p>Appendix A</p>
<h1 id="appendix-a-build-environment-notes">Appendix A: Build
Environment Notes</h1>
<h2 id="installing-pre-requisites">Installing Pre-Requisites</h2>
<div class="callout-caution">
<p><strong>Not Cross-platform Tested</strong></p>
<p> For Debian / ZorinOS and likely Ubuntu based systems.</p>
</div>
<h3 id="required">Required</h3>
<h4 id="pandoc">Pandoc</h4>
<ul>
<li>https://pandoc.org/</li>
<li><a
href="https://github.com/jgm/pandoc/releases/tag/3.8.2.1">Download</a></li>
</ul>
<blockquote>
<p><code>sudo apt install https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb</code></p>
</blockquote>
<h4 id="code-editor">Code Editor</h4>
<div class="callout-established">
<p><strong>Code Editor</strong></p>
<p> <a href="https://vscodium.com/">VSCodium</a> is recommend for
privacy (telemetry/tracking) reasons - https://vscodium.com/</p>
</div>
<p>But any text editor will work. #### make</p>
<pre><code>sudo apt install make</code></pre>
<h4 id="jq-and-yq">jq and yq</h4>
<pre><code>sudo apt install jq yq</code></pre>
<h4 id="texlive">texlive</h4>
<blockquote>
<p><code>sudo apt install texlive texlive-xetex texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra</code></p>
</blockquote>
<h4 id="mathjax">MathJax</h4>
<ul>
<li>https://www.mathjax.org/</li>
</ul>
<pre><code>wget https://registry.npmjs.org/mathjax/-/mathjax-3.2.2.tgz
tar xzf mathjax-3.2.2.tgz
mv package/es5/* lib/mathjax
rm -rf package mathjax-3.2.2.tgz</code></pre>
<div class="callout-caution">
<p><strong>TODO</strong></p>
<p> This need to be rolled into a setup script.</p>
</div>
<h3 id="optional">Optional</h3>
<p>The following are not strictly requires to use this book builder
template.</p>
<h4 id="obsidian">Obsidian</h4>
<div class="callout-established">
<p><strong>Highly Recommended</strong></p>
<p> Editing book chapter content in Obsidian is a very productive means
for editing Markdown source content.</p>
</div>
<ul>
<li>https://obsidian.md/</li>
<li><a
href="https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb">Deb
Package</a></li>
</ul>
<pre><code>sudo apt install https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb</code></pre>
<h4 id="zotero">Zotero</h4>
<div class="callout-established">
<p><strong>Highly Recommended</strong></p>
<p> If you need to managed citations and references, Zotero integration
is highly recommended.</p>
</div>
<ul>
<li>https://www.zotero.org/</li>
</ul>
<pre><code>sudo cp ./scripts/deps/zotero.list /etc/apt/sources.list.d/</code></pre>
<pre><code>sudo apt update</code></pre>
<pre><code>sudo apt install zotero</code></pre>
<h5 id="better-bibtex-for-zotero">Better BibTex for Zotero</h5>
<p>Install the Better BibTex Plugin for Zotero - Zotero &gt; Tool &gt;
Plugins</p>
<h5 id="export-citations.bib">Export citations.bib</h5>
<ul>
<li>Zotero &gt; File &gt; Export Library &gt; Format: Better BibTeX</li>
<li><label><input type="checkbox" />Keep Updated</label></li>
<li><label><input type="checkbox" />Save to:
~/Documents/Lib/zotero.bib</label></li>
<li><label><input type="checkbox" />Symlink your
~/Documents/Lib/Citations.bib to
basic-book-builder/lib/zotero.bib</label></li>
</ul>
<h5 id="zotero-connector-browser-plugin">Zotero Connector Browser
Plugin</h5>
<ul>
<li>https://chromewebstore.google.com/detail/zotero-connector/ekhagklcjbdpajgpjgmbionohlpdbjgc</li>
</ul>
<p>Provides you the ability to auto add Web resources to your Zotero
citation database.</p>
<h4 id="lmodern">lmodern</h4>
<pre><code>sudo apt install lmodern</code></pre>
<h4 id="epubcheck">epubcheck</h4>
<pre><code>sudo apt install epubcheck</code></pre>
<h4 id="foliate">foliate</h4>
<p>An EPub Reader</p>
<ul>
<li>https://johnfactotum.github.io/foliate/</li>
</ul>
<pre><code>sudo apt install https://github.com/johnfactotum/foliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb</code></pre>
<h4 id="calibre">calibre</h4>
<p>An EPub Reader</p>
<ul>
<li>https://calibre-ebook.com</li>
</ul>
<pre><code>sudo apt install calibre</code></pre>
<h2 id="editing-the-configuration">Editing the Configuration</h2>
<h1 class="unnumbered" id="glossary">Glossary</h1> <h1 class="unnumbered" id="glossary">Glossary</h1>
<table> <table>
<colgroup> <colgroup>

80
build/latex/basic-book-builder.aux
View File

@ -30,19 +30,85 @@
\newlabel{cloning-the-basic-book-builder}{{2.1}{2}{Cloning the Basic Book Builder}{section.2.1}{}} \newlabel{cloning-the-basic-book-builder}{{2.1}{2}{Cloning the Basic Book Builder}{section.2.1}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.2}Setting Up Build Environment}{2}{section.2.2}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {2.2}Setting Up Build Environment}{2}{section.2.2}\protected@file@percent }
\newlabel{setting-up-build-environment}{{2.2}{2}{Setting Up Build Environment}{section.2.2}{}} \newlabel{setting-up-build-environment}{{2.2}{2}{Setting Up Build Environment}{section.2.2}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.3}Testing}{3}{section.2.3}\protected@file@percent }
\newlabel{testing}{{2.3}{3}{Testing}{section.2.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}\protected@file@percent }
\newlabel{creating-a-new-project}{{2.4}{3}{Creating a New Project}{section.2.4}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}\protected@file@percent }
\newlabel{zotero-configuration-optional}{{2.4.1}{3}{Zotero Configuration (Optional)}{subsection.2.4.1}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {3}Usage}{4}{chapter.3}\protected@file@percent }
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{usage}{{3}{4}{Usage}{chapter.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.1}Editing Content}{4}{section.3.1}\protected@file@percent }
\newlabel{editing-content}{{3.1}{4}{Editing Content}{section.3.1}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.2}Building}{4}{section.3.2}\protected@file@percent }
\newlabel{building}{{3.2}{4}{Building}{section.3.2}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.1}PDF}{4}{subsection.3.2.1}\protected@file@percent }
\newlabel{pdf}{{3.2.1}{4}{PDF}{subsection.3.2.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.2}HTML}{4}{subsection.3.2.2}\protected@file@percent }
\newlabel{html}{{3.2.2}{4}{HTML}{subsection.3.2.2}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.3}DocX}{4}{subsection.3.2.3}\protected@file@percent }
\newlabel{docx}{{3.2.3}{4}{DocX}{subsection.3.2.3}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}\protected@file@percent }
\newlabel{odt}{{3.2.4}{4}{ODT}{subsection.3.2.4}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.5}Make All}{5}{subsection.3.2.5}\protected@file@percent }
\newlabel{make-all}{{3.2.5}{5}{Make All}{subsection.3.2.5}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}\protected@file@percent }
\newlabel{callouts}{{3.3}{5}{Callouts}{section.3.3}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}\protected@file@percent }
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{appendix-a-build-environment-notes}{{A}{6}{Appendix A: Build Environment Notes}{appendix.A}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}\protected@file@percent }
\newlabel{installing-pre-requisites}{{A.1}{6}{Installing Pre-Requisites}{section.A.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}\protected@file@percent }
\newlabel{required}{{A.1.1}{6}{Required}{subsection.A.1.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}\protected@file@percent }
\newlabel{pandoc}{{A.1.1.1}{6}{Pandoc}{subsubsection.A.1.1.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}\protected@file@percent }
\newlabel{code-editor}{{A.1.1.2}{6}{Code Editor}{subsubsection.A.1.1.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}\protected@file@percent }
\newlabel{jq-and-yq}{{A.1.1.3}{7}{jq and yq}{subsubsection.A.1.1.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}\protected@file@percent }
\newlabel{texlive}{{A.1.1.4}{7}{texlive}{subsubsection.A.1.1.4}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}\protected@file@percent }
\newlabel{mathjax}{{A.1.1.5}{7}{MathJax}{subsubsection.A.1.1.5}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}\protected@file@percent }
\newlabel{optional}{{A.1.2}{7}{Optional}{subsection.A.1.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}\protected@file@percent }
\newlabel{obsidian}{{A.1.2.1}{7}{Obsidian}{subsubsection.A.1.2.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}\protected@file@percent }
\newlabel{zotero}{{A.1.2.2}{8}{Zotero}{subsubsection.A.1.2.2}{}}
\newlabel{better-bibtex-for-zotero}{{A.1.2.2.1}{8}{Better BibTex for Zotero}{paragraph.A.1.2.2.1}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}\protected@file@percent }
\newlabel{export-citations.bib}{{A.1.2.2.2}{8}{Export citations.bib}{paragraph.A.1.2.2.2}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}\protected@file@percent }
\newlabel{zotero-connector-browser-plugin}{{A.1.2.2.3}{8}{Zotero Connector Browser Plugin}{paragraph.A.1.2.2.3}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}\protected@file@percent }
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}\protected@file@percent }
\newlabel{lmodern}{{A.1.2.3}{8}{lmodern}{subsubsection.A.1.2.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}\protected@file@percent }
\newlabel{epubcheck}{{A.1.2.4}{8}{epubcheck}{subsubsection.A.1.2.4}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}\protected@file@percent }
\newlabel{foliate}{{A.1.2.5}{8}{foliate}{subsubsection.A.1.2.5}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}\protected@file@percent }
\newlabel{calibre}{{A.1.2.6}{9}{calibre}{subsubsection.A.1.2.6}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}\protected@file@percent }
\newlabel{editing-the-configuration}{{A.2}{9}{Editing the Configuration}{section.A.2}{}}
\gdef \LT@i {\LT@entry \gdef \LT@i {\LT@entry
{1}{86.68152pt}\LT@entry {1}{86.68152pt}\LT@entry
{1}{383.07349pt}} {1}{383.07349pt}}
\newlabel{glossary}{{2.2}{4}{Glossary}{chapter*.4}{}} \newlabel{glossary}{{A.2}{10}{Glossary}{appendix*.4}{}}
\@writefile{toc}{\contentsline {chapter}{Glossary}{4}{chapter*.4}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Glossary}{10}{appendix*.4}\protected@file@percent }
\@writefile{toc}{\contentsline {chapter}{Index}{6}{chapter*.5}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Index}{12}{appendix*.5}\protected@file@percent }
\bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext } \bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext }
\bibcite{ref-JohnHaverlackACEP}{\citeproctext } \bibcite{ref-JohnHaverlackACEP}{\citeproctext }
\bibcite{ref-PandocIndex}{\citeproctext } \bibcite{ref-PandocIndex}{\citeproctext }
\bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext } \bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext }
\bibcite{ref-JohnHaverlackACEP}{\citeproctext } \bibcite{ref-JohnHaverlackACEP}{\citeproctext }
\bibcite{ref-PandocIndex}{\citeproctext } \bibcite{ref-PandocIndex}{\citeproctext }
\newlabel{bibliography}{{2.2}{8}{Bibliography}{chapter*.6}{}} \newlabel{bibliography}{{A.2}{14}{Bibliography}{appendix*.6}{}}
\@writefile{toc}{\contentsline {chapter}{Bibliography}{8}{chapter*.6}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Bibliography}{14}{appendix*.6}\protected@file@percent }
\newlabel{refs}{{2.2}{8}{Bibliography}{section*.7}{}} \newlabel{refs}{{A.2}{14}{Bibliography}{section*.7}{}}
\gdef \@abspage@last{13} \gdef \@abspage@last{19}

97
build/latex/basic-book-builder.log
View File

@ -1,4 +1,4 @@
This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Debian) (preloaded format=xelatex 2025.11.6) 5 FEB 2026 13:01 This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Debian) (preloaded format=xelatex 2025.11.6) 5 FEB 2026 13:27
entering extended mode entering extended mode
restricted \write18 enabled. restricted \write18 enabled.
file:line:error style messages enabled. file:line:error style messages enabled.
@ -1736,19 +1736,18 @@ LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be
LaTeX Font Info: Font shape `TU/NotoSerif(0)/b/n' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/b/n' will be
(Font) scaled to size 14.4pt on input line 349. (Font) scaled to size 14.4pt on input line 349.
[2] [2]
(./basic-book-builder.toc) (./basic-book-builder.toc [1
])
\tf@toc=\write5 \tf@toc=\write5
\openout5 = `basic-book-builder.toc'. \openout5 = `basic-book-builder.toc'.
[1 [2]
] [2
]
Chapter 1. Chapter 1.
[1 [1
] ]
Chapter 2. Chapter 2.
LaTeX Font Info: Font shape `TU/NotoSansMono(0)/m/n' will be LaTeX Font Info: Font shape `TU/NotoSansMono(0)/m/n' will be
@ -1762,47 +1761,95 @@ k-builder.git[]
[2 [2
] [3] ] [3]
Underfull \hbox (badness 10000) in alignment at lines 479--487 Chapter 3.
[4
] [5]
Appendix A.
Overfull \hbox (295.84503pt too wide) in paragraph at lines 587--588
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/jgm/pandoc/rel
eases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb
[]
Underfull \hbox (badness 10000) in paragraph at lines 593--595
[][][]\TU/NotoSerif(0)/m/n/12 VSCodium[][] is recommend for privacy (telemetry/
tracking) reasons -
[]
[6
]
Overfull \hbox (358.24503pt too wide) in paragraph at lines 656--656
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/obsidianmd/obs
idian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb[]
[]
Underfull \vbox (badness 1888) has occurred while \output is active []
[7]
Overfull \hbox (12.02498pt too wide) in paragraph at lines 701--703
[]\TU/NotoSerif(0)/m/n/12 Symlink your ~/Documents/Lib/Citations.bib to basic-b
ook-builder/lib/zotero.bib
[]
Overfull \hbox (107.64897pt too wide) in paragraph at lines 711--712
[]\TU/NotoSerif(0)/m/n/12 https://chromewebstore.google.com/detail/zotero-conne
ctor/ekhagklcjbdpajgpjgmbionohlpdbjgc
[]
Overfull \hbox (430.245pt too wide) in paragraph at lines 740--740
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/johnfactotum/f
oliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb[]
[]
[8] [9]
Underfull \hbox (badness 10000) in alignment at lines 767--775
[] [] [] []
[] []
Underfull \hbox (badness 10000) in alignment at lines 487--489 Underfull \hbox (badness 10000) in alignment at lines 775--777
[] [] [] []
[] []
Overfull \hbox (1.68248pt too wide) in paragraph at lines 493--493 Overfull \hbox (1.68248pt too wide) in paragraph at lines 781--781
[]|\TU/NotoSerif(0)/b/n/12 Bibliography| []|\TU/NotoSerif(0)/b/n/12 Bibliography|
[] []
Underfull \hbox (badness 10000) in alignment at lines 489--541 Underfull \hbox (badness 10000) in alignment at lines 777--829
[] [] [] []
[] []
[4 [10
] [5] (./basic-book-builder.ind) [6 ] [11] (./basic-book-builder.ind) [12
] [7 ] [13
] ]
Underfull \hbox (badness 3977) in paragraph at lines 576--578 Underfull \hbox (badness 3977) in paragraph at lines 864--866
[]\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d. []\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d.
Https://www.uaf.edu/acep/about/our-team/john- Https://www.uaf.edu/acep/about/our-team/john-
[] []
Underfull \hbox (badness 3977) in paragraph at lines 588--590 Underfull \hbox (badness 3977) in paragraph at lines 876--878
[]\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d. []\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d.
Https://www.uaf.edu/acep/about/our-team/john- Https://www.uaf.edu/acep/about/our-team/john-
[] []
[8 [14
] [9 ] [15
] (./basic-book-builder.aux) ] (./basic-book-builder.aux)
@ -1810,12 +1857,12 @@ LaTeX Warning: There were multiply-defined labels.
) )
Here is how much of TeX's memory you used: Here is how much of TeX's memory you used:
36014 strings out of 478775 36087 strings out of 478775
745203 string characters out of 5850945 746049 string characters out of 5850945
1858991 words of memory out of 5000000 1859991 words of memory out of 5000000
55441 multiletter control sequences out of 15000+600000 55514 multiletter control sequences out of 15000+600000
516036 words of font info for 92 fonts, out of 8000000 for 9000 516036 words of font info for 92 fonts, out of 8000000 for 9000
14 hyphenation exceptions out of 8191 14 hyphenation exceptions out of 8191
90i,11n,122p,1015b,948s stack positions out of 10000i,1000n,20000p,200000b,200000s 90i,12n,122p,1015b,954s stack positions out of 10000i,1000n,20000p,200000b,200000s
Output written on basic-book-builder.pdf (13 pages). Output written on basic-book-builder.pdf (19 pages).

BIN
build/latex/basic-book-builder.pdf
View File

Binary file not shown.

308
build/latex/basic-book-builder.tex
View File

@ -429,7 +429,7 @@ Haverlack.(\citeproc{ref-JohnHaverlackACEP}{\emph{John {Haverlack}
\section{Cloning the Basic Book \section{Cloning the Basic Book
Builder}\label{cloning-the-basic-book-builder} Builder}\label{cloning-the-basic-book-builder}
\begin{clibox}[Cloning the repository] \begin{clibox}[Clone the repository]
\begin{verbatim} \begin{verbatim}
git clone https://github.com/jehaverlack/basic-book-builder.git git clone https://github.com/jehaverlack/basic-book-builder.git
\end{verbatim} \end{verbatim}
@ -443,18 +443,11 @@ cd basic-book-builder
\end{clibox} \end{clibox}
\begin{codebox}[Code Example]
\begin{verbatim}
if then else
\end{verbatim}
\end{codebox}
\section{Setting Up Build \section{Setting Up Build
Environment}\label{setting-up-build-environment} Environment}\label{setting-up-build-environment}
\begin{cautionbox}[Debian Based Linux] \begin{cautionbox}[~Debian Linux]
This script only support Debian based linux system (Debian, Ubunutu, This script only support Debian based Linux system (Debian, Ubunutu,
Zorin, etc) This script has not been widely tested across platforms Zorin, etc) This script has not been widely tested across platforms
\end{cautionbox} \end{cautionbox}
@ -468,6 +461,301 @@ Zorin, etc) This script has not been widely tested across platforms
For more information on setting up the build environment for your system For more information on setting up the build environment for your system
see Appendix A. see Appendix A.
\section{Testing}\label{testing}
If you can build all format for the \textbf{Basic Book Build} then you
have a working build environment.
\begin{clibox}[Testing Build Environment]
\begin{verbatim}
make all
\end{verbatim}
\end{clibox}
\section{Creating a New Project}\label{creating-a-new-project}
\subsection{Zotero Configuration
(Optional)}\label{zotero-configuration-optional}
\chapter{Usage}\label{usage}
\section{Editing Content}\label{editing-content}
\section{Building}\label{building}
\subsection{PDF}\label{pdf}
\begin{verbatim}
make pdf
\end{verbatim}
\begin{quote}
NOTE: Building the PDF also builds the \textbf{LaTeX} version of the
book.
\end{quote}
\subsection{HTML}\label{html}
\begin{verbatim}
make html
\end{verbatim}
\subsection{DocX}\label{docx}
\begin{verbatim}
make docx
\end{verbatim}
\begin{quote}
NOTE: DocX is a work in progress. Frontmatter and formatting need work.
\end{quote}
\subsection{ODT}\label{odt}
\begin{verbatim}
make odt
\end{verbatim}
\begin{quote}
NOTE: ODT is a work in progress. Frontmatter and formatting need work.
\end{quote}
\subsection{Make All}\label{make-all}
To build all supported formats
\begin{verbatim}
make all
\end{verbatim}
\section{Callouts}\label{callouts}
A few callout box styles have been added to easily highlight content.
\begin{establishedbox}[Established Concept]
Einsteins Relativistic Dynamics Equations
\[E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 \]
\end{establishedbox}
\begin{proposedbox}[Proposed Concept]
With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \]
\end{proposedbox}
\begin{speculativebox}[Speculative Concept]
With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \]
\end{speculativebox}
\begin{cautionbox}[Caution Note]
Beware of this section.
\end{cautionbox}
\begin{warningbox}[Warning Note]
Beware of this section.
\end{warningbox}
\begin{dangerbox}[Alerts]
Extreme Highlight
\end{dangerbox}
\appendix
Appendix A
\chapter{Appendix A: Build Environment
Notes}\label{appendix-a-build-environment-notes}
\section{Installing Pre-Requisites}\label{installing-pre-requisites}
\begin{cautionbox}[Not Cross-platform Tested]
For Debian / ZorinOS and likely Ubuntu based systems.
\end{cautionbox}
\subsection{Required}\label{required}
\subsubsection{Pandoc}\label{pandoc}
\begin{itemize}
\tightlist
\item
https://pandoc.org/
\item
\href{https://github.com/jgm/pandoc/releases/tag/3.8.2.1}{Download}
\end{itemize}
\begin{quote}
\texttt{sudo\ apt\ install\ https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb}
\end{quote}
\subsubsection{Code Editor}\label{code-editor}
\begin{establishedbox}[Code Editor]
\href{https://vscodium.com/}{VSCodium} is recommend for privacy
(telemetry/tracking) reasons - https://vscodium.com/
\end{establishedbox}
But any text editor will work. \#\#\#\# make
\begin{verbatim}
sudo apt install make
\end{verbatim}
\subsubsection{jq and yq}\label{jq-and-yq}
\begin{verbatim}
sudo apt install jq yq
\end{verbatim}
\subsubsection{texlive}\label{texlive}
\begin{quote}
\texttt{sudo\ apt\ install\ texlive\ texlive-xetex\ texlive-latex-extra\ texlive-fonts-recommended\ texlive-fonts-extra}
\end{quote}
\subsubsection{MathJax}\label{mathjax}
\begin{itemize}
\tightlist
\item
https://www.mathjax.org/
\end{itemize}
\begin{verbatim}
wget https://registry.npmjs.org/mathjax/-/mathjax-3.2.2.tgz
tar xzf mathjax-3.2.2.tgz
mv package/es5/* lib/mathjax
rm -rf package mathjax-3.2.2.tgz
\end{verbatim}
\begin{cautionbox}[TODO]
This need to be rolled into a setup script.
\end{cautionbox}
\subsection{Optional}\label{optional}
The following are not strictly requires to use this book builder
template.
\subsubsection{Obsidian}\label{obsidian}
\begin{establishedbox}[Highly Recommended]
Editing book chapter content in Obsidian is a very productive means for
editing Markdown source content.
\end{establishedbox}
\begin{itemize}
\tightlist
\item
https://obsidian.md/
\item
\href{https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb}{Deb
Package}
\end{itemize}
\begin{verbatim}
sudo apt install https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb
\end{verbatim}
\subsubsection{Zotero}\label{zotero}
\begin{establishedbox}[Highly Recommended]
If you need to managed citations and references, Zotero integration is
highly recommended.
\end{establishedbox}
\begin{itemize}
\tightlist
\item
https://www.zotero.org/
\end{itemize}
\begin{verbatim}
sudo cp ./scripts/deps/zotero.list /etc/apt/sources.list.d/
\end{verbatim}
\begin{verbatim}
sudo apt update
\end{verbatim}
\begin{verbatim}
sudo apt install zotero
\end{verbatim}
\paragraph{Better BibTex for Zotero}\label{better-bibtex-for-zotero}
Install the Better BibTex Plugin for Zotero - Zotero \textgreater{} Tool
\textgreater{} Plugins
\paragraph{Export citations.bib}\label{export-citations.bib}
\begin{itemize}
\tightlist
\item
Zotero \textgreater{} File \textgreater{} Export Library
\textgreater{} Format: Better BibTeX
\item[$\square$]
Keep Updated
\item[$\square$]
Save to: \textasciitilde/Documents/Lib/zotero.bib
\item[$\square$]
Symlink your \textasciitilde/Documents/Lib/Citations.bib to
basic-book-builder/lib/zotero.bib
\end{itemize}
\paragraph{Zotero Connector Browser
Plugin}\label{zotero-connector-browser-plugin}
\begin{itemize}
\tightlist
\item
https://chromewebstore.google.com/detail/zotero-connector/ekhagklcjbdpajgpjgmbionohlpdbjgc
\end{itemize}
Provides you the ability to auto add Web resources to your Zotero
citation database.
\subsubsection{lmodern}\label{lmodern}
\begin{verbatim}
sudo apt install lmodern
\end{verbatim}
\subsubsection{epubcheck}\label{epubcheck}
\begin{verbatim}
sudo apt install epubcheck
\end{verbatim}
\subsubsection{foliate}\label{foliate}
An EPub Reader
\begin{itemize}
\tightlist
\item
https://johnfactotum.github.io/foliate/
\end{itemize}
\begin{verbatim}
sudo apt install https://github.com/johnfactotum/foliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb
\end{verbatim}
\subsubsection{calibre}\label{calibre}
An EPub Reader
\begin{itemize}
\tightlist
\item
https://calibre-ebook.com
\end{itemize}
\begin{verbatim}
sudo apt install calibre
\end{verbatim}
\section{Editing the Configuration}\label{editing-the-configuration}
\backmatter \backmatter
\chapter*{Glossary}\label{glossary} \chapter*{Glossary}\label{glossary}

37
build/latex/basic-book-builder.toc
View File

@ -2,6 +2,37 @@
\contentsline {chapter}{\numberline {2}Getting Started}{2}{chapter.2}% \contentsline {chapter}{\numberline {2}Getting Started}{2}{chapter.2}%
\contentsline {section}{\numberline {2.1}Cloning the Basic Book Builder}{2}{section.2.1}% \contentsline {section}{\numberline {2.1}Cloning the Basic Book Builder}{2}{section.2.1}%
\contentsline {section}{\numberline {2.2}Setting Up Build Environment}{2}{section.2.2}% \contentsline {section}{\numberline {2.2}Setting Up Build Environment}{2}{section.2.2}%
\contentsline {chapter}{Glossary}{4}{chapter*.4}% \contentsline {section}{\numberline {2.3}Testing}{3}{section.2.3}%
\contentsline {chapter}{Index}{6}{chapter*.5}% \contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}%
\contentsline {chapter}{Bibliography}{8}{chapter*.6}% \contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}%
\contentsline {chapter}{\numberline {3}Usage}{4}{chapter.3}%
\contentsline {section}{\numberline {3.1}Editing Content}{4}{section.3.1}%
\contentsline {section}{\numberline {3.2}Building}{4}{section.3.2}%
\contentsline {subsection}{\numberline {3.2.1}PDF}{4}{subsection.3.2.1}%
\contentsline {subsection}{\numberline {3.2.2}HTML}{4}{subsection.3.2.2}%
\contentsline {subsection}{\numberline {3.2.3}DocX}{4}{subsection.3.2.3}%
\contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}%
\contentsline {subsection}{\numberline {3.2.5}Make All}{5}{subsection.3.2.5}%
\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}%
\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}%
\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}%
\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}%
\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}%
\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}%
\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}%
\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}%
\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}%
\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}%
\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}%
\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}%
\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}%
\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}%
\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}%
\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}%
\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}%
\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}%
\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}%
\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}%
\contentsline {chapter}{Glossary}{10}{appendix*.4}%
\contentsline {chapter}{Index}{12}{appendix*.5}%
\contentsline {chapter}{Bibliography}{14}{appendix*.6}%

BIN
build/odt/basic-book-builder.odt Normal file
View File

Binary file not shown.

BIN
build/pdf/basic-book-builder.pdf
View File

Binary file not shown.

31
chapters/01_Getting_Started.md
View File

@ -3,7 +3,7 @@
## Cloning the Basic Book Builder ## Cloning the Basic Book Builder
> [!cli] Cloning the repository > [!cli] Clone the repository
> ``` > ```
> git clone https://github.com/jehaverlack/basic-book-builder.git > git clone https://github.com/jehaverlack/basic-book-builder.git
> ``` > ```
@ -14,16 +14,11 @@
> cd basic-book-builder > cd basic-book-builder
> ``` > ```
> [!code] Code Example
> ```
> if then else
> ```
## Setting Up Build Environment ## Setting Up Build Environment
> [!caution] Debian Based Linux > [!caution] ~Debian Linux
> This script only support Debian based linux system (Debian, Ubunutu, Zorin, etc) > This script only support Debian based Linux system (Debian, Ubunutu, Zorin, etc)
> This script has not been widely tested across platforms > This script has not been widely tested across platforms
@ -35,3 +30,23 @@
For more information on setting up the build environment for your system see Appendix A. For more information on setting up the build environment for your system see Appendix A.
## Testing
If you can build all format for the **Basic Book Build** then you have a working build environment.
> [!cli] Testing Build Environment
> ```
> make all
> ```
## Creating a New Project
### Zotero Configuration (Optional)

46
chapters/02_Usage.md
View File

@ -0,0 +1,46 @@
# Usage
## Editing Content
## Building
### PDF
```
make pdf
```
> NOTE: Building the PDF also builds the **LaTeX** version of the book.
### HTML
```
make html
```
### DocX
```
make docx
```
> NOTE: DocX is a work in progress. Frontmatter and formatting need work.
### ODT
```
make odt
```
> NOTE: ODT is a work in progress. Frontmatter and formatting need work.
### Make All
To build all supported formats
```
make all
```

369
chapters/03_Features.md
View File

@ -32,372 +32,3 @@ $$E^2 = m_{0}^2 + p^2 $$
# Example Content
In $R\nu$ the [Planck Length](https://en.wikipedia.org/wiki/Planck_units#Planck_length) is the universal unit for measurement of distance, and is defined approximately to be:
$$\boxed{L_P=\sqrt{\hbar}=5.72928\times10^{-35}m=1 L}$$
Where $1\ L$, is 1 Planck Length of distance.
### SI Conversion Factors
The following conversion factors can be used to convert observable quantities of measure from the _SI_ system of units to $R\nu$ to ~6 significant digits.
| Conversion Factor | Symbol | Value |
| ---------------------------- | -------- | -------------------------------------------------- |
| meters to Planck Length | $\chi_P$ | $1.74542\times10^{34} \frac{L}{m}$ |
| seconds to Planck Length | $\tau_p$ | $5.23264\times10^{42} \frac{L}{s}$ |
| mass to Planck Length | $G_P$ | $1.62871\times10^8 \frac{L}{kg}$ |
| energy to Planck Length | $E_P$ | $1.81219\times10^9 \frac{L}{J}$ |
| momentum to Planck Length | $P_P$ | $5.43280\times10^{-1} \frac{L\cdot s}{kg \cdot m}$ |
| temperature to Planck Length | $k_P$ | $2.501998\times10^{-14} \frac{L}{K}$ |
| charge to Planck Length | $C_P$ | $1.89007\times10^{18} \frac{L}{C}$ |
### Physical Constants
Applying conversion factors from the table above, we can convert SI values to Reduced Natural Units. For example, performing this analysis on the the speed of light yields a unit-less number with a value of 1:
$c = 299792458 \frac{m}{s} = 299792458 \frac{m}{s} \cdot 1.74542\times10^{34} \frac{L}{m} \cdot \frac{1}{5.23264\times10^{42} \frac{L}{s}} = 1.00000$
| Quantity | Symbol | SI | $\nu$ |
| ------------------------------ | ------------ | ------------------------------------------------------------ | ------------------------------ |
| Speed of Light | $c$ | $299792458 \frac{m}{s}$ | 1 |
| Reduced Gravitational Constant | $G_0$ | $8.38659\times10^{-10} \frac{m^3}{kg \cdot s^2}$ | 1 |
| Boltzmann's Constant | $k$ | $k=1.380649\times10^-23 \frac{J}{K}$ | 1 |
| Permittivity of Free Space | $\epsilon_o$ | $8.854187817620\times10^{-12} \frac{C^{2}s^2}{kg \cdot m^3}$ | 1 |
| Permeability of Free Space | $\mu_o$ | $\huge{\frac{1}{\epsilon_{o} \cdot c^{2}}}$ | 1 |
| Reduced Planck's Constant | $\hbar$ | $1.054571726\times10^-34 \frac{kg \cdot m^2}{s}$ | $1 L^2$ |
| Mass of the Electron | $m_e$ | $9.10938\times10^{-31} kg$ | $1.48366\times10^{-22} L$ |
| Charge of the Electron | $e^-$ | $-1.60218\times10^{-19} C$ | $-3.02822\times10^{-1} L$ |
| Unit Cycle | $\Theta$ | $2\pi = 6.28318...\ Radians$ | $1 \tau = 6.28318...\ Radians$ |
## Fine Structure Constant
As a consistency check, we compute the _[Fine Structure Constant](https://en.wikipedia.org/wiki/Fine-structure_constant)_ using Reduced Natural Units which is a unit less ratio that should be independent of our system of units.
$\huge{\alpha=\frac{e^2}{4\pi\epsilon_o\hbar c}=\frac{e^2}{2\tau}=0.00729735≈\frac{1}{137}}$
#### Dimensional Analysis
The reader should be familiar with high school physics and chemistry [dimensional analysis](https://en.wikipedia.org/wiki/Dimensional_analysis).
- $1\ meter\ (m) = 100\ centimeters\ (cm)$
- $1\ kilometer\ (km) = 1000\ meters\ (m)$
- $1\ mile = 5280\ feet\ (ft\ or\ ')$
- $1\ foot\ (ft\ or\ ') = 12\ inches\ (in\ or\ ")$
- $1\ inch\ (") = 2.54\ centimeters\ (cm)$
How many kilometers are in 1 mile?
$1\ mile = 1\ mile \times \frac{5280\ ft}{mile} \times \frac{12\ in}{ft} \times \frac{2.54\ cm}{in}\times \frac{1\ m}{100 cm} \times \frac{1\ km}{1000 m} = \frac{5280 \times 12 \times 2.54}{100 \times 1000}\ km = \frac{160934.40}{100000}\ km = 1.6\ km$
Note that each unit in the denominator cancels with one if the numerator until we are left with only km.
## Newton's Law of Gravity
The force of gravity ($F_g$) between 2 masses, $m1$ and $m2$ separated by distance $r$ is given by [Newton's Law of Gravity](https://en.wikipedia.org/wiki/Newton%27s_law_of_universal_gravitation):
$F_{g} = G \frac{m_{1} m_{2}}{r^{2}}$
Where $G$, is the [Gravitational Constant](http://en.wikipedia.org/wiki/Gravitational_Constant).
$G = 6.67430 \times 10^{-11}\ N\frac{m^2}{kg^2}$
The strength of gravitational force follow the inverse square law distributing gravitational flux over the surface area of a sphere ($4\pi r^2$).
#### Inverse Square Law
Any source of a signal strength ($S_0$) that radiates isotropically in 3-dimensional space will distribute that signal strength ($S_0$) over the surface area of a sphere ($SA = 4 \pi r$) of radius ($r$). Such that the intensity ($I$) at distance ($r$) is:
$$I(r) = \frac{S_0}{4 \pi r^{2}}=\frac{S_0}{2 \tau r^{2}}$$
![inverse square law](lib/img/Inverse_square_law.svg.png)
#### $R\nu$ Reduced Gravitational Constant
In this version of Newton's Law of Gravity we introduce a new constant $G_0$, the reduced gravitational constant to accommodate for the factor of $4\pi = 2\tau$ which is has been integrated in the SI version of the gravitational constant.
$F_g =G \frac{m_{1} m_{2}}{r^{2}}= G_0 \frac{m_{1} m_{2}}{4 \pi r^{2}}=G_0 \frac{m_{1} m_{2}}{2 \tau r^{2}}$
Where:
$G = \frac{G_{0}}{2\tau} = 6.67384 \times 10^{-11} \frac{N \cdot m^2}{kg^2}$
Analyzing the units:
$$\frac{N \cdot m^2}{kg^2} = \left( \frac{\left( kg \cdot \frac{m}{s^2} \right) \cdot m^2}{kg^2} \right)=\frac{m^3}{s^2 kg}$$
Converting seconds to meters with the SI speed of light as a conversion factor:
$$\frac{m^3}{s^2 kg}\cdot\frac{1}{c^2}=\frac{m^3}{s^2 kg}\cdot\frac{s^2}{m^2}=\frac{m}{kg}$$
Thus where space and time are measured in units of meters, the reduced gravitational constant, is:
$$\boxed{G_0=\frac{2\tau G}{c^2}=\frac{2\tau \cdot 6.67384 \times 10^{-11}}{299792458^2} \frac{m}{kg} = 9.33135 \times 10^-27 \frac{m}{kg}}$$
> Observation
> This implies that not only can space an time be measure in units of meters, but so can mass.
### Relativistic Energy Momentum Relation
Einsteins [Relativistic Energy Momentum](https://en.wikipedia.org/wiki/Energy%E2%80%93momentum_relation) relationship shows a Pythagorean relation between the total energy ($E$), rest mass ($m_0$) and momentum ($p$) of a system.
$E^{2} = (m_0 \cdot c^2)^2 + (p \cdot c)^2$
Where space and time are both measure in units of meters, c=1.
$E^2=(m_0)^2+(p)^2$
From this we can see that Energy, Momentum and Mass have equivalent units.
>
> _While we do not really know what energy, mass and momentum are we know that they are fundamentally “made” out of the same stuff because they have the same units._
##### Objects of mass at rest
For an object at rest with no momentum ($p = 0$) we see Einstein's famous equations:
$E = m_{0} \cdot c^2$
Or, with $c=1$, this is much simpler to understand. Energy = Mass
$E = m_0$
##### Zero mass objects moving at the speed of light
And for objects with no mass, like photos, ($m_{0}= 0$):
$E=pc$
Or, with $c=1$, this is much simpler to understand. Energy = Momentum
$E=p$
## Planck's Constant
The [Reduced Planck constant](https://en.wikipedia.org/wiki/Planck_constant) , ħ, represents a conversion factor for relating the frequency, $\omega$ (in $2\pi$ radians per second), of a photon to the energy of that photon. This can easily be seen from the simple but profound relationship:
$E=\hbar\omega$
Where:
$\hbar=1.054571726 \times 10^{−34} J \cdot s$
and
$J \cdot s = {kg}\cdot\frac{m^2}{s}$
> Reduced Planck's Constant
> $\hbar = \frac{h}{2\pi} = \frac{h}{\tau}$
Simplifying our units by converting time and mass to units of meters:
$$\boxed{\hbar=1.054571726 \times 10^{−34} {kg}\cdot\frac{m^2}{s}\cdot\frac{G_0}{c}=3.282462\times10^{-69}m^2}$$
Which suggest that the Plank constant can be interpreted as an areas for which the square root of is suspiciously close to the Plank length:
$$\boxed{\sqrt{\hbar}=\sqrt{3.282462\times10^{-69}m^2}=5.72928\times10^{-35}m}$$
#### Planck Area
The [Planck Area](https://en.wikipedia.org/wiki/Planck_units#Derived_units) is the square of the [Planck Length](https://en.wikipedia.org/wiki/Planck_units#Planck_length).
$l_{P}= \sqrt{\frac{\hbar G}{c^3}}$
and $l_{P}^{2}= \frac{\hbar G}{c^3}$
In $R\nu$ units both $c$ and $G_o$ are 1.
$l_{P} = \sqrt{\hbar}$
and $l_P^{2}=\hbar$
## Bekenstein's Bound
After having recently read _Three Roads to Quantum Gravity_ by Lee Smolin, I now suspect the meaning of this areas is related to the [Bekensteins Law](https://en.wikipedia.org/wiki/Bekenstein_bound) as applied to a surface areas surrounding a mass. Where the [thermodynamic entropy](https://en.wikipedia.org/wiki/Entropy_(statistical_thermodynamics)), _S_, is proportional to the the enclosed surface area, $A$.
$S=\frac{1}{4}\cdot\frac{A}{G\hbar}$
$S=\frac{k c^{3} A}{4 G \hbar}$
$S \le \frac{2\pi k R E}{\hbar c} = \frac{\tau R k E}{\hbar c}$
From our new values for $G_0$and $\hbar$ we can likely rewrite this:
$S=\frac{\pi\cdot A}{\hbar G_0}$
With the limiting case being at the Plank scale.
$S=\frac{\pi\cdot \sqrt{\hbar}}{\hbar G_0}$
## Planck Length
https://en.wikipedia.org/wiki/Planck_length
The concept of the Planck Length comes from exploring the limits of Quantum Mechanics and General Relativity. The limits of General Relativity can be seen a the event horizon of a black hole, described by the Schwarzschild Radius. And the limits of Quantum Mechanics can be found in the Compton Wavelength for a given quanta.
The [Schwarzschild Radius](https://simple.wikipedia.org/wiki/Schwarzschild_radius) is defined as the distance at which light cannot escape from the gravitational field of a mass (m):
Classic Derivation.
$r_S=\frac{2G m}{c^2}$
The reduced [Compton Wavelength](https://en.wikipedia.org/wiki/Compton_wavelength) represents a lower limit on the wavelength for quanta that can interact with a quantum particle with mass (m):
$\lambda_C=\frac{h}{m c}$
$\bar{\lambda_C}=\frac{2\pi\hbar}{m c}=\frac{\tau\hbar}{m c}$
And set the Schwarzschild Radius equal to the Compton Wavelength:
$r_S=\lambda_C$
$\frac{2Gm}{c^{2}}=\frac{h}{m c}$
$m^{2}= \frac{hc}{2G}$
$m = \sqrt{\frac{hc}{2G}}$
$l_P=\frac{2G\sqrt{\frac{hc}{2G}}}{c^2}$
$l_P=\frac{2G\sqrt{\frac{hc}{2G}}}{c^{2}}= \sqrt{\frac{2Gh}{c^2}}$
With reduced Compton Wavelength
$r_S=\bar{\lambda_C}$
$\frac{2Gm}{c^{2}}=\frac{\tau\hbar}{m c}$
$m^2=\frac{\tau\ \hbar\ c}{2G}$
$m = \sqrt{\frac{\tau\ \hbar\ c}{2G}}$
$l_P=\frac{2G\sqrt{\frac{\tau\ \hbar\ c}{2G}}}{c^2}$
$l_P=\frac{2G\sqrt{\frac{\tau\ \hbar\ c}{2G}}}{c^{2}}=\sqrt{\frac{4\ \tau\ G\ \hbar}{c^3}}$
If we reduce the units in these equation to those of mass and time measured in meters.
$l_P=\sqrt{4\tau\hbar G_{o}}$
and
$\lambda_C=\frac{\hbar}{m}$
$m=R_s=\lambda_C=\frac{\hbar}{m}$
This is known as the Planck Mass, $M_P$.
$M_P=m=\sqrt{\hbar}$
Solving the Compton Wavelength for distance we find the classic Plank Length:
$\lambda_C=\frac{\hbar}{\sqrt{\hbar}}=\frac{\sqrt{\hbar}}{\sqrt{\hbar}}\cdot\frac{\hbar}{\sqrt{\hbar}}=\sqrt{\hbar}=L_P$
Which is in precise agreement with the value we found in above. Thus the Plank Length is:
$L_P=\sqrt{\hbar}=5.72928\times10^{-35}m$
When we measure distance, time, and mass in units of distance, c=1, and the Plank Time, $T_P$, is equal to Plank Length, $L_P$, which is equal to the Plank Mass, $M_P$:
$$\boxed{L_P=T_P=M_P}$$
Conversion Factor | Symbol | Value
--- | --- | ----
meters to Planck Length | $\chi_P$ | $1.74542\times10^{34} \frac{L}{m}$
seconds to Planck Length | $\tau_p$ | $5.23264\times10^{42} \frac{L}{s}$
mass to Planck Length | $G_P$ | $1.62871\times10^8 \frac{L}{kg}$
energy to Planck Length | $E_P$ | $1.81219\times10^9 \frac{L}{J}$
momentum to Planck Length | $P_P$ | $5.43280\times10^{-1} \frac{L\cdot s}{kg \cdot m}$
temperature to Planck Length | $k_P$ | $2.501998\times10^{-14} \frac{L}{K}$
charge to Planck Length | $C_P$| $1.89007\times10^{18} \frac{L}{C}$
Applying conversion factors from the table above, we can convert SI values to Reduced Natural Units.
$c=\frac{1}{\sqrt{\epsilon_o \mu_o}}$
Quantity | Symbol | SI | $\nu$
--- | --- | --- | ----
Speed of Light | $c$ | $299792458 \frac{m}{s}$ | 1
Gravitational Constant | $G_0$ | $8.38659\times10^{-10} \frac{m^3}{kg \cdot s^2}$ | 1
Boltzmann's Constant | $k$ | $k=1.380649\times10^-23 \frac{J}{K}$ | 1
Permittivity of Free Space | $\epsilon_o$ | $8.854187817620\times10^{-12} \frac{C^{2}s^2}{kg \cdot m^3}$ | 1
Permeability of Free Space | $\mu_o$ | $\huge{\frac{1}{\epsilon_{o} \cdot c^{2}}}$ | 1
Planck's Constant | $\hbar$ | $1.054571726\times10^-34 \frac{kg \cdot m^2}{s}$ | $1 L^2$
Mass of the Electron | $m_e$ | $9.10938\times10^{-31} kg$ | $1.48366\times10^{-22} L$
Charge of the Electron | $e^-$ | $-1.60218\times10^{-19} C$ | $-3.02822\times10^{-1} L$
## Fine Structure Constant
https://en.wikipedia.org/wiki/Fine-structure_constant
As a consistency check, we compute the _Fine Structure Constant_ using Reduced Natural Units which is a unit less ratio that should be independent of our system of units.
$\huge{\alpha=\frac{e^2}{4\pi\epsilon_o\hbar c}=\frac{e^2}{4\pi}=0.00729735≈\frac{1}{137}}$
This check confirms that our system of Reduced Natural Units has internally consistent values for $c$, $\epsilon_o$, $\hbar$ and $e-$. And also $G_o$ which was used to computer prior values is also consistent.
## Sage Code
Unit Analysis computations have been performed with [Sage Math](https://www.sagemath.org/).
```bash
# Define constance
one = 1.n(digits=6)
pi = pi.n(digits=6)
tau = 2 * pi
t = tau
# Define the units
meters = var('m')
m = one*meters
seconds = var('s')
s = seconds
kilograms = var('kg')
kg = kilograms
newtons = kg * m / s^2
N = newtons
joules = N * m
J = joules
print("pi =", pi)
print("tau =", t)
# Speed of light in meters/second
speed_of_light = 299792458 * meters/seconds
sol = speed_of_light
c = sol
print("si c =", c)
rnu_c = c / c
print("R\u03BD c =", rnu_c)
# Gravitational Constant
gravitational_constant = 6.67384e-11 * N*(m^2/kg^2)
G = gravitational_constant
print("si G =", G)
rnu_G = 4*pi*G/c^2
Go = rnu_G
print("R\u03BD Go =", Go)
# Planck's Constant
reduced_plancks_constant = 1.054571726e-34 * J*s
h_bar = reduced_plancks_constant
print("si \u210F =", h_bar)
rnu_h_bar = h_bar * Go / c
print("R\u03BD "u"\u210F =", rnu_h_bar)
# Planck Length
rnu_h_bar_str = str(rnu_h_bar)
numerical_part_str = rnu_h_bar_str.split('*')[0]
numerical_part_str = numerical_part_str.strip('()')
numerical_part = float(numerical_part_str)
rnu_sqrt_h_bar = numerical_part^(1/2)
# ^ Sage cannot process sqrt on units... Lame.
lP = rnu_sqrt_h_bar * m
print("R\u03BD \u221A\u210F =", lP)
```
#### Output
```
pi = 3.14159
tau = 6.28319
si c = 299792458*m/s
Rν c = 1
si G = (6.67384e-11)*m^3/(kg*s^2)
Rν Go = (9.33135e-27)*m/kg
si ℏ = (1.05457e-34)*kg*m^2/s
Rν ℏ = (3.28246e-69)*m^2
Rν √ℏ = (5.72928e-35)*m
si lP = (1.61620e-35)*sqrt(m^2)
Rν lP = (2.77455e-47)*sqrt(m^3/kg)
```

12
chapters/04_Design.md Normal file
View File

@ -0,0 +1,12 @@
# Design
## Directory Structure
## Configuration Files
## Build Workflow

7
templates/pandoc.yaml
View File

@ -3,9 +3,10 @@ input-files:
# - chapters/Preface.md # - chapters/Preface.md
- chapters/00_Introduction.md - chapters/00_Introduction.md
- chapters/01_Getting_Started.md - chapters/01_Getting_Started.md
# - chapters/02_Features.md - chapters/02_Usage.md
# - chapters/Appendix.md - chapters/03_Features.md
# - chapters/AppendixA.md - chapters/Appendix.md
- chapters/AppendixA.md
# - chapters/AppendixB.md # - chapters/AppendixB.md
- chapters/Glossary.md - chapters/Glossary.md
- chapters/Index.md - chapters/Index.md