diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 61a0b57..c37e6b7 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -13,12 +13,12 @@ "state": { "type": "markdown", "state": { - "file": "chapters/AppendixA.md", + "file": "chapters/02_Usage.md", "mode": "source", "source": false }, "icon": "lucide-file", - "title": "AppendixA" + "title": "02_Usage" } } ] @@ -270,32 +270,32 @@ }, "active": "01161538f53367e8", "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", "conf/sedBapyXA", "conf/sedYZ2rBJ", "conf/sedbEPwZC", - "chapters/02_Usage.md", - "chapters/04_Design.md", "README.md", "chapters/00_Introduction.md", "chapters/04_Design", - "conf/odt.yaml", "conf/frontmatter-docx.md", - "conf/docx.yaml", - "chapters/03_Features.md", - "conf/sedMSkcEz", - "conf/sedsOEcAe", - "conf/sedwM39Vv", - "conf/sedqNCjeN", - "chapters/AppendixA.md", "templates/frontmatter-docx.md", - "chapters/AppendixB.md", "chapters/02_Features.md", "chapters/Preface.md", "chapters/Index.md", "chapters/Glossary.md", - "chapters/Bibliography.md", - "chapters/Appendix.md", "lib/img/unit-circle-with-tau.png", "lib/img/unit-circle-with-pi.png.png", "lib/img/unit-circle-with-pi.png", diff --git a/build/docx/basic-book-builder.docx b/build/docx/basic-book-builder.docx index 4dbf611..ea7836a 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 0c86e42..9e7f962 100644 --- a/build/html/basic-book-builder.html +++ b/build/html/basic-book-builder.html @@ -161,7 +161,42 @@ Content
  • ODT
  • Make All
    • -
  • Callouts
    • + +
  • Features +
  • Appendix A: Build @@ -176,8 +211,9 @@ id="toc-installing-pre-requisites">Installing Pre-Requisites
  • Editing the Configuration
    • -
  • Glossary
    • -
  • Bibliography
    • +
  • Glossary
    • +
  • Bibliography

    • Introduction

    @@ -255,37 +291,155 @@ work.

    Make All

    To build all supported formats

    make all
    -

    Callouts

    -

    A few callout box styles have been added to easily highlight -content.

    +

    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

    +
    +

    Tip

    +

    Unfortunately when you edit one, you need to edit the respective +changes to the other front-matter formats. ### Title Page

    +
    +

    Edit the Front-matter files to modify the formatting +of the Title Page.

    +
    +

    Tip

    +

    You’ll need to modify the HTML / LaTex.

    +
    +

    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

    +

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

    +

    Chapters

    +

    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.

    +
    +

    Markdown Code

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

    Established Concept

    -

    Einsteins Relativistic Dynamics Equations E2 = (m0 ⋅ c2)2 + (p ⋅ c)2

    +

    Green Call-out Title

    +

    A green box

    +
    +
    +
    +

    Markdown Code

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

    Proposed Concept

    -

    With the speed of light, c = 1: E2 = m02 + p2

    +

    Blue Call-out Title

    +

    A blue box

    +
    +
    +
    +

    Markdown Code

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

    Speculative Concept

    -

    With the speed of light, c = 1: E2 = m02 + p2

    +

    Purple Call-out Title

    +

    A purple box

    +
    +
    +
    +

    Markdown Code

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

    Caution Note

    -

    Beware of this section.

    +

    Beware of this section. AKA a orange box.

    +
    +
    +
    +

    Markdown Code

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

    Warning Note

    -

    Beware of this section.

    +

    Same as the Caution Box

    +
    +
    +
    +

    Markdown Code

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

    Alerts

    -

    Extreme Highlight

    +

    Alert

    +

    A slightly stronger warning. AKA a red box.

    +
    +
    +
    +

    Markdown Code

    +
    [!code] Code Block
+'''
+if [ true ]; do
+  echo "The Cow Jumps over the Moon"
+fi
+'''
    +
    +
    +

    Code Block

    +
    if [ true ]; do
+  echo "The Cow Jumps over the Moon"
+fi
    +
    +
    +
    +

    Markdown Code

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

    Command line

    +

    A command line example

    +
    $ ls
