diff --git a/conf/epub.yaml b/conf/epub.yaml deleted file mode 100644 index e0a57a3..0000000 --- a/conf/epub.yaml +++ /dev/null @@ -1,24 +0,0 @@ -from: markdown -to: epub -output-file: build/basic-book-builder.epub - -metadata: - title: "Basic Book Builder" - author: "John Haverlack" - date: "2026-02-04" - rights: "© 2026 Alaska Center for Energy and Power" - -epub-cover-image: lib/img/UAF-ACEP.png - -include-before-body: - - conf/frontmatter_epub.xhtml - -resource-path: - - . - - lib/img - -css: - - conf/style_epub.css - -filters: - - filters/callouts-html.lua diff --git a/conf/epub_template.html b/conf/epub_template.html deleted file mode 100644 index 36d66c2..0000000 --- a/conf/epub_template.html +++ /dev/null @@ -1 +0,0 @@ -$body$ diff --git a/conf/frontmatter-md.html b/conf/frontmatter-md.html deleted file mode 100644 index 0a0914d..0000000 --- a/conf/frontmatter-md.html +++ /dev/null @@ -1,40 +0,0 @@ -
- - -

Basic Book Builder

-

A Pandoc Template for building books and articles

- -
- Cover illustration -
- -
- - - -
- - - - - - - - - - - - - - - - -
TitleBasic Book Builder
SubtitleA Pandoc Template for building books and articles
AffiliationAlaska Center for Energy and Power
InstitutionUniversity of Alaska Fairbanks
AuthorJohn Haverlack
Version0.0.6
Date2025-12-07
ISBN:UNSPECIFIED
DOI:UNSPECIFIED
StatePRE-DRAFT
-
- - -
- -
- diff --git a/conf/frontmatter.html b/conf/frontmatter.html deleted file mode 100644 index ab7e321..0000000 --- a/conf/frontmatter.html +++ /dev/null @@ -1,75 +0,0 @@ -
- - -

Basic Book Builder

-

A Pandoc template for building books and articles

- -
- Cover illustration -
- -
- - - -
- -

Basic Book Builder

- A Pandoc template for building books and articles - - - - - - - - - - -
AuthorJohn Haverlack
Version1.1.0
Date2026-02-04
ISBN:UNSPECIFIED
DOI:UNSPECIFIED
MaturityBETA
- -

Copyright © 2026 Alaska Center for Energy and Power

- -

Licensing

- -

Open Source Edition (PDF and HTML)

-

Licensed under the Creative Commons Attribution-NoDerivatives 4.0 International License -

-

