v1.1.0: Documenting usage

This commit is contained in:
John Haverlack 2026-02-05 15:02:41 -09:00
parent 6e011be320
commit 2d6cd827c5
17 changed files with 1128 additions and 279 deletions

View File

@ -13,12 +13,12 @@
"state": { "state": {
"type": "markdown", "type": "markdown",
"state": { "state": {
"file": "chapters/AppendixA.md", "file": "chapters/02_Usage.md",
"mode": "source", "mode": "source",
"source": false "source": false
}, },
"icon": "lucide-file", "icon": "lucide-file",
"title": "AppendixA" "title": "02_Usage"
} }
} }
] ]
@ -270,32 +270,32 @@
}, },
"active": "01161538f53367e8", "active": "01161538f53367e8",
"lastOpenFiles": [ "lastOpenFiles": [
"chapters/03_Features.md",
"conf/sedkKV6c0",
"conf/sedAqcSmo",
"conf/sedk8YBK0",
"conf/sedzF3xOr",
"conf/sedtZNObL",
"chapters/02_Usage.md",
"chapters/AppendixB.md",
"chapters/Bibliography.md",
"chapters/AppendixA.md",
"conf/sed6ZdLUq",
"chapters/04_Design.md",
"chapters/Appendix.md",
"chapters/01_Getting_Started.md", "chapters/01_Getting_Started.md",
"conf/sedBapyXA", "conf/sedBapyXA",
"conf/sedYZ2rBJ", "conf/sedYZ2rBJ",
"conf/sedbEPwZC", "conf/sedbEPwZC",
"chapters/02_Usage.md",
"chapters/04_Design.md",
"README.md", "README.md",
"chapters/00_Introduction.md", "chapters/00_Introduction.md",
"chapters/04_Design", "chapters/04_Design",
"conf/odt.yaml",
"conf/frontmatter-docx.md", "conf/frontmatter-docx.md",
"conf/docx.yaml",
"chapters/03_Features.md",
"conf/sedMSkcEz",
"conf/sedsOEcAe",
"conf/sedwM39Vv",
"conf/sedqNCjeN",
"chapters/AppendixA.md",
"templates/frontmatter-docx.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/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",
"lib/img/unit-circle-with-pi.png", "lib/img/unit-circle-with-pi.png",

Binary file not shown.

View File

@ -161,7 +161,42 @@ Content</a></li>
<li><a href="#odt" id="toc-odt">ODT</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> <li><a href="#make-all" id="toc-make-all">Make All</a></li>
</ul></li> </ul></li>
<li><a href="#callouts" id="toc-callouts">Callouts</a></li> </ul></li>
<li><a href="#features" id="toc-features">Features</a>
<ul>
<li><a href="#metadata" id="toc-metadata">Metadata</a></li>
<li><a href="#front-matter" id="toc-front-matter">Front-matter</a>
<ul>
<li><a href="#meta-data-page" id="toc-meta-data-page">Meta Data
Page</a></li>
</ul></li>
<li><a href="#chapters" id="toc-chapters">Chapters</a></li>
<li><a href="#appendixes" id="toc-appendixes">Appendixes</a></li>
<li><a href="#glossary" id="toc-glossary">Glossary</a></li>
<li><a href="#index" id="toc-index">Index</a>
<ul>
<li><a href="#markdown-indexes" id="toc-markdown-indexes">Markdown
Indexes</a></li>
</ul></li>
<li><a href="#bibliography" id="toc-bibliography">Bibliography</a>
<ul>
<li><a href="#zotero-integration" id="toc-zotero-integration">Zotero
Integration</a></li>
<li><a href="#obsidian-citations" id="toc-obsidian-citations">Obsidian
Citations</a></li>
</ul></li>
<li><a href="#mathjax-equations" id="toc-mathjax-equations">Mathjax
Equations</a>
<ul>
<li><a href="#left-justified-inline" id="toc-left-justified-inline">Left
Justified / Inline</a></li>
<li><a href="#centered" id="toc-centered">Centered</a></li>
</ul></li>
<li><a href="#custom-markdown" id="toc-custom-markdown">Custom
Markdown</a>
<ul>
<li><a href="#call-outs" id="toc-call-outs">Call-outs</a></li>
</ul></li>
</ul></li> </ul></li>
<li><a href="#appendix-a-build-environment-notes" <li><a href="#appendix-a-build-environment-notes"
id="toc-appendix-a-build-environment-notes">Appendix A: Build id="toc-appendix-a-build-environment-notes">Appendix A: Build
@ -176,8 +211,9 @@ id="toc-installing-pre-requisites">Installing Pre-Requisites</a>
<li><a href="#editing-the-configuration" <li><a href="#editing-the-configuration"
id="toc-editing-the-configuration">Editing the Configuration</a></li> 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-1" id="toc-glossary-1">Glossary</a></li>
<li><a href="#bibliography" id="toc-bibliography">Bibliography</a></li> <li><a href="#bibliography-1"
id="toc-bibliography-1">Bibliography</a></li>
</ul> </ul>
</nav> </nav>
<h1 id="introduction">Introduction</h1> <h1 id="introduction">Introduction</h1>
@ -255,37 +291,155 @@ work.</p>
<h3 id="make-all">Make All</h3> <h3 id="make-all">Make All</h3>
<p>To build all supported formats</p> <p>To build all supported formats</p>
<pre><code>make all</code></pre> <pre><code>make all</code></pre>
<h2 id="callouts">Callouts</h2> <h1 id="features">Features</h1>
<p>A few callout box styles have been added to easily highlight <h2 id="metadata">Metadata</h2>
content.</p> <p>Metadata for the project is managed in <code>metadata.yaml</code>.
Edit this file to make global changes to variables for your document.
Changes here will propagate to all format builds.</p>
<h2 id="front-matter">Front-matter</h2>
<p>Front matter content is manged in: -
<code>templates/frontmatter.tex</code> -
<code>templates/frontmatter.html</code> -
<code>templates/frontmatter-md.html</code></p>
<div class="callout-caution">
<p><strong>Tip</strong></p>
<p> Unfortunately when you edit one, you need to edit the respective
changes to the other front-matter formats. ### Title Page</p>
</div>
<p>Edit the <strong>Front-matter</strong> files to modify the formatting
of the Title Page.</p>
<div class="callout-caution">
<p><strong>Tip</strong></p>
<p> Youll need to modify the HTML / LaTex.</p>
</div>
<h3 id="meta-data-page">Meta Data Page</h3>
<p>Edit the <strong>Front-matter</strong> files to modify the 2nd page
Metadata format. ### Cover Illustration</p>
<p>Edit the <strong>Front-matter</strong> files to optionally un-comment
the Cover Art Acknowledgement. - This is disabled by default ###
Dedication</p>
<p>Edit the <strong>Front-matter</strong> files to modify un-comment the
Book Dedication. - This is disabled by default ## Table of Contents</p>
<h2 id="chapters">Chapters</h2>
<p>Chapter Markdown source files are located in the
<code>chapters</code> directory. Edit the
<code>template\pandoc.yaml</code> file to control which chapter markdown
files are in what order.</p>
<h2 id="appendixes">Appendixes</h2>
<p>TBD</p>
<h2 id="glossary">Glossary</h2>
<p>TBD</p>
<h2 id="index">Index</h2>
<p>TBD</p>
<h3 id="markdown-indexes">Markdown Indexes</h3>
<p>TBD</p>
<h2 id="bibliography">Bibliography</h2>
<p>TBD</p>
<h3 id="zotero-integration">Zotero Integration</h3>
<p>TBD</p>
<h3 id="obsidian-citations">Obsidian Citations</h3>
<p>TBD</p>
<h2 id="mathjax-equations">Mathjax Equations</h2>
<p>TBD</p>
<h3 id="left-justified-inline">Left Justified / Inline</h3>
<p>TBD</p>
<h3 id="centered">Centered</h3>
<p>TBD</p>
<h2 id="custom-markdown">Custom Markdown</h2>
<p>TBD</p>
<h3 id="call-outs">Call-outs</h3>
<p>A few call-out box styles have been custom added to easily highlight
certain types of content.</p>
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!established] Green Call-out Title
A green box</code></pre>
</div>
<div class="callout-established"> <div class="callout-established">
<p><strong>Established Concept</strong></p> <p><strong>Green Call-out Title</strong></p>
<p> Einsteins Relativistic Dynamics Equations <span <p> A green box</p>
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>
<hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!proposed] Blue Call-out Title
A blue box</code></pre>
</div> </div>
<div class="callout-proposed"> <div class="callout-proposed">
<p><strong>Proposed Concept</strong></p> <p><strong>Blue Call-out Title</strong></p>
<p> With the speed of light, <span <p> A blue box</p>
class="math inline"><em>c</em>=1</span>: <span </div>
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> <hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!speculative] Purple Call-out Title
A purple box</code></pre>
</div> </div>
<div class="callout-speculative"> <div class="callout-speculative">
<p><strong>Speculative Concept</strong></p> <p><strong>Purple Call-out Title</strong></p>
<p> With the speed of light, <span <p> A purple box</p>
class="math inline"><em>c</em>=1</span>: <span </div>
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> <hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!caution] Caution Note
Beware of this section. AKA a orange box.</code></pre>
</div> </div>
<div class="callout-caution"> <div class="callout-caution">
<p><strong>Caution Note</strong></p> <p><strong>Caution Note</strong></p>
<p> Beware of this section.</p> <p> Beware of this section. AKA a orange box.</p>
</div>
<hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!warning] Warning Note
Same as the Caution Box</code></pre>
</div> </div>
<div class="callout-warning"> <div class="callout-warning">
<p><strong>Warning Note</strong></p> <p><strong>Warning Note</strong></p>
<p> Beware of this section.</p> <p> Same as the Caution Box</p>
</div>
<hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!danger] Alert
A slightly stronger warning. AKA a red box.</code></pre>
</div> </div>
<div class="callout-danger"> <div class="callout-danger">
<p><strong>Alerts</strong></p> <p><strong>Alert</strong></p>
<p> Extreme Highlight</p> <p> A slightly stronger warning. AKA a red box.</p>
</div>
<hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!code] Code Block
&#39;&#39;&#39;
if [ true ]; do
echo &quot;The Cow Jumps over the Moon&quot;
fi
&#39;&#39;&#39;</code></pre>
</div>
<div class="callout-code">
<p><strong>Code Block</strong></p>
<pre><code>if [ true ]; do
echo &quot;The Cow Jumps over the Moon&quot;
fi</code></pre>
</div>
<hr />
<div class="callout-code">
<p><strong>Markdown Code</strong></p>
<pre><code>[!cli] Command line
A command line example
&#39;&#39;&#39;
$ ls
build chapters conf filters lib LICENSE.md Makefile metadata.yaml &gt;README.md scripts templates
&#39;&#39;&#39;</code></pre>
</div>
<div class="callout-cli">
<p><strong>Command line</strong></p>
<p> A command line example</p>
<pre><code>$ ls
build chapters conf filters lib LICENSE.md Makefile metadata.yaml README.md scripts templates</code></pre>
</div> </div>
<p>Appendix A</p> <p>Appendix A</p>
<h1 id="appendix-a-build-environment-notes">Appendix A: Build <h1 id="appendix-a-build-environment-notes">Appendix A: Build
@ -397,7 +551,7 @@ citation database.</p>
<pre><code>sudo apt install calibre</code></pre> <pre><code>sudo apt install calibre</code></pre>
<h2 id="editing-the-configuration">Editing the Configuration</h2> <h2 id="editing-the-configuration">Editing the Configuration</h2>
<h1 class="unnumbered" id="glossary">Glossary</h1> <h1 class="unnumbered" id="glossary-1">Glossary</h1>
<table> <table>
<colgroup> <colgroup>
<col style="width: 17%" /> <col style="width: 17%" />
@ -525,7 +679,7 @@ citation processing with Pandoc.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<h1 class="unnumbered" id="bibliography">Bibliography</h1> <h1 class="unnumbered" id="bibliography-1">Bibliography</h1>
<div id="refs" class="references csl-bib-body hanging-indent" <div id="refs" class="references csl-bib-body hanging-indent"
role="list"> role="list">
<div id="ref-JehaverlackBasicbookbuilderPandoca" class="csl-entry" <div id="ref-JehaverlackBasicbookbuilderPandoca" class="csl-entry"