+build  chapters  conf  filters  lib  LICENSE.md  Makefile  metadata.yaml  README.md  scripts  templates

    Appendix A

    Appendix A: Build @@ -397,7 +551,7 @@ citation database.

    sudo apt install calibre

    Editing the Configuration

    -

    Glossary

    +

    Glossary

    @@ -525,7 +679,7 @@ citation processing with Pandoc.
    -

    Bibliography

    +

    Bibliography

    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 -(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' (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. @@ -1569,15 +1581,15 @@ t=math;language=dflt;" (fontspec) =0pt\relax \fontdimen 21\font =0pt\relax 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' (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 -(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' (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. @@ -1646,22 +1658,22 @@ ath.otf]/OT:script=math;language=dflt;+ssty=1;" (fontspec) =8.95407pt\relax \fontdimen 13\font =0pt\relax LaTeX Font Info: Encoding `OMX' has changed to `TU' for symbol font -(Font) `largesymbols' in the math version `normal' on input line 2 -94. +(Font) `largesymbols' in the math version `normal' on input line 3 +11. LaTeX Font Info: Overwriting symbol font `largesymbols' in version `normal' (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 -(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' (Font) OMX/lmex/m/n --> TU/latinmodern-math.otf(3)/b/n on inpu -t line 294. -LaTeX Info: Redefining \microtypecontext on input line 294. -Package microtype Info: Applying patch `item' on input line 294. -Package microtype Info: Applying patch `toc' on input line 294. -Package microtype Info: Applying patch `eqnum' on input line 294. -Package microtype Info: Applying patch `footnote' on input line 294. +t line 311. +LaTeX Info: Redefining \microtypecontext on input line 311. +Package microtype Info: Applying patch `item' on input line 311. +Package microtype Info: Applying patch `toc' on input line 311. +Package microtype Info: Applying patch `eqnum' on input line 311. +Package microtype Info: Applying patch `footnote' on input line 311. Package microtype Info: Character protrusion enabled (level 2). Package microtype Info: Using protrusion set `basicmath'. 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) See the microtype manual for details. \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 -(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 -(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 -(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) [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 -(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 -(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 -(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 -(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 -29. +46. (/usr/share/texmf/tex/latex/lm/omllmm.fd 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 -(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 -(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 -(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 -(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 -(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 -(Font) scaled to size 7.461pt on input line 329. -LaTeX Font Info: Trying to load font information for U+msa 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 346 . (/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 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 @@ -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) ) 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 -(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 -(Font) scaled to size 14.4pt on input line 349. +(Font) scaled to size 14.4pt on input line 366. [2] (./basic-book-builder.toc [1 @@ -1751,9 +1763,9 @@ Chapter 1. ] Chapter 2. 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 k-builder.git[] [] @@ -1764,92 +1776,110 @@ k-builder.git[] Chapter 3. [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. -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 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/ 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 idian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb[] [] - -Underfull \vbox (badness 1888) has occurred while \output is active [] - - [7] -Overfull \hbox (12.02498pt too wide) in paragraph at lines 701--703 +[12] +Overfull \hbox (12.02498pt too wide) in paragraph at lines 950--952 []\TU/NotoSerif(0)/m/n/12 Symlink your ~/Documents/Lib/Citations.bib to basic-b ook-builder/lib/zotero.bib [] -Overfull \hbox (107.64897pt too wide) in paragraph at lines 711--712 +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 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 oliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb[] [] -[8] [9] -Underfull \hbox (badness 10000) in alignment at lines 767--775 +[13] +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| [] -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 -] [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) @@ -1857,12 +1887,12 @@ LaTeX Warning: There were multiply-defined labels. ) Here is how much of TeX's memory you used: - 36087 strings out of 478775 - 746049 string characters out of 5850945 + 36441 strings out of 478775 + 750960 string characters out of 5850945 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 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). diff --git a/build/latex/basic-book-builder.pdf b/build/latex/basic-book-builder.pdf index ff93834..fc5f114 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 aee226e..019b1d8 100644 --- a/build/latex/basic-book-builder.tex +++ b/build/latex/basic-book-builder.tex @@ -108,6 +108,7 @@ \usepackage[most]{tcolorbox} \usepackage{graphicx} \usepackage{xparse} +\usepackage{titlesec} \tcbuselibrary{breakable} % --- Disable floating figures globally --- @@ -140,6 +141,22 @@ % Helper to show a blank title if empty \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 % ========================================================= @@ -257,7 +274,7 @@ \fancypagestyle{plain}{% \fancyhf{}% \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 \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} @@ -271,7 +288,7 @@ \fancyhead[C]{\leftmark} % Chapter title (centered) % 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 % Line rules @@ -304,7 +321,7 @@ {\Huge\bfseries Basic Book Builder \par} \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} \includegraphics[width=0.5\textwidth]{lib/img/UAF-ACEP.png} @@ -321,7 +338,7 @@ {\Large\bfseries Basic Book Builder \par} \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} \renewcommand{\arraystretch}{1.3} % row spacing @@ -529,35 +546,267 @@ To build all supported formats make all \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] -Einsteins Relativistic Dynamics Equations -\[E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 \] -\end{establishedbox} +Metadata for the project is managed in \texttt{metadata.yaml}. Edit this +file to make global changes to variables for your document. Changes here +will propagate to all format builds. -\begin{proposedbox}[Proposed Concept] -With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \] -\end{proposedbox} +\section{Front-matter}\label{front-matter} -\begin{speculativebox}[Speculative Concept] -With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \] -\end{speculativebox} +Front matter content is manged in: -\begin{cautionbox}[Caution Note] -Beware of this section. +\begin{itemize} +\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} +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] -Beware of this section. +Same as the Caution Box \end{warningbox} -\begin{dangerbox}[Alerts] -Extreme Highlight +\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center} + +\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} +\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 A @@ -758,7 +1007,7 @@ sudo apt install calibre \backmatter -\chapter*{Glossary}\label{glossary} +\chapter*{Glossary}\label{glossary-1} \addcontentsline{toc}{chapter}{Glossary} {\def\LTcaptype{none} % do not increment counter @@ -850,7 +1099,7 @@ for citation processing with Pandoc. \\ \thispagestyle{plain} \markboth{Bibliography}{Bibliography} -\chapter*{Bibliography}\label{bibliography} +\chapter*{Bibliography}\label{bibliography-1} \addcontentsline{toc}{chapter}{Bibliography} \protect\phantomsection\label{refs} diff --git a/build/latex/basic-book-builder.toc b/build/latex/basic-book-builder.toc index 7f3af36..492788c 100644 --- a/build/latex/basic-book-builder.toc +++ b/build/latex/basic-book-builder.toc @@ -2,7 +2,7 @@ \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.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 {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}% \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.3}DocX}{4}{subsection.3.2.3}% \contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}% -\contentsline {subsection}{\numberline {3.2.5}Make All}{5}{subsection.3.2.5}% -\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}% -\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}% -\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}% -\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}% -\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}% -\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}% -\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}% -\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}% -\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}% -\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}% -\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}% -\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}% -\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}% -\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}% -\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}% -\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}% -\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}% -\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}% -\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}% -\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}% -\contentsline {chapter}{Glossary}{10}{appendix*.4}% -\contentsline {chapter}{Index}{12}{appendix*.5}% -\contentsline {chapter}{Bibliography}{14}{appendix*.6}% +\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}% diff --git a/build/odt/basic-book-builder.odt b/build/odt/basic-book-builder.odt index ba734f7..07194e2 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 ff93834..fc5f114 100644 Binary files a/build/pdf/basic-book-builder.pdf and b/build/pdf/basic-book-builder.pdf differ diff --git a/chapters/02_Usage.md b/chapters/02_Usage.md index 14184f1..c3a49fd 100644 --- a/chapters/02_Usage.md +++ b/chapters/02_Usage.md @@ -1,8 +1,34 @@ # 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 +``` + +- should be outside of the **basic-book-builder** directory + +``` +cd +``` + +Update: + +1. `metadata.yaml` +2. `templates/pandoc.yaml` + + ## Editing Content +Edit your source content Markdown under the `chapters` directory. +**Optional** + +- Open your `` directory as an Obsidian vault. +- Edit your Markdown with Obsidian ## Building diff --git a/chapters/03_Features.md b/chapters/03_Features.md index b5e014b..cfa4fe0 100644 --- a/chapters/03_Features.md +++ b/chapters/03_Features.md @@ -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 -> Einsteins Relativistic Dynamics Equations -> $$E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 $$ +> [!caution] Tip +> You'll need to modify the HTML / LaTex. + +### 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 -With the speed of light, $c = 1$: -$$E^2 = m_{0}^2 + p^2 $$ +Edit the **Front-matter** files to modify un-comment the Book Dedication. +- This is disabled by default +## Table of Contents -> [!speculative] Speculative Concept -With the speed of light, $c = 1$: -$$E^2 = m_{0}^2 + p^2 $$ +## Chapters +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 -> 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 -> 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 diff --git a/chapters/04_Design.md b/chapters/04_Design.md index 4f8447d..ad8c5a4 100644 --- a/chapters/04_Design.md +++ b/chapters/04_Design.md @@ -2,11 +2,136 @@ ## 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 +``` +../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 +TBD \ No newline at end of file diff --git a/lib/citations/wolframWhatConsciousnessNew2021.md b/lib/citations/wolframWhatConsciousnessNew2021.md deleted file mode 100644 index e69de29..0000000 diff --git a/metadata.yaml b/metadata.yaml index 1dfb65f..249683c 100644 --- a/metadata.yaml +++ b/metadata.yaml @@ -1,6 +1,6 @@ # Title 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" logo: "lib/img/UAF-ACEP.png" diff --git a/scripts/new-project.sh b/scripts/new-project.sh index 9e5f8ec..d68b7e1 100644 --- a/scripts/new-project.sh +++ b/scripts/new-project.sh @@ -8,7 +8,16 @@ if [ "$#" -ne 1 ]; then exit 1 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 PROJECT_DIR="$1" mkdir -p "$PROJECT_DIR" +echo "$SCRIPT_DIR" +echo "$B3_DIR" + +# Copy B3 template to project directory +#rsync -av --exclude ".git" "$B3_DIR/" "$PROJECT_DIR" diff --git a/templates/header.tex b/templates/header.tex index 82fbfb1..4f79da7 100644 --- a/templates/header.tex +++ b/templates/header.tex @@ -2,6 +2,7 @@ \usepackage[most]{tcolorbox} \usepackage{graphicx} \usepackage{xparse} +\usepackage{titlesec} \tcbuselibrary{breakable} % --- Disable floating figures globally --- @@ -34,6 +35,22 @@ % Helper to show a blank title if empty \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 % =========================================================