- - - -
- -
- - - - -
- - - - - diff --git a/conf/frontmatter.tex b/conf/frontmatter.tex deleted file mode 100644 index b95e850..0000000 --- a/conf/frontmatter.tex +++ /dev/null @@ -1,106 +0,0 @@ -% ------------------------- -% 1. Title Page -% ------------------------- -\begin{titlepage} -\centering - -\vspace*{2cm} - -{\Huge\bfseries Basic Book Builder \par} -\vspace{0.4cm} -{\Large A Pandoc template for building books and articles \par} - -\vspace{1.2cm} -\includegraphics[width=0.5\textwidth]{lib/img/UAF-ACEP.png} - -\vfill - -\end{titlepage} - -% ------------------------- -% 2. COPYRIGHT / META PAGE -% ------------------------- -\newpage -\thispagestyle{empty} - -{\Large\bfseries Basic Book Builder \par} -\vspace{0.2cm} -{\normalsize\textit{A Pandoc template for building books and articles}\par} -\vspace{0.4cm} - -\renewcommand{\arraystretch}{1.3} % row spacing -\setlength{\tabcolsep}{8pt} % column padding -\begin{tabular}{@{}p{0.28\textwidth}p{0.65\textwidth}@{}} -\textbf{Author:} & John Haverlack \\ -\textbf{Version:} & 1.1.0 \\ -\textbf{Date:} & 2026-02-04 \\ -\textbf{ISBN:} & UNSPECIFIED \\ -\textbf{DOI:} & UNSPECIFIED \\ -\textbf{Maturity:} & BETA \\ -\end{tabular} - -\vspace{0.5cm} - -\textbf{Copyright} © 2026 Alaska Center for Energy and Power - -\vspace{0.5cm} - -% ----- Licensing Section ----- -\section*{Licensing} - -\subsection*{Open Source Edition (PDF and HTML)} -Licensed under the Creative Commons Attribution-NoDerivatives 4.0 International License. - -\begin{itemize} - \item License: \href{https://creativecommons.org/licenses/by-nd/4.0/}{CC BY-ND 4.0} -\end{itemize} - -% \subsection*{Commercial Edition (ebook and print)} -% All Rights Reserved. No part of the EPUB or printed editions may be reproduced or redistributed without permission. - -\vspace*{\fill} - -% ------------------------- -% 3. Cover Illustration Page -% ------------------------- -% ----- Title Page Image Note ----- -\newpage -\thispagestyle{empty} - -% \vspace*{1.5cm} - -% {\Large\bfseries Cover Illustration\par} - -% \begin{center} -% \includegraphics[width=0.33\textwidth]{lib/img/UAF-ACEP.png} - -% \vspace{0.6cm} - - -% \vspace{0.8cm} - -% {\small -% \textit{“Cover illustration by****”} -% \end{center} - - -% ------------------------- -% Reset numbering -% ------------------------- -\clearpage -\pagenumbering{roman} - -% ------------------------- -% Insert dedication -% ------------------------- - -% \begin{titlepage} -% \centering -% \vspace*{\fill} - -% \textit{This book is dedicated to ****.} - -% \vspace*{\fill} -% \end{titlepage} - -% (Pandoc will insert the TOC next, using roman numerals) \ No newline at end of file diff --git a/conf/header.tex b/conf/header.tex deleted file mode 100644 index 2687d18..0000000 --- a/conf/header.tex +++ /dev/null @@ -1,144 +0,0 @@ -\usepackage{etoolbox} -\usepackage[most]{tcolorbox} -\usepackage{graphicx} -\usepackage{xparse} -\tcbuselibrary{breakable} - -% --- Disable floating figures globally --- -\usepackage{float} -\let\origfigure\figure -\let\endorigfigure\endfigure -\renewenvironment{figure}[1][H]{\origfigure[H]}{\endorigfigure} - -% --- Colors --- -\usepackage{xcolor} -\definecolor{speculativeback}{RGB}{247,232,255} % #f7e8ff -\definecolor{speculativeframe}{RGB}{139,43,226} % #8b2be2 - -% --- Left-align all Pandoc tables --- -\usepackage{longtable} -\usepackage{etoolbox} -\makeatletter -\patchcmd\longtable{\par}{\par\raggedright}{}{} -\setlength{\LTleft}{0pt} -\setlength{\LTright}{0pt} -\makeatother - -% Enable index generation -\usepackage{makeidx} -\makeindex - - -% Helper to show a blank title if empty -\newcommand{\blanktitle}{\mbox{}} - -% ========================================================= -% Concept Boxes -% ========================================================= -\newtcolorbox{infobox}[1][Information]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=blue!3!white, - colframe=blue!50!black, - colbacktitle=blue!10!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\newtcolorbox{proposedbox}[1][Proposed Concept]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=blue!5!white, - colframe=blue!75!black, - colbacktitle=blue!15!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\newtcolorbox{establishedbox}[1][Established Concept]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=green!5!white, - colframe=green!75!black, - colbacktitle=green!15!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\newtcolorbox{speculativebox}[1][Speculative Concept]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=speculativeback, - colframe=speculativeframe, - colbacktitle=speculativeback!80!white, % lighter variant for title bar - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - - -\newtcolorbox{cautionbox}[1][Caution]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=orange!5!white, - colframe=orange!75!black, - colbacktitle=orange!15!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\newtcolorbox{warningbox}[1][Warning]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=orange!5!white, - colframe=orange!75!black, - colbacktitle=orange!15!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\newtcolorbox{dangerbox}[1][Danger]{% - title=\ifstrempty{#1}{\blanktitle}{#1}, - colback=red!5!white, - colframe=red!75!black, - colbacktitle=red!15!white, - fonttitle=\bfseries, - coltitle=black, - enhanced, sharp corners, breakable, - after=\par\vspace{6pt} -} - -\usepackage{xurl} - -\usepackage{fancyhdr} -\setlength{\headheight}{15pt} - -% --- Chapter-opening pages (plain style) --- -\fancypagestyle{plain}{% - \fancyhf{}% - \fancyhead[C]{\leftmark} % Chapter title - \cfoot{Basic Book Builder: A Pandoc template for building books and articles} % Book title - \rfoot{\thepage} % Page number - \renewcommand{\headrulewidth}{0pt} - \renewcommand{\footrulewidth}{0pt} -} - -% --- Normal running pages --- -\pagestyle{fancy} -\fancyhf{} - -% Header -\fancyhead[C]{\leftmark} % Chapter title (centered) - -% Footer -\cfoot{Basic Book Builder: A Pandoc template for building books and articles} % Book title -\rfoot{\thepage} % Page number - -% Line rules -\renewcommand{\headrulewidth}{0pt} % rule under header -\renewcommand{\footrulewidth}{0pt} % no rule above footer diff --git a/conf/html.yaml b/conf/html.yaml deleted file mode 100644 index c7a9856..0000000 --- a/conf/html.yaml +++ /dev/null @@ -1,26 +0,0 @@ -# conf/html.yaml -from: markdown -to: html5 -standalone: true -output-file: build/basic-book-builder.html - -include-before-body: - - conf/frontmatter.html - -metadata: - title: "Basic Book Builder" - title-block: false - -# This enables EPUB TOC -toc: true -toc-depth: 3 - -css: - - conf/style.css - -resource-path: - - . - - lib/img - -filters: - - filters/callouts-html.lua diff --git a/conf/latex.yaml b/conf/latex.yaml deleted file mode 100644 index 172a3de..0000000 --- a/conf/latex.yaml +++ /dev/null @@ -1,48 +0,0 @@ -from: markdown+yaml_metadata_block+raw_tex -to: latex -standalone: true - -# Name of the intermediate .tex file is controlled externally -# (Makefile passes -o build/basic-book-builder.tex) - -include-in-header: - - conf/header.tex - -include-before-body: - - conf/frontmatter.tex - -filters: - - filters/callouts.lua - -metadata: - # PDF engine used during XeLaTeX compilation - pdf-engine: xelatex - bookmarks: false - -variables: - documentclass: book - classoption: - - openany - fontsize: 12pt - geometry: - - margin=1in - - toc: true - toc-depth: 3 - toc-title: "Contents" - - numbersections: true - - # used by your header template - graphics: true - colorlinks: true - linkcolor: blue - float: false - figure-latex-placement: H - -resource-path: - - . - - lib/img - - lib/diag - -citeproc: true diff --git a/conf/markdown.yaml b/conf/markdown.yaml deleted file mode 100644 index 1018dbd..0000000 --- a/conf/markdown.yaml +++ /dev/null @@ -1,23 +0,0 @@ -# conf/markdown.yaml -from: markdown -to: gfm -standalone: true -output-file: build/basic-book-builder.md - -include-before-body: - - conf/frontmatter-md.html # HTML frontmatter works fine here - -metadata: - title: "Clear Skies - A Reference Architecture for Resilient Alaskan Microgrid Cyberinfrastructure" - title-block: false - -toc: true -toc-depth: 3 - -resource-path: - - . - - lib/img - - lib/diag - -filters: - - filters/callouts-html.lua diff --git a/conf/metadata.yaml b/conf/metadata.yaml deleted file mode 100644 index 4be088c..0000000 --- a/conf/metadata.yaml +++ /dev/null @@ -1,44 +0,0 @@ -# Title -title: "Basic Book Builder" -subtitle: "A Pandoc template for building books and articles" -name: "basic-book-builder" -logo: "lib/img/UAF-ACEP.png" - -# Version / Repo -version: "1.1.0" -date: "2026-02-04" -state: "BETA" -source: "https://github.com/jehaverlack/basic-book-builder" - -# Identifiers -doi: "UNSPECIFIED" -isbn-pdf: "UNSPECIFIED" -isbn-epub: "UNSPECIFIED" -isbn-kindle: "UNSPECIFIED" -isbn-paperback: "UNSPECIFIED" -isbn-hardcover: "UNSPECIFIED" -isbn-audiobook: "UNSPECIFIED" - -# Publisher and Author -publisher: "University of Alaska Fairbanks" - -author: "John Haverlack" -author-email: "jehaverlack@alaska.edu" -affiliation: "Alaska Center for Energy and Power" -institution: "University of Alaska Fairbanks" - -# Copyright -copyright: "© 2026 Alaska Center for Energy and Power" - -# License -license: "CC BY-ND 4.0" -license-name: "Creative Commons Attribution-NoDerivatives 4.0 International License" -# Open Source License -license-os: "CC BY-ND 4.0" -license-os-text: "Creative Commons Attribution-NoDerivatives 4.0 International License" -license-os-url: "https://creativecommons.org/licenses/by-nd/4.0/" -# Commercial License -license-com: "All Rights Reserved." -license-com-text: "No part of the EPUB or printed editions may be reproduced or redistributed without permission." - - diff --git a/conf/pandoc.yaml b/conf/pandoc.yaml deleted file mode 100644 index 1e9ce96..0000000 --- a/conf/pandoc.yaml +++ /dev/null @@ -1,53 +0,0 @@ -# pandoc.yaml -input-files: - - chapters/Preface.md - - chapters/00_Introduction.md - - chapters/01_Getting_Started.md - # - chapters/02_Features.md - # - chapters/Terminology.md - # - chapters/Citations.md - - chapters/Appendix.md - - chapters/AppendixA.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 - 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.bib - - diff --git a/conf/pdf.yaml b/conf/pdf.yaml deleted file mode 100644 index 8d66771..0000000 --- a/conf/pdf.yaml +++ /dev/null @@ -1,13 +0,0 @@ -# pdf.yaml -to: pdf -pdf-engine: xelatex -output-file: build/basic-book-builder.pdf - -include-before-body: - - conf/frontmatter.tex - -include-in-header: - - conf/header.tex - -filters: - - filters/callouts.lua \ No newline at end of file diff --git a/conf/style.css b/conf/style.css deleted file mode 100644 index fee5730..0000000 --- a/conf/style.css +++ /dev/null @@ -1,251 +0,0 @@ -/* ------------------------------ - Base book typography - ------------------------------ */ - -body { - font-family: "Libertinus Serif", Georgia, serif; - max-width: 42em; - margin: auto; - padding: 3rem 1.25rem; - line-height: 1.65; - background: #fff; - color: #111; -} - -/* ------------------------------ - Headings - ------------------------------ */ - -h1, h2, h3, h4 { - font-family: "Libertinus Sans", sans-serif; - font-weight: 600; -} - -h1 { - font-size: 2.1rem; -} - -h1.titlepage { - border-bottom: 2px solid #ddd; - padding-bottom: 0.4rem; - margin-top: 2em; - margin-bottom: 0.6em; -} - -h1.title { - display: none; -} - -h2 { - font-size: 1.6rem; -} - -h3 { - font-size: 1.25rem; -} - -/* ------------------------------ - Front matter page - ------------------------------ */ - -.frontmatter { - text-align: center; - margin-top: 10vh; -} - -.frontmatter img { - max-width: 30%; - margin: 2rem auto; - display: block; -} - -/* ------------------------------ - Lists / paragraphs - ------------------------------ */ - -p { - margin: 1em 0; -} - -ul, ol { - padding-left: 1.5em; - margin: 1em 0; -} - -/* ------------------------------ - Math block spacing - ------------------------------ */ - -.math.display { - margin: 1.2em 0; -} - -/* ------------------------------ - Callouts (final tuned spacing) - ------------------------------ */ - -.callout-established, -.callout-proposed, -.callout-speculative, -.callout-caution, -.callout-warning, -.callout-danger { - border-radius: 6px; - padding: 5px; /* internal padding */ - margin-top: 5px; /* external spacing tightened */ - margin-bottom: 5px; - border-left: 6px solid; - background: #fefefe; -} - -/* Title line */ -.callout-established p:first-child strong, -.callout-proposed p:first-child strong, -.callout-speculative p:first-child strong, -.callout-caution p:first-child strong, -.callout-warning p:first-child strong, -.callout-danger p:first-child strong { - display: block; - font-family: "Libertinus Sans", sans-serif; - font-weight: 600; - font-size: 1.05rem; - margin-bottom: 5px; -} - -/* Paragraphs inside callouts */ -.callout-established p, -.callout-proposed p, -.callout-speculative p, -.callout-caution p, -.callout-warning p, -.callout-danger p { - margin-top: 5px; - margin-bottom: 5px; - line-height: 1.45; /* slightly condensed text spacing */ -} - -/* Remove top margin on first paragraph, bottom on last */ -.callout-established p:first-child, -.callout-proposed p:first-child, -.callout-speculative p:first-child, -.callout-caution p:first-child, -.callout-warning p:first-child, -.callout-danger p:first-child { - margin-top: 0; -} -.callout-established p:last-child, -.callout-proposed p:last-child, -.callout-speculative p:last-child, -.callout-caution p:last-child, -.callout-warning p:last-child, -.callout-danger p:last-child { - margin-bottom: 0; -} - -/* Math inside callouts */ -.callout-established .math.display, -.callout-proposed .math.display, -.callout-speculative .math.display, -.callout-caution .math.display, -.callout-warning .math.display, -.callout-danger .math.display { - margin: 0.4em 0; -} - -/* Colors */ -.callout-established { - background: #e8f7e8; - border-left-color: #3a8d3a; -} -.callout-proposed { - background: #e8f0ff; - border-left-color: #3b6dd8; -} -.callout-speculative { - background: #f7e8ff; - border-left-color: #8b2be2; -} - -.callout-caution { - background: #fff0e8; - border-left-color: #f5a22f; -} - -.callout-warning { - background: #fff0e8; - border-left-color: #f5a22f; -} - -.callout-danger { - background: #ffe8e8; - border-left-color: #d83b3a; -} - -/* ------------------------------ - Images (in body content) - ------------------------------ */ - -img { - max-width: 100%; - display: block; - margin: 1.2em auto; -} - -/* ------------------------------ - Blockquotes (normal ones) - ------------------------------ */ - -blockquote { - border-left: 4px solid #ccc; - padding-left: 1em; - font-style: italic; - color: #444; -} - -/* ------------------------------ - Horizontal rule - ------------------------------ */ - -hr { - margin: 3rem 0; - border: none; - border-top: 1px solid #ddd; -} - -/* ------------------------------ - Code (rare in your book) - ------------------------------ */ - -code { - background: #f3f3f3; - padding: 0.1em 0.3em; - border-radius: 4px; - font-size: 0.95em; -} - -/* Force all header cells to left-align their text */ -table thead th { - text-align: left !important; - vertical-align: bottom; /* optional: aligns nicely with text baseline */ - padding: 4px 8px; /* optional: consistent spacing */ -} - -/* Make data cells match if you want consistent left alignment */ -table tbody td { - text-align: left; - padding: 4px 8px; -} - -/* Optional: keep math inline nicely aligned */ -table td .math, -table th .math { - display: inline-block; - vertical-align: baseline; -} - -/* Optional: make math display nicely aligned */ -table td .math.display, -table th .math.display { - display: block; - margin: 0.4em 0; -} diff --git a/conf/style_epub.css b/conf/style_epub.css deleted file mode 100644 index c511547..0000000 --- a/conf/style_epub.css +++ /dev/null @@ -1,75 +0,0 @@ -/* Safer defaults for varied EPUB engines (Kindle, iBooks, KOReader, etc.) */ - -html, body { - margin: 0; - padding: 0.8em; - line-height: 1.55; - widows: 2; - orphans: 2; -} - -/* Avoid fonts that may not exist on the device */ -body { - font-family: serif; - color: #111; -} - -/* Headings */ -h1, h2, h3 { - font-family: serif; - font-weight: 700; - margin: 1.2em 0 0.5em 0; -} - -h1 { font-size: 1.6em; } -h2 { font-size: 1.3em; } -h3 { font-size: 1.1em; } - -/* Lists and paragraphs */ -p { margin: 0.7em 0; } -ul, ol { margin: 0.7em 0 0.7em 1.2em; } - -/* Images */ -img { max-width: 100%; height: auto; } - -/* Page breaks for supported readers */ -section[epub|type="titlepage"] { - break-after: page; - page-break-after: always; /* fallback */ -} -section#pubmeta { - break-after: page; - page-break-after: always; -} - -/* Callouts (match HTML look, keep it minimal for EPUB) */ -.callout-established, -.callout-proposed, -.callout-speculative { - padding: 0.6em; - margin: 0.7em 0; - border-left: 0.35em solid; - background: #fefefe; -} - -.callout-established { border-color: #3a8d3a; background: #e8f7e8; } -.callout-proposed { border-color: #3b6dd8; background: #e8f0ff; } -.callout-speculative { border-color: #8b2be2; background: #f7e8ff; } - -/* First bold line inside a callout = title */ -.callout-established p:first-child strong, -.callout-proposed p:first-child strong, -.callout-speculative p:first-child strong { - display: block; - margin-bottom: 0.3em; -} - -/* Math (MathML) spacing */ -.math.display { margin: 0.8em 0; } - -/* Blockquotes */ -blockquote { - border-left: 0.25em solid #bbb; - padding-left: 0.8em; - color: #444; -}