View File

@ -30,8 +30,8 @@
\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 } \@writefile{toc}{\contentsline {section}{\numberline {2.3}Testing}{2}{section.2.3}\protected@file@percent }
\newlabel{testing}{{2.3}{3}{Testing}{section.2.3}{}} \newlabel{testing}{{2.3}{2}{Testing}{section.2.3}{}}
\@writefile{toc}{\contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}\protected@file@percent } \@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}{}} \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 } \@writefile{toc}{\contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}\protected@file@percent }
@ -52,63 +52,101 @@
\newlabel{docx}{{3.2.3}{4}{DocX}{subsection.3.2.3}{}} \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 } \@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}{}} \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 } \@writefile{toc}{\contentsline {subsection}{\numberline {3.2.5}Make All}{4}{subsection.3.2.5}\protected@file@percent }
\newlabel{make-all}{{3.2.5}{5}{Make All}{subsection.3.2.5}{}} \newlabel{make-all}{{3.2.5}{4}{Make All}{subsection.3.2.5}{}}
\@writefile{toc}{\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{\numberline {4}Features}{5}{chapter.4}\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{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }} \@writefile{lot}{\addvspace {10\p@ }}
\newlabel{appendix-a-build-environment-notes}{{A}{6}{Appendix A: Build Environment Notes}{appendix.A}{}} \newlabel{features}{{4}{5}{Features}{chapter.4}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.1}Metadata}{5}{section.4.1}\protected@file@percent }
\newlabel{installing-pre-requisites}{{A.1}{6}{Installing Pre-Requisites}{section.A.1}{}} \newlabel{metadata}{{4.1}{5}{Metadata}{section.4.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.2}Front-matter}{5}{section.4.2}\protected@file@percent }
\newlabel{required}{{A.1.1}{6}{Required}{subsection.A.1.1}{}} \newlabel{front-matter}{{4.2}{5}{Front-matter}{section.4.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{5}{subsection.4.2.1}\protected@file@percent }
\newlabel{pandoc}{{A.1.1.1}{6}{Pandoc}{subsubsection.A.1.1.1}{}} \newlabel{meta-data-page}{{4.2.1}{5}{Meta Data Page}{subsection.4.2.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{5}{subsection.4.2.2}\protected@file@percent }
\newlabel{code-editor}{{A.1.1.2}{6}{Code Editor}{subsubsection.A.1.1.2}{}} \newlabel{cover-illustration}{{4.2.2}{5}{Cover Illustration}{subsection.4.2.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.2.3}Dedication}{6}{subsection.4.2.3}\protected@file@percent }
\newlabel{jq-and-yq}{{A.1.1.3}{7}{jq and yq}{subsubsection.A.1.1.3}{}} \newlabel{dedication}{{4.2.3}{6}{Dedication}{subsection.4.2.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.3}Chapters}{6}{section.4.3}\protected@file@percent }
\newlabel{texlive}{{A.1.1.4}{7}{texlive}{subsubsection.A.1.1.4}{}} \newlabel{chapters}{{4.3}{6}{Chapters}{section.4.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.4}Appendixes}{6}{section.4.4}\protected@file@percent }
\newlabel{mathjax}{{A.1.1.5}{7}{MathJax}{subsubsection.A.1.1.5}{}} \newlabel{appendixes}{{4.4}{6}{Appendixes}{section.4.4}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.5}Glossary}{6}{section.4.5}\protected@file@percent }
\newlabel{optional}{{A.1.2}{7}{Optional}{subsection.A.1.2}{}} \newlabel{glossary}{{4.5}{6}{Glossary}{section.4.5}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.6}Index}{6}{section.4.6}\protected@file@percent }
\newlabel{obsidian}{{A.1.2.1}{7}{Obsidian}{subsubsection.A.1.2.1}{}} \newlabel{index}{{4.6}{6}{Index}{section.4.6}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{6}{subsection.4.6.1}\protected@file@percent }
\newlabel{zotero}{{A.1.2.2}{8}{Zotero}{subsubsection.A.1.2.2}{}} \newlabel{markdown-indexes}{{4.6.1}{6}{Markdown Indexes}{subsection.4.6.1}{}}
\newlabel{better-bibtex-for-zotero}{{A.1.2.2.1}{8}{Better BibTex for Zotero}{paragraph.A.1.2.2.1}{}} \@writefile{toc}{\contentsline {section}{\numberline {4.7}Bibliography}{6}{section.4.7}\protected@file@percent }
\@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{bibliography}{{4.7}{6}{Bibliography}{section.4.7}{}}
\newlabel{export-citations.bib}{{A.1.2.2.2}{8}{Export citations.bib}{paragraph.A.1.2.2.2}{}} \@writefile{toc}{\contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{6}{subsection.4.7.1}\protected@file@percent }
\@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-integration}{{4.7.1}{6}{Zotero Integration}{subsection.4.7.1}{}}
\newlabel{zotero-connector-browser-plugin}{{A.1.2.2.3}{8}{Zotero Connector Browser Plugin}{paragraph.A.1.2.2.3}{}} \@writefile{toc}{\contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{7}{subsection.4.7.2}\protected@file@percent }
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}\protected@file@percent } \newlabel{obsidian-citations}{{4.7.2}{7}{Obsidian Citations}{subsection.4.7.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.8}Mathjax Equations}{7}{section.4.8}\protected@file@percent }
\newlabel{lmodern}{{A.1.2.3}{8}{lmodern}{subsubsection.A.1.2.3}{}} \newlabel{mathjax-equations}{{4.8}{7}{Mathjax Equations}{section.4.8}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{7}{subsection.4.8.1}\protected@file@percent }
\newlabel{epubcheck}{{A.1.2.4}{8}{epubcheck}{subsubsection.A.1.2.4}{}} \newlabel{left-justified-inline}{{4.8.1}{7}{Left Justified / Inline}{subsection.4.8.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.8.2}Centered}{7}{subsection.4.8.2}\protected@file@percent }
\newlabel{foliate}{{A.1.2.5}{8}{foliate}{subsubsection.A.1.2.5}{}} \newlabel{centered}{{4.8.2}{7}{Centered}{subsection.4.8.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}\protected@file@percent } \@writefile{toc}{\contentsline {section}{\numberline {4.9}Custom Markdown}{7}{section.4.9}\protected@file@percent }
\newlabel{calibre}{{A.1.2.6}{9}{calibre}{subsubsection.A.1.2.6}{}} \newlabel{custom-markdown}{{4.9}{7}{Custom Markdown}{section.4.9}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}\protected@file@percent } \@writefile{toc}{\contentsline {subsection}{\numberline {4.9.1}Call-outs}{7}{subsection.4.9.1}\protected@file@percent }
\newlabel{editing-the-configuration}{{A.2}{9}{Editing the Configuration}{section.A.2}{}} \newlabel{call-outs}{{4.9.1}{7}{Call-outs}{subsection.4.9.1}{}}
\@writefile{toc}{\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{11}{appendix.A}\protected@file@percent }
\@writefile{lof}{\addvspace {10\p@ }}
\@writefile{lot}{\addvspace {10\p@ }}
\newlabel{appendix-a-build-environment-notes}{{A}{11}{Appendix A: Build Environment Notes}{appendix.A}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{11}{section.A.1}\protected@file@percent }
\newlabel{installing-pre-requisites}{{A.1}{11}{Installing Pre-Requisites}{section.A.1}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.1}Required}{11}{subsection.A.1.1}\protected@file@percent }
\newlabel{required}{{A.1.1}{11}{Required}{subsection.A.1.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{11}{subsubsection.A.1.1.1}\protected@file@percent }
\newlabel{pandoc}{{A.1.1.1}{11}{Pandoc}{subsubsection.A.1.1.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{11}{subsubsection.A.1.1.2}\protected@file@percent }
\newlabel{code-editor}{{A.1.1.2}{11}{Code Editor}{subsubsection.A.1.1.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{11}{subsubsection.A.1.1.3}\protected@file@percent }
\newlabel{jq-and-yq}{{A.1.1.3}{11}{jq and yq}{subsubsection.A.1.1.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{11}{subsubsection.A.1.1.4}\protected@file@percent }
\newlabel{texlive}{{A.1.1.4}{11}{texlive}{subsubsection.A.1.1.4}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{12}{subsubsection.A.1.1.5}\protected@file@percent }
\newlabel{mathjax}{{A.1.1.5}{12}{MathJax}{subsubsection.A.1.1.5}{}}
\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.2}Optional}{12}{subsection.A.1.2}\protected@file@percent }
\newlabel{optional}{{A.1.2}{12}{Optional}{subsection.A.1.2}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{12}{subsubsection.A.1.2.1}\protected@file@percent }
\newlabel{obsidian}{{A.1.2.1}{12}{Obsidian}{subsubsection.A.1.2.1}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{12}{subsubsection.A.1.2.2}\protected@file@percent }
\newlabel{zotero}{{A.1.2.2}{12}{Zotero}{subsubsection.A.1.2.2}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{13}{paragraph.A.1.2.2.1}\protected@file@percent }
\newlabel{better-bibtex-for-zotero}{{A.1.2.2.1}{13}{Better BibTex for Zotero}{paragraph.A.1.2.2.1}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{13}{paragraph.A.1.2.2.2}\protected@file@percent }
\newlabel{export-citations.bib}{{A.1.2.2.2}{13}{Export citations.bib}{paragraph.A.1.2.2.2}{}}
\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{13}{paragraph.A.1.2.2.3}\protected@file@percent }
\newlabel{zotero-connector-browser-plugin}{{A.1.2.2.3}{13}{Zotero Connector Browser Plugin}{paragraph.A.1.2.2.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{13}{subsubsection.A.1.2.3}\protected@file@percent }
\newlabel{lmodern}{{A.1.2.3}{13}{lmodern}{subsubsection.A.1.2.3}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{13}{subsubsection.A.1.2.4}\protected@file@percent }
\newlabel{epubcheck}{{A.1.2.4}{13}{epubcheck}{subsubsection.A.1.2.4}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{13}{subsubsection.A.1.2.5}\protected@file@percent }
\newlabel{foliate}{{A.1.2.5}{13}{foliate}{subsubsection.A.1.2.5}{}}
\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{13}{subsubsection.A.1.2.6}\protected@file@percent }
\newlabel{calibre}{{A.1.2.6}{13}{calibre}{subsubsection.A.1.2.6}{}}
\@writefile{toc}{\contentsline {section}{\numberline {A.2}Editing the Configuration}{13}{section.A.2}\protected@file@percent }
\newlabel{editing-the-configuration}{{A.2}{13}{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}{{A.2}{10}{Glossary}{appendix*.4}{}} \newlabel{glossary-1}{{A.2}{14}{Glossary}{appendix*.2}{}}
\@writefile{toc}{\contentsline {chapter}{Glossary}{10}{appendix*.4}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Glossary}{14}{appendix*.2}\protected@file@percent }
\@writefile{toc}{\contentsline {chapter}{Index}{12}{appendix*.5}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Index}{16}{appendix*.3}\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}{{A.2}{14}{Bibliography}{appendix*.6}{}} \newlabel{bibliography-1}{{A.2}{18}{Bibliography}{appendix*.4}{}}
\@writefile{toc}{\contentsline {chapter}{Bibliography}{14}{appendix*.6}\protected@file@percent } \@writefile{toc}{\contentsline {chapter}{Bibliography}{18}{appendix*.4}\protected@file@percent }
\newlabel{refs}{{A.2}{14}{Bibliography}{section*.7}{}} \newlabel{refs}{{A.2}{18}{Bibliography}{section*.5}{}}
\gdef \@abspage@last{19} \gdef \@abspage@last{23}

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:27 This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Debian) (preloaded format=xelatex 2025.11.6) 5 FEB 2026 14:53
entering extended mode entering extended mode
restricted \write18 enabled. restricted \write18 enabled.
file:line:error style messages enabled. file:line:error style messages enabled.
@ -1174,13 +1174,25 @@ File: tikzlibraryfadings.code.tex 2023-01-15 v3.1.10 (3.1.10)
File: pgflibraryfadings.code.tex 2023-01-15 v3.1.10 (3.1.10) File: pgflibraryfadings.code.tex 2023-01-15 v3.1.10 (3.1.10)
))) (/usr/share/texlive/texmf-dist/tex/latex/tcolorbox/tcbposter.code.tex ))) (/usr/share/texlive/texmf-dist/tex/latex/tcolorbox/tcbposter.code.tex
Library (tcolorbox): 'tcbposter.code.tex' version '5.1.1' Library (tcolorbox): 'tcbposter.code.tex' version '5.1.1'
)) (/usr/share/texlive/texmf-dist/tex/latex/float/float.sty )) (/usr/share/texlive/texmf-dist/tex/latex/titlesec/titlesec.sty
Package: titlesec 2021/07/05 v2.14 Sectioning titles
\ttl@box=\box89
\beforetitleunit=\skip64
\aftertitleunit=\skip65
\ttl@plus=\dimen296
\ttl@minus=\dimen297
\ttl@toksa=\toks42
\titlewidth=\dimen298
\titlewidthlast=\dimen299
\titlewidthfirst=\dimen300
)
(/usr/share/texlive/texmf-dist/tex/latex/float/float.sty
Package: float 2001/11/08 v1.3d Float enhancements (AL) Package: float 2001/11/08 v1.3d Float enhancements (AL)
\c@float@type=\count344 \c@float@type=\count344
\float@exts=\toks42 \float@exts=\toks43
\float@box=\box89 \float@box=\box90
\@float@everytoks=\toks43 \@float@everytoks=\toks44
\@floatcapt=\box90 \@floatcapt=\box91
) )
(/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty (/usr/share/texlive/texmf-dist/tex/latex/base/makeidx.sty
Package: makeidx 2021/10/04 v1.0m Standard LaTeX package Package: makeidx 2021/10/04 v1.0m Standard LaTeX package
@ -1200,15 +1212,15 @@ Package: url 2013/09/16 ver 3.4 Verb mode for urls, etc.
(/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty (/usr/share/texlive/texmf-dist/tex/latex/fancyhdr/fancyhdr.sty
Package: fancyhdr 2022/11/09 v4.1 Extensive control of page headers and footers Package: fancyhdr 2022/11/09 v4.1 Extensive control of page headers and footers
\f@nch@headwidth=\skip64 \f@nch@headwidth=\skip66
\f@nch@O@elh=\skip65 \f@nch@O@elh=\skip67
\f@nch@O@erh=\skip66 \f@nch@O@erh=\skip68
\f@nch@O@olh=\skip67 \f@nch@O@olh=\skip69
\f@nch@O@orh=\skip68 \f@nch@O@orh=\skip70
\f@nch@O@elf=\skip69 \f@nch@O@elf=\skip71
\f@nch@O@erf=\skip70 \f@nch@O@erf=\skip72
\f@nch@O@olf=\skip71 \f@nch@O@olf=\skip73
\f@nch@O@orf=\skip72 \f@nch@O@orf=\skip74
) )
(/usr/share/texlive/texmf-dist/tex/latex/bookmark/bookmark.sty (/usr/share/texlive/texmf-dist/tex/latex/bookmark/bookmark.sty
Package: bookmark 2020-11-06 v1.29 PDF bookmarks (HO) Package: bookmark 2020-11-06 v1.29 PDF bookmarks (HO)
@ -1242,7 +1254,7 @@ Package: gettitlestring 2019/12/15 v1.6 Cleanup title references (HO)
) )
\c@section@level=\count345 \c@section@level=\count345
) )
\@linkdim=\dimen296 \@linkdim=\dimen301
\Hy@linkcounter=\count346 \Hy@linkcounter=\count346
\Hy@pagecounter=\count347 \Hy@pagecounter=\count347
@ -1270,7 +1282,7 @@ Package hyperref Info: Implicit mode ON; LaTeX internals redefined.
Package hyperref Info: Bookmarks ON on input line 4410. Package hyperref Info: Bookmarks ON on input line 4410.
\c@Hy@tempcnt=\count349 \c@Hy@tempcnt=\count349
LaTeX Info: Redefining \url on input line 4748. LaTeX Info: Redefining \url on input line 4748.
\XeTeXLinkMargin=\dimen297 \XeTeXLinkMargin=\dimen302
(/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty (/usr/share/texlive/texmf-dist/tex/generic/bitset/bitset.sty
Package: bitset 2019/12/09 v1.3 Handle bit-vector datatype (HO) Package: bitset 2019/12/09 v1.3 Handle bit-vector datatype (HO)
@ -1280,8 +1292,8 @@ Package: bigintcalc 2019/12/15 v1.5 Expandable calculations on big integers (HO
) )
)) ))
\Fld@menulength=\count350 \Fld@menulength=\count350
\Field@Width=\dimen298 \Field@Width=\dimen303
\Fld@charsize=\dimen299 \Fld@charsize=\dimen304
Package hyperref Info: Hyper figures OFF on input line 6027. Package hyperref Info: Hyper figures OFF on input line 6027.
Package hyperref Info: Link nesting OFF on input line 6032. Package hyperref Info: Link nesting OFF on input line 6032.
Package hyperref Info: Hyper index ON on input line 6035. Package hyperref Info: Hyper index ON on input line 6035.
@ -1307,7 +1319,7 @@ File: hxetex.def 2022-11-13 v7.00u Hyperref driver for XeTeX
Package: stringenc 2019/11/29 v1.12 Convert strings between diff. encodings (HO Package: stringenc 2019/11/29 v1.12 Convert strings between diff. encodings (HO
) )
) )
\pdfm@box=\box91 \pdfm@box=\box92
\c@Hy@AnnotLevel=\count354 \c@Hy@AnnotLevel=\count354
\HyField@AnnotCount=\count355 \HyField@AnnotCount=\count355
\Fld@listcount=\count356 \Fld@listcount=\count356
@ -1327,13 +1339,13 @@ Package: uniquecounter 2019/12/15 v1.4 Provide unlimited unique counter (HO)
Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2 Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
85. 85.
) )
\Hy@SectionHShift=\skip73 \Hy@SectionHShift=\skip75
) )
(/usr/share/texlive/texmf-dist/tex/latex/bookmark/bkm-dvipdfm.def (/usr/share/texlive/texmf-dist/tex/latex/bookmark/bkm-dvipdfm.def
File: bkm-dvipdfm.def 2020-11-06 v1.29 bookmark driver for dvipdfm (HO) File: bkm-dvipdfm.def 2020-11-06 v1.29 bookmark driver for dvipdfm (HO)
\BKM@id=\count358 \BKM@id=\count358
)) ))
Package hyperref Info: Option `colorlinks' set `true' on input line 289. Package hyperref Info: Option `colorlinks' set `true' on input line 306.
(./basic-book-builder.aux (./basic-book-builder.aux
@ -1349,26 +1361,26 @@ LaTeX Warning: Label `ref-PandocIndex' multiply defined.
) )
\openout1 = `basic-book-builder.aux'. \openout1 = `basic-book-builder.aux'.
LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 294. LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 294. LaTeX Font Info: Checking defaults for OMS/cmsy/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 294. LaTeX Font Info: Checking defaults for OT1/cmr/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 294. LaTeX Font Info: Checking defaults for T1/cmr/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for TS1/cmr/m/n on input line 294. LaTeX Font Info: Checking defaults for TS1/cmr/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for TU/lmr/m/n on input line 294. LaTeX Font Info: Checking defaults for TU/lmr/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 294. LaTeX Font Info: Checking defaults for OMX/cmex/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 294. LaTeX Font Info: Checking defaults for U/cmr/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 294. LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
LaTeX Font Info: Checking defaults for PU/pdf/m/n on input line 294. LaTeX Font Info: Checking defaults for PU/pdf/m/n on input line 311.
LaTeX Font Info: ... okay on input line 294. LaTeX Font Info: ... okay on input line 311.
*geometry* driver: auto-detecting *geometry* driver: auto-detecting
*geometry* detected driver: xetex *geometry* detected driver: xetex
@ -1432,7 +1444,7 @@ t=math;language=dflt;"
(fontspec) - 'bold small caps' (b/sc) with NFSS spec.: (fontspec) - 'bold small caps' (b/sc) with NFSS spec.:
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(0)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(0)/m/n' will be
(Font) scaled to size 14.92346pt on input line 294. (Font) scaled to size 14.92346pt on input line 311.
Package fontspec Info: latinmodern-math scale = 1.243617846722112. Package fontspec Info: latinmodern-math scale = 1.243617846722112.
@ -1471,18 +1483,18 @@ t=math;language=dflt;"
(fontspec) - 'bold small caps' (b/sc) with NFSS spec.: (fontspec) - 'bold small caps' (b/sc) with NFSS spec.:
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be
(Font) scaled to size 14.92346pt on input line 294. (Font) scaled to size 14.92346pt on input line 311.
LaTeX Font Info: Encoding `OT1' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OT1' has changed to `TU' for symbol font
(Font) `operators' in the math version `normal' on input line 294. (Font) `operators' in the math version `normal' on input line 311.
LaTeX Font Info: Overwriting symbol font `operators' in version `normal' LaTeX Font Info: Overwriting symbol font `operators' in version `normal'
(Font) OT1/lmr/m/n --> TU/latinmodern-math.otf(1)/m/n on input (Font) OT1/lmr/m/n --> TU/latinmodern-math.otf(1)/m/n on input
line 294. line 311.
LaTeX Font Info: Encoding `OT1' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OT1' has changed to `TU' for symbol font
(Font) `operators' in the math version `bold' on input line 294. (Font) `operators' in the math version `bold' on input line 311.
LaTeX Font Info: Overwriting symbol font `operators' in version `bold' LaTeX Font Info: Overwriting symbol font `operators' in version `bold'
(Font) OT1/lmr/bx/n --> TU/latinmodern-math.otf(1)/b/n on inpu (Font) OT1/lmr/bx/n --> TU/latinmodern-math.otf(1)/b/n on inpu
t line 294. t line 311.
Package fontspec Info: latinmodern-math scale = 1.243617846722112. Package fontspec Info: latinmodern-math scale = 1.243617846722112.
@ -1569,15 +1581,15 @@ t=math;language=dflt;"
(fontspec) =0pt\relax \fontdimen 21\font =0pt\relax (fontspec) =0pt\relax \fontdimen 21\font =0pt\relax
LaTeX Font Info: Encoding `OMS' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OMS' has changed to `TU' for symbol font
(Font) `symbols' in the math version `normal' on input line 294. (Font) `symbols' in the math version `normal' on input line 311.
LaTeX Font Info: Overwriting symbol font `symbols' in version `normal' LaTeX Font Info: Overwriting symbol font `symbols' in version `normal'
(Font) OMS/lmsy/m/n --> TU/latinmodern-math.otf(2)/m/n on inpu (Font) OMS/lmsy/m/n --> TU/latinmodern-math.otf(2)/m/n on inpu
t line 294. t line 311.
LaTeX Font Info: Encoding `OMS' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OMS' has changed to `TU' for symbol font
(Font) `symbols' in the math version `bold' on input line 294. (Font) `symbols' in the math version `bold' on input line 311.
LaTeX Font Info: Overwriting symbol font `symbols' in version `bold' LaTeX Font Info: Overwriting symbol font `symbols' in version `bold'
(Font) OMS/lmsy/b/n --> TU/latinmodern-math.otf(2)/b/n on inpu (Font) OMS/lmsy/b/n --> TU/latinmodern-math.otf(2)/b/n on inpu
t line 294. t line 311.
Package fontspec Info: latinmodern-math scale = 1.243617846722112. Package fontspec Info: latinmodern-math scale = 1.243617846722112.
@ -1646,22 +1658,22 @@ ath.otf]/OT:script=math;language=dflt;+ssty=1;"
(fontspec) =8.95407pt\relax \fontdimen 13\font =0pt\relax (fontspec) =8.95407pt\relax \fontdimen 13\font =0pt\relax
LaTeX Font Info: Encoding `OMX' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OMX' has changed to `TU' for symbol font
(Font) `largesymbols' in the math version `normal' on input line 2 (Font) `largesymbols' in the math version `normal' on input line 3
94. 11.
LaTeX Font Info: Overwriting symbol font `largesymbols' in version `normal' LaTeX Font Info: Overwriting symbol font `largesymbols' in version `normal'
(Font) OMX/lmex/m/n --> TU/latinmodern-math.otf(3)/m/n on inpu (Font) OMX/lmex/m/n --> TU/latinmodern-math.otf(3)/m/n on inpu
t line 294. t line 311.
LaTeX Font Info: Encoding `OMX' has changed to `TU' for symbol font LaTeX Font Info: Encoding `OMX' has changed to `TU' for symbol font
(Font) `largesymbols' in the math version `bold' on input line 294 (Font) `largesymbols' in the math version `bold' on input line 311
. .
LaTeX Font Info: Overwriting symbol font `largesymbols' in version `bold' LaTeX Font Info: Overwriting symbol font `largesymbols' in version `bold'
(Font) OMX/lmex/m/n --> TU/latinmodern-math.otf(3)/b/n on inpu (Font) OMX/lmex/m/n --> TU/latinmodern-math.otf(3)/b/n on inpu
t line 294. t line 311.
LaTeX Info: Redefining \microtypecontext on input line 294. LaTeX Info: Redefining \microtypecontext on input line 311.
Package microtype Info: Applying patch `item' on input line 294. Package microtype Info: Applying patch `item' on input line 311.
Package microtype Info: Applying patch `toc' on input line 294. Package microtype Info: Applying patch `toc' on input line 311.
Package microtype Info: Applying patch `eqnum' on input line 294. Package microtype Info: Applying patch `eqnum' on input line 311.
Package microtype Info: Applying patch `footnote' on input line 294. Package microtype Info: Applying patch `footnote' on input line 311.
Package microtype Info: Character protrusion enabled (level 2). Package microtype Info: Character protrusion enabled (level 2).
Package microtype Info: Using protrusion set `basicmath'. Package microtype Info: Using protrusion set `basicmath'.
Package microtype Info: No adjustment of tracking. Package microtype Info: No adjustment of tracking.
@ -1672,13 +1684,13 @@ Package microtype Info: Loading generic protrusion settings for font family
(microtype) For optimal results, create family-specific settings. (microtype) For optimal results, create family-specific settings.
(microtype) See the microtype manual for details. (microtype) See the microtype manual for details.
\c@lstlisting=\count359 \c@lstlisting=\count359
Package hyperref Info: Link coloring ON on input line 294. Package hyperref Info: Link coloring ON on input line 311.
LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be
(Font) scaled to size 24.88pt on input line 305. (Font) scaled to size 24.88pt on input line 322.
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 24.88pt on input line 305. (Font) scaled to size 24.88pt on input line 322.
LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be
(Font) scaled to size 17.28pt on input line 307. (Font) scaled to size 17.28pt on input line 324.
File: lib/img/UAF-ACEP.png Graphic file (type bmp) File: lib/img/UAF-ACEP.png Graphic file (type bmp)
<lib/img/UAF-ACEP.png> <lib/img/UAF-ACEP.png>
[1 [1
@ -1687,31 +1699,31 @@ File: lib/img/UAF-ACEP.png Graphic file (type bmp)
] ]
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 17.28pt on input line 322. (Font) scaled to size 17.28pt on input line 339.
LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/it' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/it' will be
(Font) scaled to size 12.0pt on input line 324. (Font) scaled to size 12.0pt on input line 341.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be
(Font) scaled to size 10.44641pt on input line 329. (Font) scaled to size 10.44641pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(1)/m/n' will be
(Font) scaled to size 7.46173pt on input line 329. (Font) scaled to size 7.46173pt on input line 346.
LaTeX Font Info: Trying to load font information for OML+lmm on input line 3 LaTeX Font Info: Trying to load font information for OML+lmm on input line 3
29. 46.
(/usr/share/texmf/tex/latex/lm/omllmm.fd (/usr/share/texmf/tex/latex/lm/omllmm.fd
File: omllmm.fd 2015/05/01 v1.6.1 Font defs for Latin Modern File: omllmm.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
) )
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be
(Font) scaled to size 14.92493pt on input line 329. (Font) scaled to size 14.92493pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be
(Font) scaled to size 10.44743pt on input line 329. (Font) scaled to size 10.44743pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(2)/m/n' will be
(Font) scaled to size 7.46246pt on input line 329. (Font) scaled to size 7.46246pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be
(Font) scaled to size 14.922pt on input line 329. (Font) scaled to size 14.922pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be
(Font) scaled to size 10.44539pt on input line 329. (Font) scaled to size 10.44539pt on input line 346.
LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be LaTeX Font Info: Font shape `TU/latinmodern-math.otf(3)/m/n' will be
(Font) scaled to size 7.461pt on input line 329. (Font) scaled to size 7.461pt on input line 346.
LaTeX Font Info: Trying to load font information for U+msa on input line 329 LaTeX Font Info: Trying to load font information for U+msa on input line 346
. .
(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsa.fd
@ -1720,7 +1732,7 @@ File: umsa.fd 2013/01/14 v3.01 AMS symbols A
(/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-msa.cfg (/usr/share/texlive/texmf-dist/tex/latex/microtype/mt-msa.cfg
File: mt-msa.cfg 2006/02/04 v1.1 microtype config. file: AMS symbols (a) (RS) File: mt-msa.cfg 2006/02/04 v1.1 microtype config. file: AMS symbols (a) (RS)
) )
LaTeX Font Info: Trying to load font information for U+msb on input line 329 LaTeX Font Info: Trying to load font information for U+msb on input line 346
. .
(/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd (/usr/share/texlive/texmf-dist/tex/latex/amsfonts/umsb.fd
@ -1730,11 +1742,11 @@ File: umsb.fd 2013/01/14 v3.01 AMS symbols B
File: mt-msb.cfg 2005/06/01 v1.0 microtype config. file: AMS symbols (b) (RS) File: mt-msb.cfg 2005/06/01 v1.0 microtype config. file: AMS symbols (b) (RS)
) )
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 12.0pt on input line 330. (Font) scaled to size 12.0pt on input line 347.
LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be
(Font) scaled to size 14.4pt on input line 349. (Font) scaled to size 14.4pt on input line 366.
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 366.
[2] [2]
(./basic-book-builder.toc [1 (./basic-book-builder.toc [1
@ -1751,9 +1763,9 @@ Chapter 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
(Font) scaled to size 12.0pt on input line 433. (Font) scaled to size 12.0pt on input line 450.
Overfull \hbox (10.34296pt too wide) in paragraph at lines 434--434 Overfull \hbox (10.34296pt too wide) in paragraph at lines 451--451
[]\TU/NotoSansMono(0)/m/n/12 git clone https://github.com/jehaverlack/basic-boo []\TU/NotoSansMono(0)/m/n/12 git clone https://github.com/jehaverlack/basic-boo
k-builder.git[] k-builder.git[]
[] []
@ -1764,92 +1776,110 @@ k-builder.git[]
Chapter 3. Chapter 3.
[4 [4
] [5] ]
Chapter 4.
[5
] [6] [7] [8]
Overfull \hbox (262.34303pt too wide) in paragraph at lines 792--792
[]\TU/NotoSansMono(0)/m/n/12 build chapters conf filters lib LICENSE.md M
akefile metadata.yaml >README.md scripts templates[]
[]
[9]
Overfull \hbox (255.14304pt too wide) in paragraph at lines 805--805
[]\TU/NotoSansMono(0)/m/n/12 build chapters conf filters lib LICENSE.md M
akefile metadata.yaml README.md scripts templates[]
[]
[10]
Appendix A. Appendix A.
Overfull \hbox (295.84503pt too wide) in paragraph at lines 587--588 Overfull \hbox (12.85075pt too wide) in paragraph at lines 815--815
|\TU/NotoSerif(0)/b/n/24.88 Appendix A: Build Environment Notes|
[]
Overfull \hbox (295.84503pt too wide) in paragraph at lines 836--837
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/jgm/pandoc/rel []\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 eases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb
[] []
Underfull \hbox (badness 10000) in paragraph at lines 593--595 Underfull \hbox (badness 10000) in paragraph at lines 842--844
[][][]\TU/NotoSerif(0)/m/n/12 VSCodium[][] is recommend for privacy (telemetry/ [][][]\TU/NotoSerif(0)/m/n/12 VSCodium[][] is recommend for privacy (telemetry/
tracking) reasons - tracking) reasons -
[] []
[6 [11
] ]
Overfull \hbox (358.24503pt too wide) in paragraph at lines 656--656 Overfull \hbox (358.24503pt too wide) in paragraph at lines 905--905
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/obsidianmd/obs []\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[] idian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb[]
[] []
[12]
Underfull \vbox (badness 1888) has occurred while \output is active [] Overfull \hbox (12.02498pt too wide) in paragraph at lines 950--952
[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 []\TU/NotoSerif(0)/m/n/12 Symlink your ~/Documents/Lib/Citations.bib to basic-b
ook-builder/lib/zotero.bib ook-builder/lib/zotero.bib
[] []
Overfull \hbox (107.64897pt too wide) in paragraph at lines 711--712 Overfull \hbox (107.64897pt too wide) in paragraph at lines 960--961
[]\TU/NotoSerif(0)/m/n/12 https://chromewebstore.google.com/detail/zotero-conne []\TU/NotoSerif(0)/m/n/12 https://chromewebstore.google.com/detail/zotero-conne
ctor/ekhagklcjbdpajgpjgmbionohlpdbjgc ctor/ekhagklcjbdpajgpjgmbionohlpdbjgc
[] []
Overfull \hbox (430.245pt too wide) in paragraph at lines 740--740 Overfull \hbox (430.245pt too wide) in paragraph at lines 989--989
[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/johnfactotum/f []\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[] oliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb[]
[] []
[8] [9] [13]
Underfull \hbox (badness 10000) in alignment at lines 767--775 Underfull \hbox (badness 10000) in alignment at lines 1016--1024
[] [] [] []
[] []
Underfull \hbox (badness 10000) in alignment at lines 775--777 Underfull \hbox (badness 10000) in alignment at lines 1024--1026
[] [] [] []
[] []
Overfull \hbox (1.68248pt too wide) in paragraph at lines 781--781 Overfull \hbox (1.68248pt too wide) in paragraph at lines 1030--1030
[]|\TU/NotoSerif(0)/b/n/12 Bibliography| []|\TU/NotoSerif(0)/b/n/12 Bibliography|
[] []
Underfull \hbox (badness 10000) in alignment at lines 777--829 Underfull \hbox (badness 10000) in alignment at lines 1026--1078
[] [] [] []
[] []
[10
] [11] (./basic-book-builder.ind) [12
] [13
]
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.
Https://www.uaf.edu/acep/about/our-team/john-
[]
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.
Https://www.uaf.edu/acep/about/our-team/john-
[]
[14 [14
] [15
] [15] (./basic-book-builder.ind) [16
] [17
]
Underfull \hbox (badness 3977) in paragraph at lines 1113--1115
[]\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-
[]
Underfull \hbox (badness 3977) in paragraph at lines 1125--1127
[]\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-
[]
[18
] [19
] (./basic-book-builder.aux) ] (./basic-book-builder.aux)
@ -1857,12 +1887,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:
36087 strings out of 478775 36441 strings out of 478775
746049 string characters out of 5850945 750960 string characters out of 5850945
1859991 words of memory out of 5000000 1859991 words of memory out of 5000000
55514 multiletter control sequences out of 15000+600000 55864 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,12n,122p,1015b,954s stack positions out of 10000i,1000n,20000p,200000b,200000s 90i,12n,122p,1207b,1051s stack positions out of 10000i,1000n,20000p,200000b,200000s
Output written on basic-book-builder.pdf (19 pages). Output written on basic-book-builder.pdf (23 pages).

Binary file not shown.

View File

@ -108,6 +108,7 @@
\usepackage[most]{tcolorbox} \usepackage[most]{tcolorbox}
\usepackage{graphicx} \usepackage{graphicx}
\usepackage{xparse} \usepackage{xparse}
\usepackage{titlesec}
\tcbuselibrary{breakable} \tcbuselibrary{breakable}
% --- Disable floating figures globally --- % --- Disable floating figures globally ---
@ -140,6 +141,22 @@
% Helper to show a blank title if empty % Helper to show a blank title if empty
\newcommand{\blanktitle}{\mbox{}} \newcommand{\blanktitle}{\mbox{}}
% =========================================================
% Chapter Formatting (Suppress "Chapter 1")
% =========================================================
\titleformat{\chapter}[display]
{\normalfont\huge\bfseries} % formatting of title text
{} % <-- empty label removes "Chapter 1"
{0pt} % space between label and title
{\Huge} % formatting of title itself
\titlespacing*{\chapter}
{0pt} % left margin
{0pt} % space before title
{20pt} % space after title
% ========================================================= % =========================================================
% Concept Boxes % Concept Boxes
% ========================================================= % =========================================================
@ -257,7 +274,7 @@
\fancypagestyle{plain}{% \fancypagestyle{plain}{%
\fancyhf{}% \fancyhf{}%
\fancyhead[C]{\leftmark} % Chapter title \fancyhead[C]{\leftmark} % Chapter title
\cfoot{Basic Book Builder: A Pandoc template for building books, documents and articles} % Book title \cfoot{Basic Book Builder: A Pandoc build process for books, docs and articles} % Book title
\rfoot{\thepage} % Page number \rfoot{\thepage} % Page number
\renewcommand{\headrulewidth}{0pt} \renewcommand{\headrulewidth}{0pt}
\renewcommand{\footrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt}
@ -271,7 +288,7 @@
\fancyhead[C]{\leftmark} % Chapter title (centered) \fancyhead[C]{\leftmark} % Chapter title (centered)
% Footer % Footer
\cfoot{Basic Book Builder: A Pandoc template for building books, documents and articles} % Book title \cfoot{Basic Book Builder: A Pandoc build process for books, docs and articles} % Book title
\rfoot{\thepage} % Page number \rfoot{\thepage} % Page number
% Line rules % Line rules
@ -304,7 +321,7 @@
{\Huge\bfseries Basic Book Builder \par} {\Huge\bfseries Basic Book Builder \par}
\vspace{0.4cm} \vspace{0.4cm}
{\Large A Pandoc template for building books, documents and articles \par} {\Large A Pandoc build process for books, docs and articles \par}
\vspace{1.2cm} \vspace{1.2cm}
\includegraphics[width=0.5\textwidth]{lib/img/UAF-ACEP.png} \includegraphics[width=0.5\textwidth]{lib/img/UAF-ACEP.png}
@ -321,7 +338,7 @@
{\Large\bfseries Basic Book Builder \par} {\Large\bfseries Basic Book Builder \par}
\vspace{0.2cm} \vspace{0.2cm}
{\normalsize\textit{A Pandoc template for building books, documents and articles}\par} {\normalsize\textit{A Pandoc build process for books, docs and articles}\par}
\vspace{0.4cm} \vspace{0.4cm}
\renewcommand{\arraystretch}{1.3} % row spacing \renewcommand{\arraystretch}{1.3} % row spacing
@ -529,35 +546,267 @@ To build all supported formats
make all make all
\end{verbatim} \end{verbatim}
\section{Callouts}\label{callouts} \chapter{Features}\label{features}
A few callout box styles have been added to easily highlight content. \section{Metadata}\label{metadata}
\begin{establishedbox}[Established Concept] Metadata for the project is managed in \texttt{metadata.yaml}. Edit this
Einsteins Relativistic Dynamics Equations file to make global changes to variables for your document. Changes here
\[E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 \] will propagate to all format builds.
\end{establishedbox}
\begin{proposedbox}[Proposed Concept] \section{Front-matter}\label{front-matter}
With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \]
\end{proposedbox}
\begin{speculativebox}[Speculative Concept] Front matter content is manged in:
With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \]
\end{speculativebox}
\begin{cautionbox}[Caution Note] \begin{itemize}
Beware of this section. \tightlist
\item
\texttt{templates/frontmatter.tex}
\item
\texttt{templates/frontmatter.html}
\item
\texttt{templates/frontmatter-md.html}
\end{itemize}
\begin{cautionbox}[Tip]
Unfortunately when you edit one, you need to edit the respective changes
to the other front-matter formats. \#\#\# Title Page
\end{cautionbox} \end{cautionbox}
Edit the \textbf{Front-matter} files to modify the formatting of the
Title Page.
\begin{cautionbox}[Tip]
You'll need to modify the HTML / LaTex.
\end{cautionbox}
\subsection{Meta Data Page}\label{meta-data-page}
Edit the \textbf{Front-matter} files to modify the 2nd page Metadata
format.
\subsection{Cover Illustration}\label{cover-illustration}
Edit the \textbf{Front-matter} files to optionally un-comment the Cover
Art Acknowledgement.
\begin{itemize}
\tightlist
\item
This is disabled by default
\end{itemize}
\subsection{Dedication}\label{dedication}
Edit the \textbf{Front-matter} files to modify un-comment the Book
Dedication.
\begin{itemize}
\tightlist
\item
This is disabled by default \#\# Table of Contents
\end{itemize}
\section{Chapters}\label{chapters}
Chapter Markdown source files are located in the \texttt{chapters}
directory. Edit the \texttt{template\textbackslash{}pandoc.yaml} file to
control which chapter markdown files are in what order.
\section{Appendixes}\label{appendixes}
TBD
\section{Glossary}\label{glossary}
TBD
\section{Index}\label{index}
TBD
\subsection{Markdown Indexes}\label{markdown-indexes}
TBD
\section{Bibliography}\label{bibliography}
TBD
\subsection{Zotero Integration}\label{zotero-integration}
TBD
\subsection{Obsidian Citations}\label{obsidian-citations}
TBD
\section{Mathjax Equations}\label{mathjax-equations}
TBD
\subsection{Left Justified / Inline}\label{left-justified-inline}
TBD
\subsection{Centered}\label{centered}
TBD
\section{Custom Markdown}\label{custom-markdown}
TBD
\subsection{Call-outs}\label{call-outs}
A few call-out box styles have been custom added to easily highlight
certain types of content.
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!established] Green Call-out Title
A green box
\end{verbatim}
\end{codebox}
Will render:
\begin{establishedbox}[Green Call-out Title]
A green box
\end{establishedbox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!proposed] Blue Call-out Title
A blue box
\end{verbatim}
\end{codebox}
Will render:
\begin{proposedbox}[Blue Call-out Title]
A blue box
\end{proposedbox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!speculative] Purple Call-out Title
A purple box
\end{verbatim}
\end{codebox}
Will render:
\begin{speculativebox}[Purple Call-out Title]
A purple box
\end{speculativebox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!caution] Caution Note
Beware of this section. AKA a orange box.
\end{verbatim}
\end{codebox}
Will render:
\begin{cautionbox}[Caution Note]
Beware of this section. AKA a orange box.
\end{cautionbox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!warning] Warning Note
Same as the Caution Box
\end{verbatim}
\end{codebox}
Will render:
\begin{warningbox}[Warning Note] \begin{warningbox}[Warning Note]
Beware of this section. Same as the Caution Box
\end{warningbox} \end{warningbox}
\begin{dangerbox}[Alerts] \begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
Extreme Highlight
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!danger] Alert
A slightly stronger warning. AKA a red box.
\end{verbatim}
\end{codebox}
Will render:
\begin{dangerbox}[Alert]
A slightly stronger warning. AKA a red box.
\end{dangerbox} \end{dangerbox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!code] Code Block
'''
if [ true ]; do
echo "The Cow Jumps over the Moon"
fi
'''
\end{verbatim}
\end{codebox}
Will render:
\begin{codebox}[Code Block]
\begin{verbatim}
if [ true ]; do
echo "The Cow Jumps over the Moon"
fi
\end{verbatim}
\end{codebox}
\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
\begin{codebox}[Markdown Example]
\begin{verbatim}
[!cli] Command line
A command line example
'''
$ ls
build chapters conf filters lib LICENSE.md Makefile metadata.yaml >README.md scripts templates
'''
\end{verbatim}
\end{codebox}
Will render:
\begin{clibox}[Command line]
A command line example
\begin{verbatim}
$ ls
build chapters conf filters lib LICENSE.md Makefile metadata.yaml README.md scripts templates
\end{verbatim}
\end{clibox}
\appendix \appendix
Appendix A Appendix A
@ -758,7 +1007,7 @@ sudo apt install calibre
\backmatter \backmatter
\chapter*{Glossary}\label{glossary} \chapter*{Glossary}\label{glossary-1}
\addcontentsline{toc}{chapter}{Glossary} \addcontentsline{toc}{chapter}{Glossary}
{\def\LTcaptype{none} % do not increment counter {\def\LTcaptype{none} % do not increment counter
@ -850,7 +1099,7 @@ for citation processing with Pandoc. \\
\thispagestyle{plain} \thispagestyle{plain}
\markboth{Bibliography}{Bibliography} \markboth{Bibliography}{Bibliography}
\chapter*{Bibliography}\label{bibliography} \chapter*{Bibliography}\label{bibliography-1}
\addcontentsline{toc}{chapter}{Bibliography} \addcontentsline{toc}{chapter}{Bibliography}
\protect\phantomsection\label{refs} \protect\phantomsection\label{refs}

View File

@ -2,7 +2,7 @@
\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 {section}{\numberline {2.3}Testing}{3}{section.2.3}% \contentsline {section}{\numberline {2.3}Testing}{2}{section.2.3}%
\contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}% \contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}%
\contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}% \contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}%
\contentsline {chapter}{\numberline {3}Usage}{4}{chapter.3}% \contentsline {chapter}{\numberline {3}Usage}{4}{chapter.3}%
@ -12,27 +12,45 @@
\contentsline {subsection}{\numberline {3.2.2}HTML}{4}{subsection.3.2.2}% \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.3}DocX}{4}{subsection.3.2.3}%
\contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}% \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 {subsection}{\numberline {3.2.5}Make All}{4}{subsection.3.2.5}%
\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}% \contentsline {chapter}{\numberline {4}Features}{5}{chapter.4}%
\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}% \contentsline {section}{\numberline {4.1}Metadata}{5}{section.4.1}%
\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}% \contentsline {section}{\numberline {4.2}Front-matter}{5}{section.4.2}%
\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}% \contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{5}{subsection.4.2.1}%
\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}% \contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{5}{subsection.4.2.2}%
\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}% \contentsline {subsection}{\numberline {4.2.3}Dedication}{6}{subsection.4.2.3}%
\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}% \contentsline {section}{\numberline {4.3}Chapters}{6}{section.4.3}%
\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}% \contentsline {section}{\numberline {4.4}Appendixes}{6}{section.4.4}%
\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}% \contentsline {section}{\numberline {4.5}Glossary}{6}{section.4.5}%
\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}% \contentsline {section}{\numberline {4.6}Index}{6}{section.4.6}%
\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}% \contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{6}{subsection.4.6.1}%
\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}% \contentsline {section}{\numberline {4.7}Bibliography}{6}{section.4.7}%
\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}% \contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{6}{subsection.4.7.1}%
\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}% \contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{7}{subsection.4.7.2}%
\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}% \contentsline {section}{\numberline {4.8}Mathjax Equations}{7}{section.4.8}%
\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}% \contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{7}{subsection.4.8.1}%
\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}% \contentsline {subsection}{\numberline {4.8.2}Centered}{7}{subsection.4.8.2}%
\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}% \contentsline {section}{\numberline {4.9}Custom Markdown}{7}{section.4.9}%
\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}% \contentsline {subsection}{\numberline {4.9.1}Call-outs}{7}{subsection.4.9.1}%
\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}% \contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{11}{appendix.A}%
\contentsline {chapter}{Glossary}{10}{appendix*.4}% \contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{11}{section.A.1}%
\contentsline {chapter}{Index}{12}{appendix*.5}% \contentsline {subsection}{\numberline {A.1.1}Required}{11}{subsection.A.1.1}%
\contentsline {chapter}{Bibliography}{14}{appendix*.6}% \contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{11}{subsubsection.A.1.1.1}%
\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{11}{subsubsection.A.1.1.2}%
\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{11}{subsubsection.A.1.1.3}%
\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{11}{subsubsection.A.1.1.4}%
\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{12}{subsubsection.A.1.1.5}%
\contentsline {subsection}{\numberline {A.1.2}Optional}{12}{subsection.A.1.2}%
\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{12}{subsubsection.A.1.2.1}%
\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{12}{subsubsection.A.1.2.2}%
\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{13}{paragraph.A.1.2.2.1}%
\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{13}{paragraph.A.1.2.2.2}%
\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{13}{paragraph.A.1.2.2.3}%
\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{13}{subsubsection.A.1.2.3}%
\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{13}{subsubsection.A.1.2.4}%
\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{13}{subsubsection.A.1.2.5}%
\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{13}{subsubsection.A.1.2.6}%
\contentsline {section}{\numberline {A.2}Editing the Configuration}{13}{section.A.2}%
\contentsline {chapter}{Glossary}{14}{appendix*.2}%
\contentsline {chapter}{Index}{16}{appendix*.3}%
\contentsline {chapter}{Bibliography}{18}{appendix*.4}%

Binary file not shown.

Binary file not shown.

View File

@ -1,8 +1,34 @@
# Usage # Usage
## Creating a Project
To create a new Project based on the Basic Book Builder template:
1. Run the new-project.sh script.
```
./scripts/new-project.sh <PATH_TO_PROJECT>
```
- <PATH_TO_PROJECT> should be outside of the **basic-book-builder** directory
```
cd <PATH_TO_PROJECT>
```
Update:
1. `metadata.yaml`
2. `templates/pandoc.yaml`
## Editing Content ## Editing Content
Edit your source content Markdown under the `chapters` directory.
**Optional**
- Open your `<PATH_TO_PROJECT>` directory as an Obsidian vault.
- Edit your Markdown with Obsidian
## Building ## Building

View File

@ -1,34 +1,217 @@
# Features
## Metadata
Metadata for the project is managed in `metadata.yaml`. Edit this file to make global changes to variables for your document. Changes here will propagate to all format builds.
## Front-matter
Front matter content is manged in:
- `templates/frontmatter.tex`
- `templates/frontmatter.html`
- `templates/frontmatter-md.html`
## Callouts > [!caution] Tip
Unfortunately when you edit one, you need to edit the respective changes to the other front-matter formats.
### Title Page
A few callout box styles have been added to easily highlight content. Edit the **Front-matter** files to modify the formatting of the Title Page.
> [!established] Established Concept > [!caution] Tip
> Einsteins Relativistic Dynamics Equations > You'll need to modify the HTML / LaTex.
> $$E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 $$
### Meta Data Page
Edit the **Front-matter** files to modify the 2nd page Metadata format.
### Cover Illustration
Edit the **Front-matter** files to optionally un-comment the Cover Art Acknowledgement.
- This is disabled by default
### Dedication
> [!proposed] Proposed Concept Edit the **Front-matter** files to modify un-comment the Book Dedication.
With the speed of light, $c = 1$:
$$E^2 = m_{0}^2 + p^2 $$
- This is disabled by default
## Table of Contents
> [!speculative] Speculative Concept ## Chapters
With the speed of light, $c = 1$:
$$E^2 = m_{0}^2 + p^2 $$
Chapter Markdown source files are located in the `chapters` directory. Edit the `template\pandoc.yaml` file to control which chapter markdown files are in what order.
## Appendixes
TBD
## Glossary
TBD
## Index
TBD
### Markdown Indexes
TBD
## Bibliography
TBD
### Zotero Integration
TBD
### Obsidian Citations
TBD
## Mathjax Equations
TBD
### Left Justified / Inline
TBD
### Centered
TBD
## Custom Markdown
TBD
### Call-outs
A few call-out box styles have been custom added to easily highlight certain types of content.
> [!code] Markdown Example
> ```
> [!established] Green Call-out Title
> A green box
> ```
Will render:
> [!established] Green Call-out Title
> A green box
---
> [!code] Markdown Example
> ```
> [!proposed] Blue Call-out Title
> A blue box
> ```
Will render:
> [!proposed] Blue Call-out Title
> A blue box
---
> [!code] Markdown Example
> ```
> [!speculative] Purple Call-out Title
> A purple box
> ```
Will render:
> [!speculative] Purple Call-out Title
> A purple box
---
> [!code] Markdown Example
> ```
> [!caution] Caution Note
> Beware of this section. AKA a orange box.
> ```
Will render:
> [!caution] Caution Note > [!caution] Caution Note
> Beware of this section. > Beware of this section. AKA a orange box.
---
> [!code] Markdown Example
> ```
> [!warning] Warning Note
> Same as the Caution Box
> ```
Will render:
> [!warning] Warning Note > [!warning] Warning Note
> Beware of this section. > Same as the Caution Box
---
> [!code] Markdown Example
> ```
> [!danger] Alert
> A slightly stronger warning. AKA a red box.
> ```
Will render:
> [!danger] Alert
> A slightly stronger warning. AKA a red box.
---
> [!code] Markdown Example
> ```
> [!code] Code Block
> '''
> if [ true ]; do
> echo "The Cow Jumps over the Moon"
> fi
> '''
> ```
Will render:
> [!code] Code Block
> ```
> if [ true ]; do
> echo "The Cow Jumps over the Moon"
> fi
> ```
---
> [!code] Markdown Example
> ```
> [!cli] Command line
> A command line example
>'''
>$ ls
>build chapters conf filters lib LICENSE.md Makefile metadata.yaml >README.md scripts templates
> '''
> ```
Will render:
> [!cli] Command line
> A command line example
> ```
> $ ls
> build chapters conf filters lib LICENSE.md Makefile metadata.yaml README.md scripts templates
> ```
> [!danger] Alerts
> Extreme Highlight

View File

@ -2,11 +2,136 @@
## Directory Structure ## Directory Structure
```
basic-book-builder
├── build
│   ├── docx
│   ├── html
│   │   ├── conf
│   │   └── lib
│   │   ├── diag
│   │   ├── img
│   │   └── mathjax
│   ├── latex
│   ├── odt
│   └── pdf
├── chapters
├── conf
├── filters
├── lib
│   ├── citations
│   ├── diag
│   ├── img
│   └── mathjax
├── scripts
│   └── tmp
└── templates
```
## Configuration Files ## Configuration Files
```
../basic-book-builder
├── chapters
├── conf
├── filters
│   ├── callouts-html.lua
│   └── callouts.lua
├── lib
│   ├── diag
│   ├── img
│   └── zotero.bib
├── Makefile
├── metadata.yaml
├── scripts
│   ├── new-project.sh
│   ├── replace-metadata.sh
│   ├── setup-linux-deb.sh
│   └── tmp
└── templates
├── docx.yaml
├── epub_template.html
├── epub.yaml
├── frontmatter-docx.md
├── frontmatter.html
├── frontmatter-md.html
├── frontmatter.tex
├── header.tex
├── html.yaml
├── latex.yaml
├── markdown.yaml
├── odt.yaml
├── pandoc.yaml
├── pdf.yaml
├── style.css
└── style_epub.css
```
### Metadata
Update the `metadata.yaml` file to globally configure your document title and other metadata.
### Pandoc Main Config
Update the `input-files:` section of `templates/pandoc.yaml` to control what chapter source files are in which order in your document.
```
# pandoc.yaml
input-files:
# - chapters/Preface.md
- chapters/00_Introduction.md
- chapters/01_Getting_Started.md
- chapters/02_Usage.md
- chapters/03_Features.md
- chapters/Appendix.md
- chapters/AppendixA.md
# - chapters/AppendixB.md
- chapters/Glossary.md
- chapters/Index.md
- chapters/Bibliography.md
from: markdown+yaml_metadata_block+raw_tex
standalone: true
metadata:
mainfont: "Noto Serif"
sansfont: "Noto Sans"
monofont: "Noto Sans Mono"
# mainfont: "Libertinus Serif"
# sansfont: "Libertinus Sans"
# monofont: "DejaVu Sans Mono"
date: "" # <-- forces maketitle to exist, but blank
link-citations: true
variables:
documentclass: book # options: report, book, article
fontsize: 12pt
geometry:
- margin=1in
toc: true # ✅ Pandoc-recognized variable
toc-depth: 3 # ✅ nested inside variables
toc-title: "Contents" # ✅ controls TOC heading
numbersections: true # ✅ correct key (not number-sections)
colorlinks: true # nice PDF hyperlinks
linkcolor: blue
graphics: true
float: false
figure-latex-placement: H
# suppress-chapter: true
resource-path:
- .
- lib/img
- lib/diag
citeproc: true
bibliography: lib/zotero.bi
```
## Build Workflow ## Build Workflow
TBD

View File

@ -1,6 +1,6 @@
# Title # Title
title: "Basic Book Builder" title: "Basic Book Builder"
subtitle: "A Pandoc template for building books, documents and articles" subtitle: "A Pandoc build process for books, docs and articles"
name: "basic-book-builder" name: "basic-book-builder"
logo: "lib/img/UAF-ACEP.png" logo: "lib/img/UAF-ACEP.png"

View File

@ -8,7 +8,16 @@ if [ "$#" -ne 1 ]; then
exit 1 exit 1
fi fi
# Gets Script Directory
SCRIPT_DIR=$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )
B3_DIR=$( cd -- "$( dirname -- "$SCRIPT_DIR/.." )" &> /dev/null && pwd )
# Create project directory # Create project directory
PROJECT_DIR="$1" PROJECT_DIR="$1"
mkdir -p "$PROJECT_DIR" mkdir -p "$PROJECT_DIR"
echo "$SCRIPT_DIR"
echo "$B3_DIR"
# Copy B3 template to project directory
#rsync -av --exclude ".git" "$B3_DIR/" "$PROJECT_DIR"

View File

@ -2,6 +2,7 @@
\usepackage[most]{tcolorbox} \usepackage[most]{tcolorbox}
\usepackage{graphicx} \usepackage{graphicx}
\usepackage{xparse} \usepackage{xparse}
\usepackage{titlesec}
\tcbuselibrary{breakable} \tcbuselibrary{breakable}
% --- Disable floating figures globally --- % --- Disable floating figures globally ---
@ -34,6 +35,22 @@
% Helper to show a blank title if empty % Helper to show a blank title if empty
\newcommand{\blanktitle}{\mbox{}} \newcommand{\blanktitle}{\mbox{}}
% =========================================================
% Chapter Formatting (Suppress "Chapter 1")
% =========================================================
\titleformat{\chapter}[display]
{\normalfont\huge\bfseries} % formatting of title text
{} % <-- empty label removes "Chapter 1"
{0pt} % space between label and title
{\Huge} % formatting of title itself
\titlespacing*{\chapter}
{0pt} % left margin
{0pt} % space before title
{20pt} % space after title
% ========================================================= % =========================================================
% Concept Boxes % Concept Boxes
% ========================================================= % =========================================================