diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 223c5c4..8a0f0b5 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -11,10 +11,28 @@ "id": "72de52a10ebaa6e5", "type": "leaf", "state": { - "type": "empty", - "state": {}, + "type": "markdown", + "state": { + "file": "README.md", + "mode": "source", + "source": false + }, "icon": "lucide-file", - "title": "New tab" + "title": "README" + } + }, + { + "id": "5b53d69b3fd58c09", + "type": "leaf", + "state": { + "type": "markdown", + "state": { + "file": "chapters/02_Usage.md", + "mode": "source", + "source": false + }, + "icon": "lucide-file", + "title": "02_Usage" } } ] @@ -266,9 +284,11 @@ }, "active": "72de52a10ebaa6e5", "lastOpenFiles": [ + "conf/sedTQLO9w", + "chapters/02_Usage.md", + "README.md", "chapters/03_Features.md", "chapters/Appendix.md", - "chapters/02_Usage.md", "conf/sedkKV6c0", "conf/sedAqcSmo", "conf/sedk8YBK0", @@ -283,7 +303,6 @@ "conf/sedBapyXA", "conf/sedYZ2rBJ", "conf/sedbEPwZC", - "README.md", "chapters/00_Introduction.md", "chapters/04_Design", "conf/frontmatter-docx.md", diff --git a/README.md b/README.md index ad05b5c..e9b2ffb 100644 --- a/README.md +++ b/README.md @@ -63,3 +63,29 @@ scripts/setup-linux-deb.sh ``` +### Testing Build Environment + +``` +make all +``` + +If this succeeds you have a build environment. + +## Create a New Project + +``` +./scripts/new-project.sh +``` + +``` +cd +``` + +**Update Config Files**: + +1. `metadata.yaml` +2. `templates/pandoc.yaml` +3. Edit Chapter Content +4. Build your book + + diff --git a/build/docx/basic-book-builder.docx b/build/docx/basic-book-builder.docx index ea7836a..d50d537 100644 Binary files a/build/docx/basic-book-builder.docx and b/build/docx/basic-book-builder.docx differ diff --git a/build/html/basic-book-builder.html b/build/html/basic-book-builder.html index 9e7f962..37e2e2e 100644 --- a/build/html/basic-book-builder.html +++ b/build/html/basic-book-builder.html @@ -51,7 +51,7 @@

Basic Book Builder

-

A Pandoc template for building books, documents and articles

+

A Pandoc build process for books, docs and articles

Cover illustration @@ -64,7 +64,7 @@

Basic Book Builder

- A Pandoc template for building books, documents and articles + A Pandoc build process for books, docs and articles @@ -151,6 +151,8 @@ id="toc-zotero-configuration-optional">Zotero Configuration
  • Usage
      +
    • Creating a +Project
    • Editing Content
    • Building @@ -169,6 +171,9 @@ Content
    • Chapters
    • Appendixes
      • @@ -266,7 +271,36 @@ then you have a working build environment.

      Zotero Configuration (Optional)

      Usage

      +

      Creating a Project

      +

      To create a new Project based on the Basic Book Builder template:

      +
        +
      1. Run the new-project.sh script.
        2. +
      +
      ./scripts/new-project.sh <PATH_TO_PROJECT>
      +
        +
      • should be outside of the +basic-book-builder directory
        • +
      +
      cd <PATH_TO_PROJECT>
      +

      Update:

      +
        +
      1. metadata.yaml
        2. +
      2. templates/pandoc.yaml
        3. +
      +
      +

      Suggestion

      +

      Create a git repository to version control your new + 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

      PDF

      make pdf
      @@ -297,10 +331,12 @@ work.

      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

      +

      Front matter content is manged in:

      +
        +
      • templates/frontmatter.tex
        • +
      • templates/frontmatter.html
        • +
      • templates/frontmatter-md.html
        • +

      Tip

      Unfortunately when you edit one, you need to edit the respective @@ -314,12 +350,19 @@ of the Title Page.

      Meta Data Page

      Edit the Front-matter files to modify the 2nd page -Metadata format. ### Cover Illustration

      +Metadata format.

      +

      Cover Illustration

      Edit the Front-matter files to optionally un-comment -the Cover Art Acknowledgement. - This is disabled by default ### -Dedication

      +the Cover Art Acknowledgement.

      +
        +
      • This is disabled by default
        • +
      +

      Dedication

      Edit the Front-matter files to modify un-comment the -Book Dedication. - This is disabled by default ## Table of Contents

      +Book Dedication.

      +
        +
      • This is disabled by default ## Table of Contents
        • +

      Chapters

      Chapter Markdown source files are located in the chapters directory. Edit the @@ -351,67 +394,84 @@ files are in what order.

      A few call-out box styles have been custom added to easily highlight certain types of content.

      -

      Markdown Code

      +

      Markdown Example

      [!established] Green Call-out Title
 A green box
      +

      Will render:

      Green Call-out Title

      A green box

      -

      Markdown Code

      +

      Markdown Example

      [!proposed] Blue Call-out Title
 A blue box
      +

      Will render:

      Blue Call-out Title

      A blue box

      -

      Markdown Code

      +

      Markdown Example

      +
      [!info] Info Box
+Same as a blue box
      +
      +

      Will render:

      +
      +

      Info Box

      +

      Same as a blue box

      +
      +
      +
      +

      Markdown Example

      [!speculative] Purple Call-out Title
 A purple box
      +

      Will render:

      Purple Call-out Title

      A purple box

      -

      Markdown Code

      +

      Markdown Example

      [!caution] Caution Note
 Beware of this section.  AKA a orange box.
      +

      Will render:

      Caution Note

      Beware of this section. AKA a orange box.

      -

      Markdown Code

      +

      Markdown Example

      [!warning] Warning Note
 Same as the Caution Box
      +

      Will render:

      Warning Note

      Same as the Caution Box

      -

      Markdown Code

      +

      Markdown Example

      [!danger] Alert
 A slightly stronger warning.  AKA a red box.
      +

      Will render:

      Alert

      A slightly stronger warning. AKA a red box.

      -

      Markdown Code

      +

      Markdown Example

      [!code] Code Block
 '''
 if [ true ]; do
@@ -419,6 +479,7 @@ if [ true ]; do
 fi
 '''
      +

      Will render:

      Code Block

      if [ true ]; do
@@ -427,7 +488,7 @@ fi
      -

      Markdown Code

      +

      Markdown Example

      [!cli] Command line
 A command line example
 '''
@@ -435,6 +496,7 @@ $ ls
 build  chapters  conf  filters  lib  LICENSE.md  Makefile  metadata.yaml  >README.md  scripts  templates
 '''
      +

      Will render:

      Command line

      A command line example

      diff --git a/build/latex/basic-book-builder.aux b/build/latex/basic-book-builder.aux index aea6e52..c2b63c2 100644 --- a/build/latex/basic-book-builder.aux +++ b/build/latex/basic-book-builder.aux @@ -40,113 +40,115 @@ \@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}{4}{subsection.3.2.5}\protected@file@percent } -\newlabel{make-all}{{3.2.5}{4}{Make All}{subsection.3.2.5}{}} -\@writefile{toc}{\contentsline {chapter}{\numberline {4}Features}{5}{chapter.4}\protected@file@percent } +\@writefile{toc}{\contentsline {section}{\numberline {3.1}Creating a Project}{4}{section.3.1}\protected@file@percent } +\newlabel{creating-a-project}{{3.1}{4}{Creating a Project}{section.3.1}{}} +\@writefile{toc}{\contentsline {section}{\numberline {3.2}Editing Content}{4}{section.3.2}\protected@file@percent } +\newlabel{editing-content}{{3.2}{4}{Editing Content}{section.3.2}{}} +\@writefile{toc}{\contentsline {section}{\numberline {3.3}Building}{4}{section.3.3}\protected@file@percent } +\newlabel{building}{{3.3}{4}{Building}{section.3.3}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.1}PDF}{4}{subsection.3.3.1}\protected@file@percent } +\newlabel{pdf}{{3.3.1}{4}{PDF}{subsection.3.3.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.2}HTML}{5}{subsection.3.3.2}\protected@file@percent } +\newlabel{html}{{3.3.2}{5}{HTML}{subsection.3.3.2}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.3}DocX}{5}{subsection.3.3.3}\protected@file@percent } +\newlabel{docx}{{3.3.3}{5}{DocX}{subsection.3.3.3}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.4}ODT}{5}{subsection.3.3.4}\protected@file@percent } +\newlabel{odt}{{3.3.4}{5}{ODT}{subsection.3.3.4}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.3.5}Make All}{5}{subsection.3.3.5}\protected@file@percent } +\newlabel{make-all}{{3.3.5}{5}{Make All}{subsection.3.3.5}{}} +\@writefile{toc}{\contentsline {chapter}{\numberline {4}Features}{6}{chapter.4}\protected@file@percent } \@writefile{lof}{\addvspace {10\p@ }} \@writefile{lot}{\addvspace {10\p@ }} -\newlabel{features}{{4}{5}{Features}{chapter.4}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.1}Metadata}{5}{section.4.1}\protected@file@percent } -\newlabel{metadata}{{4.1}{5}{Metadata}{section.4.1}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.2}Front-matter}{5}{section.4.2}\protected@file@percent } -\newlabel{front-matter}{{4.2}{5}{Front-matter}{section.4.2}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{5}{subsection.4.2.1}\protected@file@percent } -\newlabel{meta-data-page}{{4.2.1}{5}{Meta Data Page}{subsection.4.2.1}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{5}{subsection.4.2.2}\protected@file@percent } -\newlabel{cover-illustration}{{4.2.2}{5}{Cover Illustration}{subsection.4.2.2}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.3}Dedication}{6}{subsection.4.2.3}\protected@file@percent } -\newlabel{dedication}{{4.2.3}{6}{Dedication}{subsection.4.2.3}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.3}Chapters}{6}{section.4.3}\protected@file@percent } -\newlabel{chapters}{{4.3}{6}{Chapters}{section.4.3}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.4}Appendixes}{6}{section.4.4}\protected@file@percent } -\newlabel{appendixes}{{4.4}{6}{Appendixes}{section.4.4}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.5}Glossary}{6}{section.4.5}\protected@file@percent } -\newlabel{glossary}{{4.5}{6}{Glossary}{section.4.5}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.6}Index}{6}{section.4.6}\protected@file@percent } -\newlabel{index}{{4.6}{6}{Index}{section.4.6}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{6}{subsection.4.6.1}\protected@file@percent } -\newlabel{markdown-indexes}{{4.6.1}{6}{Markdown Indexes}{subsection.4.6.1}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.7}Bibliography}{6}{section.4.7}\protected@file@percent } -\newlabel{bibliography}{{4.7}{6}{Bibliography}{section.4.7}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{6}{subsection.4.7.1}\protected@file@percent } -\newlabel{zotero-integration}{{4.7.1}{6}{Zotero Integration}{subsection.4.7.1}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{7}{subsection.4.7.2}\protected@file@percent } -\newlabel{obsidian-citations}{{4.7.2}{7}{Obsidian Citations}{subsection.4.7.2}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.8}Mathjax Equations}{7}{section.4.8}\protected@file@percent } -\newlabel{mathjax-equations}{{4.8}{7}{Mathjax Equations}{section.4.8}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{7}{subsection.4.8.1}\protected@file@percent } -\newlabel{left-justified-inline}{{4.8.1}{7}{Left Justified / Inline}{subsection.4.8.1}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.8.2}Centered}{7}{subsection.4.8.2}\protected@file@percent } -\newlabel{centered}{{4.8.2}{7}{Centered}{subsection.4.8.2}{}} -\@writefile{toc}{\contentsline {section}{\numberline {4.9}Custom Markdown}{7}{section.4.9}\protected@file@percent } -\newlabel{custom-markdown}{{4.9}{7}{Custom Markdown}{section.4.9}{}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.9.1}Call-outs}{7}{subsection.4.9.1}\protected@file@percent } -\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 } +\newlabel{features}{{4}{6}{Features}{chapter.4}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.1}Metadata}{6}{section.4.1}\protected@file@percent } +\newlabel{metadata}{{4.1}{6}{Metadata}{section.4.1}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.2}Front-matter}{6}{section.4.2}\protected@file@percent } +\newlabel{front-matter}{{4.2}{6}{Front-matter}{section.4.2}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{6}{subsection.4.2.1}\protected@file@percent } +\newlabel{meta-data-page}{{4.2.1}{6}{Meta Data Page}{subsection.4.2.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{6}{subsection.4.2.2}\protected@file@percent } +\newlabel{cover-illustration}{{4.2.2}{6}{Cover Illustration}{subsection.4.2.2}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.2.3}Dedication}{7}{subsection.4.2.3}\protected@file@percent } +\newlabel{dedication}{{4.2.3}{7}{Dedication}{subsection.4.2.3}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.3}Chapters}{7}{section.4.3}\protected@file@percent } +\newlabel{chapters}{{4.3}{7}{Chapters}{section.4.3}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.4}Appendixes}{7}{section.4.4}\protected@file@percent } +\newlabel{appendixes}{{4.4}{7}{Appendixes}{section.4.4}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.5}Glossary}{7}{section.4.5}\protected@file@percent } +\newlabel{glossary}{{4.5}{7}{Glossary}{section.4.5}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.6}Index}{7}{section.4.6}\protected@file@percent } +\newlabel{index}{{4.6}{7}{Index}{section.4.6}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{7}{subsection.4.6.1}\protected@file@percent } +\newlabel{markdown-indexes}{{4.6.1}{7}{Markdown Indexes}{subsection.4.6.1}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.7}Bibliography}{7}{section.4.7}\protected@file@percent } +\newlabel{bibliography}{{4.7}{7}{Bibliography}{section.4.7}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{7}{subsection.4.7.1}\protected@file@percent } +\newlabel{zotero-integration}{{4.7.1}{7}{Zotero Integration}{subsection.4.7.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{8}{subsection.4.7.2}\protected@file@percent } +\newlabel{obsidian-citations}{{4.7.2}{8}{Obsidian Citations}{subsection.4.7.2}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.8}Mathjax Equations}{8}{section.4.8}\protected@file@percent } +\newlabel{mathjax-equations}{{4.8}{8}{Mathjax Equations}{section.4.8}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{8}{subsection.4.8.1}\protected@file@percent } +\newlabel{left-justified-inline}{{4.8.1}{8}{Left Justified / Inline}{subsection.4.8.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.8.2}Centered}{8}{subsection.4.8.2}\protected@file@percent } +\newlabel{centered}{{4.8.2}{8}{Centered}{subsection.4.8.2}{}} +\@writefile{toc}{\contentsline {section}{\numberline {4.9}Custom Markdown}{8}{section.4.9}\protected@file@percent } +\newlabel{custom-markdown}{{4.9}{8}{Custom Markdown}{section.4.9}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {4.9.1}Call-outs}{8}{subsection.4.9.1}\protected@file@percent } +\newlabel{call-outs}{{4.9.1}{8}{Call-outs}{subsection.4.9.1}{}} +\@writefile{toc}{\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{12}{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}{}} +\newlabel{appendix-a-build-environment-notes}{{A}{12}{Appendix A: Build Environment Notes}{appendix.A}{}} +\@writefile{toc}{\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{12}{section.A.1}\protected@file@percent } +\newlabel{installing-pre-requisites}{{A.1}{12}{Installing Pre-Requisites}{section.A.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.1}Required}{12}{subsection.A.1.1}\protected@file@percent } +\newlabel{required}{{A.1.1}{12}{Required}{subsection.A.1.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{12}{subsubsection.A.1.1.1}\protected@file@percent } +\newlabel{pandoc}{{A.1.1.1}{12}{Pandoc}{subsubsection.A.1.1.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{12}{subsubsection.A.1.1.2}\protected@file@percent } +\newlabel{code-editor}{{A.1.1.2}{12}{Code Editor}{subsubsection.A.1.1.2}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{12}{subsubsection.A.1.1.3}\protected@file@percent } +\newlabel{jq-and-yq}{{A.1.1.3}{12}{jq and yq}{subsubsection.A.1.1.3}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{12}{subsubsection.A.1.1.4}\protected@file@percent } +\newlabel{texlive}{{A.1.1.4}{12}{texlive}{subsubsection.A.1.1.4}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{13}{subsubsection.A.1.1.5}\protected@file@percent } +\newlabel{mathjax}{{A.1.1.5}{13}{MathJax}{subsubsection.A.1.1.5}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.2}Optional}{13}{subsection.A.1.2}\protected@file@percent } +\newlabel{optional}{{A.1.2}{13}{Optional}{subsection.A.1.2}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{13}{subsubsection.A.1.2.1}\protected@file@percent } +\newlabel{obsidian}{{A.1.2.1}{13}{Obsidian}{subsubsection.A.1.2.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{13}{subsubsection.A.1.2.2}\protected@file@percent } +\newlabel{zotero}{{A.1.2.2}{13}{Zotero}{subsubsection.A.1.2.2}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{14}{paragraph.A.1.2.2.1}\protected@file@percent } +\newlabel{better-bibtex-for-zotero}{{A.1.2.2.1}{14}{Better BibTex for Zotero}{paragraph.A.1.2.2.1}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{14}{paragraph.A.1.2.2.2}\protected@file@percent } +\newlabel{export-citations.bib}{{A.1.2.2.2}{14}{Export citations.bib}{paragraph.A.1.2.2.2}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{14}{paragraph.A.1.2.2.3}\protected@file@percent } +\newlabel{zotero-connector-browser-plugin}{{A.1.2.2.3}{14}{Zotero Connector Browser Plugin}{paragraph.A.1.2.2.3}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{14}{subsubsection.A.1.2.3}\protected@file@percent } +\newlabel{lmodern}{{A.1.2.3}{14}{lmodern}{subsubsection.A.1.2.3}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{14}{subsubsection.A.1.2.4}\protected@file@percent } +\newlabel{epubcheck}{{A.1.2.4}{14}{epubcheck}{subsubsection.A.1.2.4}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{14}{subsubsection.A.1.2.5}\protected@file@percent } +\newlabel{foliate}{{A.1.2.5}{14}{foliate}{subsubsection.A.1.2.5}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{14}{subsubsection.A.1.2.6}\protected@file@percent } +\newlabel{calibre}{{A.1.2.6}{14}{calibre}{subsubsection.A.1.2.6}{}} +\@writefile{toc}{\contentsline {section}{\numberline {A.2}Editing the Configuration}{14}{section.A.2}\protected@file@percent } +\newlabel{editing-the-configuration}{{A.2}{14}{Editing the Configuration}{section.A.2}{}} \gdef \LT@i {\LT@entry {1}{86.68152pt}\LT@entry {1}{383.07349pt}} -\newlabel{glossary-1}{{A.2}{14}{Glossary}{appendix*.2}{}} -\@writefile{toc}{\contentsline {chapter}{Glossary}{14}{appendix*.2}\protected@file@percent } -\@writefile{toc}{\contentsline {chapter}{Index}{16}{appendix*.3}\protected@file@percent } +\newlabel{glossary-1}{{A.2}{15}{Glossary}{appendix*.2}{}} +\@writefile{toc}{\contentsline {chapter}{Glossary}{15}{appendix*.2}\protected@file@percent } +\@writefile{toc}{\contentsline {chapter}{Index}{17}{appendix*.3}\protected@file@percent } \bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext } \bibcite{ref-JohnHaverlackACEP}{\citeproctext } \bibcite{ref-PandocIndex}{\citeproctext } \bibcite{ref-JehaverlackBasicbookbuilderPandoca}{\citeproctext } \bibcite{ref-JohnHaverlackACEP}{\citeproctext } \bibcite{ref-PandocIndex}{\citeproctext } -\newlabel{bibliography-1}{{A.2}{18}{Bibliography}{appendix*.4}{}} -\@writefile{toc}{\contentsline {chapter}{Bibliography}{18}{appendix*.4}\protected@file@percent } -\newlabel{refs}{{A.2}{18}{Bibliography}{section*.5}{}} -\gdef \@abspage@last{23} +\newlabel{bibliography-1}{{A.2}{19}{Bibliography}{appendix*.4}{}} +\@writefile{toc}{\contentsline {chapter}{Bibliography}{19}{appendix*.4}\protected@file@percent } +\newlabel{refs}{{A.2}{19}{Bibliography}{section*.5}{}} +\gdef \@abspage@last{24} diff --git a/build/latex/basic-book-builder.log b/build/latex/basic-book-builder.log index ece47b2..4208e2b 100644 --- a/build/latex/basic-book-builder.log +++ b/build/latex/basic-book-builder.log @@ -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 14:53 +This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Debian) (preloaded format=xelatex 2025.11.6) 5 FEB 2026 15:14 entering extended mode restricted \write18 enabled. file:line:error style messages enabled. @@ -1776,110 +1776,110 @@ k-builder.git[] Chapter 3. [4 -] +] [5] Chapter 4. -[5 +[6 -] [6] [7] [8] -Overfull \hbox (262.34303pt too wide) in paragraph at lines 792--792 +] [7] [8] [9] [10] +Overfull \hbox (262.34303pt too wide) in paragraph at lines 862--862 []\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 + +Overfull \hbox (255.14304pt too wide) in paragraph at lines 875--875 []\TU/NotoSansMono(0)/m/n/12 build chapters conf filters lib LICENSE.md M akefile metadata.yaml README.md scripts templates[] [] -[10] +[11] Appendix A. -Overfull \hbox (12.85075pt too wide) in paragraph at lines 815--815 +Overfull \hbox (12.85075pt too wide) in paragraph at lines 885--885 |\TU/NotoSerif(0)/b/n/24.88 Appendix A: Build Environment Notes| [] -Overfull \hbox (295.84503pt too wide) in paragraph at lines 836--837 +Overfull \hbox (295.84503pt too wide) in paragraph at lines 906--907 []\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 842--844 +Underfull \hbox (badness 10000) in paragraph at lines 912--914 [][][]\TU/NotoSerif(0)/m/n/12 VSCodium[][] is recommend for privacy (telemetry/ tracking) reasons - [] -[11 +[12 ] -Overfull \hbox (358.24503pt too wide) in paragraph at lines 905--905 +Overfull \hbox (358.24503pt too wide) in paragraph at lines 975--975 []\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[] [] -[12] -Overfull \hbox (12.02498pt too wide) in paragraph at lines 950--952 +[13] +Overfull \hbox (12.02498pt too wide) in paragraph at lines 1020--1022 []\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 960--961 +Overfull \hbox (107.64897pt too wide) in paragraph at lines 1030--1031 []\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 989--989 +Overfull \hbox (430.245pt too wide) in paragraph at lines 1059--1059 []\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[] [] -[13] -Underfull \hbox (badness 10000) in alignment at lines 1016--1024 +[14] +Underfull \hbox (badness 10000) in alignment at lines 1086--1094 [] [] [] -Underfull \hbox (badness 10000) in alignment at lines 1024--1026 +Underfull \hbox (badness 10000) in alignment at lines 1094--1096 [] [] [] -Overfull \hbox (1.68248pt too wide) in paragraph at lines 1030--1030 +Overfull \hbox (1.68248pt too wide) in paragraph at lines 1100--1100 []|\TU/NotoSerif(0)/b/n/12 Bibliography| [] -Underfull \hbox (badness 10000) in alignment at lines 1026--1078 +Underfull \hbox (badness 10000) in alignment at lines 1096--1148 [] [] [] -[14 +[15 -] [15] (./basic-book-builder.ind) [16 +] [16] (./basic-book-builder.ind) [17 -] [17 +] [18 ] -Underfull \hbox (badness 3977) in paragraph at lines 1113--1115 +Underfull \hbox (badness 3977) in paragraph at lines 1183--1185 []\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 +Underfull \hbox (badness 3977) in paragraph at lines 1195--1197 []\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 -] [19 +] [20 ] (./basic-book-builder.aux) @@ -1887,12 +1887,12 @@ LaTeX Warning: There were multiply-defined labels. ) Here is how much of TeX's memory you used: - 36441 strings out of 478775 - 750960 string characters out of 5850945 + 36437 strings out of 478775 + 750795 string characters out of 5850945 1859991 words of memory out of 5000000 - 55864 multiletter control sequences out of 15000+600000 + 55860 multiletter control sequences out of 15000+600000 516036 words of font info for 92 fonts, out of 8000000 for 9000 14 hyphenation exceptions out of 8191 - 90i,12n,122p,1207b,1051s stack positions out of 10000i,1000n,20000p,200000b,200000s + 90i,11n,122p,1207b,959s stack positions out of 10000i,1000n,20000p,200000b,200000s -Output written on basic-book-builder.pdf (23 pages). +Output written on basic-book-builder.pdf (24 pages). diff --git a/build/latex/basic-book-builder.pdf b/build/latex/basic-book-builder.pdf index fc5f114..1212610 100644 Binary files a/build/latex/basic-book-builder.pdf and b/build/latex/basic-book-builder.pdf differ diff --git a/build/latex/basic-book-builder.tex b/build/latex/basic-book-builder.tex index 019b1d8..c8009cf 100644 --- a/build/latex/basic-book-builder.tex +++ b/build/latex/basic-book-builder.tex @@ -497,8 +497,62 @@ make all \chapter{Usage}\label{usage} +\section{Creating a Project}\label{creating-a-project} + +To create a new Project based on the Basic Book Builder template: + +\begin{enumerate} +\def\labelenumi{\arabic{enumi}.} +\tightlist +\item + Run the new-project.sh script. +\end{enumerate} + +\begin{verbatim} +./scripts/new-project.sh +\end{verbatim} + +\begin{itemize} +\tightlist +\item + should be outside of the \textbf{basic-book-builder} directory +\end{itemize} + +\begin{verbatim} +cd +\end{verbatim} + +Update: + +\begin{enumerate} +\def\labelenumi{\arabic{enumi}.} +\tightlist +\item + \texttt{metadata.yaml} +\item + \texttt{templates/pandoc.yaml} +\end{enumerate} + +\begin{quote} +{[}!info{]} Suggestion Create a git repository to version control your +new content. +\end{quote} + \section{Editing Content}\label{editing-content} +Edit your source content Markdown under the \texttt{chapters} directory. + +\textbf{Optional} + +\begin{itemize} +\tightlist +\item + Open your \texttt{\textless{}PATH\_TO\_PROJECT\textgreater{}} + directory as an Obsidian vault. +\item + Edit your Markdown with Obsidian +\end{itemize} + \section{Building}\label{building} \subsection{PDF}\label{pdf} @@ -694,6 +748,22 @@ A blue box \begin{center}\rule{0.5\linewidth}{0.5pt}\end{center} +\begin{codebox}[Markdown Example] +\begin{verbatim} +[!info] Info Box +Same as a blue box +\end{verbatim} + +\end{codebox} + +Will render: + +\begin{quote} +{[}!info{]} Info Box Same as a blue box +\end{quote} + +\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center} + \begin{codebox}[Markdown Example] \begin{verbatim} [!speculative] Purple Call-out Title diff --git a/build/latex/basic-book-builder.toc b/build/latex/basic-book-builder.toc index 492788c..f06e4b9 100644 --- a/build/latex/basic-book-builder.toc +++ b/build/latex/basic-book-builder.toc @@ -6,51 +6,52 @@ \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 {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}{4}{subsection.3.2.5}% -\contentsline {chapter}{\numberline {4}Features}{5}{chapter.4}% -\contentsline {section}{\numberline {4.1}Metadata}{5}{section.4.1}% -\contentsline {section}{\numberline {4.2}Front-matter}{5}{section.4.2}% -\contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{5}{subsection.4.2.1}% -\contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{5}{subsection.4.2.2}% -\contentsline {subsection}{\numberline {4.2.3}Dedication}{6}{subsection.4.2.3}% -\contentsline {section}{\numberline {4.3}Chapters}{6}{section.4.3}% -\contentsline {section}{\numberline {4.4}Appendixes}{6}{section.4.4}% -\contentsline {section}{\numberline {4.5}Glossary}{6}{section.4.5}% -\contentsline {section}{\numberline {4.6}Index}{6}{section.4.6}% -\contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{6}{subsection.4.6.1}% -\contentsline {section}{\numberline {4.7}Bibliography}{6}{section.4.7}% -\contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{6}{subsection.4.7.1}% -\contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{7}{subsection.4.7.2}% -\contentsline {section}{\numberline {4.8}Mathjax Equations}{7}{section.4.8}% -\contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{7}{subsection.4.8.1}% -\contentsline {subsection}{\numberline {4.8.2}Centered}{7}{subsection.4.8.2}% -\contentsline {section}{\numberline {4.9}Custom Markdown}{7}{section.4.9}% -\contentsline {subsection}{\numberline {4.9.1}Call-outs}{7}{subsection.4.9.1}% -\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{11}{appendix.A}% -\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{11}{section.A.1}% -\contentsline {subsection}{\numberline {A.1.1}Required}{11}{subsection.A.1.1}% -\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}% +\contentsline {section}{\numberline {3.1}Creating a Project}{4}{section.3.1}% +\contentsline {section}{\numberline {3.2}Editing Content}{4}{section.3.2}% +\contentsline {section}{\numberline {3.3}Building}{4}{section.3.3}% +\contentsline {subsection}{\numberline {3.3.1}PDF}{4}{subsection.3.3.1}% +\contentsline {subsection}{\numberline {3.3.2}HTML}{5}{subsection.3.3.2}% +\contentsline {subsection}{\numberline {3.3.3}DocX}{5}{subsection.3.3.3}% +\contentsline {subsection}{\numberline {3.3.4}ODT}{5}{subsection.3.3.4}% +\contentsline {subsection}{\numberline {3.3.5}Make All}{5}{subsection.3.3.5}% +\contentsline {chapter}{\numberline {4}Features}{6}{chapter.4}% +\contentsline {section}{\numberline {4.1}Metadata}{6}{section.4.1}% +\contentsline {section}{\numberline {4.2}Front-matter}{6}{section.4.2}% +\contentsline {subsection}{\numberline {4.2.1}Meta Data Page}{6}{subsection.4.2.1}% +\contentsline {subsection}{\numberline {4.2.2}Cover Illustration}{6}{subsection.4.2.2}% +\contentsline {subsection}{\numberline {4.2.3}Dedication}{7}{subsection.4.2.3}% +\contentsline {section}{\numberline {4.3}Chapters}{7}{section.4.3}% +\contentsline {section}{\numberline {4.4}Appendixes}{7}{section.4.4}% +\contentsline {section}{\numberline {4.5}Glossary}{7}{section.4.5}% +\contentsline {section}{\numberline {4.6}Index}{7}{section.4.6}% +\contentsline {subsection}{\numberline {4.6.1}Markdown Indexes}{7}{subsection.4.6.1}% +\contentsline {section}{\numberline {4.7}Bibliography}{7}{section.4.7}% +\contentsline {subsection}{\numberline {4.7.1}Zotero Integration}{7}{subsection.4.7.1}% +\contentsline {subsection}{\numberline {4.7.2}Obsidian Citations}{8}{subsection.4.7.2}% +\contentsline {section}{\numberline {4.8}Mathjax Equations}{8}{section.4.8}% +\contentsline {subsection}{\numberline {4.8.1}Left Justified / Inline}{8}{subsection.4.8.1}% +\contentsline {subsection}{\numberline {4.8.2}Centered}{8}{subsection.4.8.2}% +\contentsline {section}{\numberline {4.9}Custom Markdown}{8}{section.4.9}% +\contentsline {subsection}{\numberline {4.9.1}Call-outs}{8}{subsection.4.9.1}% +\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{12}{appendix.A}% +\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{12}{section.A.1}% +\contentsline {subsection}{\numberline {A.1.1}Required}{12}{subsection.A.1.1}% +\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{12}{subsubsection.A.1.1.1}% +\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{12}{subsubsection.A.1.1.2}% +\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{12}{subsubsection.A.1.1.3}% +\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{12}{subsubsection.A.1.1.4}% +\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{13}{subsubsection.A.1.1.5}% +\contentsline {subsection}{\numberline {A.1.2}Optional}{13}{subsection.A.1.2}% +\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{13}{subsubsection.A.1.2.1}% +\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{13}{subsubsection.A.1.2.2}% +\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{14}{paragraph.A.1.2.2.1}% +\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{14}{paragraph.A.1.2.2.2}% +\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{14}{paragraph.A.1.2.2.3}% +\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{14}{subsubsection.A.1.2.3}% +\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{14}{subsubsection.A.1.2.4}% +\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{14}{subsubsection.A.1.2.5}% +\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{14}{subsubsection.A.1.2.6}% +\contentsline {section}{\numberline {A.2}Editing the Configuration}{14}{section.A.2}% +\contentsline {chapter}{Glossary}{15}{appendix*.2}% +\contentsline {chapter}{Index}{17}{appendix*.3}% +\contentsline {chapter}{Bibliography}{19}{appendix*.4}% diff --git a/build/odt/basic-book-builder.odt b/build/odt/basic-book-builder.odt index 07194e2..188391c 100644 Binary files a/build/odt/basic-book-builder.odt and b/build/odt/basic-book-builder.odt differ diff --git a/build/pdf/basic-book-builder.pdf b/build/pdf/basic-book-builder.pdf index fc5f114..1212610 100644 Binary files a/build/pdf/basic-book-builder.pdf and b/build/pdf/basic-book-builder.pdf differ