diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 4a75095..fe1b489 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -270,29 +270,32 @@ }, "active": "01161538f53367e8", "lastOpenFiles": [ - "conf/sedO6HWQd", - "conf/sedLQxQGf", - "conf/sedIsN7C4", - "conf/sed8HHrHm", - "conf/sed0agSpY", - "conf/sed9gY2gw", - "conf/seddo6XG6", - "conf/sedyheY4U", - "conf/seduL1p1z", - "conf/sedltGqhZ", - "conf/sedv2m0sa", - "chapters/01_Getting_Started.md", - "templates/frontmatter-docx.md", - "chapters/00_Introduction.md", - "chapters/AppendixB.md", - "chapters/03_Features.md", + "conf/sedBapyXA", + "conf/sedYZ2rBJ", + "conf/sedbEPwZC", "chapters/02_Usage.md", + "chapters/01_Getting_Started.md", + "chapters/04_Design.md", + "README.md", + "chapters/00_Introduction.md", + "chapters/04_Design", + "conf/odt.yaml", + "conf/frontmatter-docx.md", + "conf/docx.yaml", + "chapters/03_Features.md", + "conf/sedMSkcEz", + "conf/sedsOEcAe", + "conf/sedwM39Vv", + "conf/sedqNCjeN", + "conf/sedKOEUG1", + "chapters/AppendixA.md", + "templates/frontmatter-docx.md", + "chapters/AppendixB.md", "chapters/02_Features.md", "chapters/Preface.md", "chapters/Index.md", "chapters/Glossary.md", "chapters/Bibliography.md", - "chapters/AppendixA.md", "chapters/Appendix.md", "lib/img/unit-circle-with-tau.png", "lib/img/unit-circle-with-pi.png.png", @@ -307,14 +310,11 @@ "chapters/Terminology.md", "chapters/Citations.md", "chapters/Appendix B.md", - "conf/frontmatter-docx.md", "build/md/basic-book-builder.md", "build/basic-book-builder.md", "LICENSE.md", - "README.md", "pm/Book Action Items.md", "chapters/Unitfication.md", - "chapters/03_Cylindrical_Spacetime.md", - "chapters/07_Consciousness_Continued.md" + "chapters/03_Cylindrical_Spacetime.md" ] } \ No newline at end of file diff --git a/build/docx/basic-book-builder.docx b/build/docx/basic-book-builder.docx new file mode 100644 index 0000000..4dbf611 Binary files /dev/null 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 57667c0..0c86e42 100644 --- a/build/html/basic-book-builder.html +++ b/build/html/basic-book-builder.html @@ -24,71 +24,6 @@ vertical-align: middle; } .display.math{display: block; text-align: center; margin: 0.5rem auto;} - /* CSS for syntax highlighting */ - html { -webkit-text-size-adjust: 100%; } - pre > code.sourceCode { white-space: pre; position: relative; } - pre > code.sourceCode > span { display: inline-block; line-height: 1.25; } - pre > code.sourceCode > span:empty { height: 1.2em; } - .sourceCode { overflow: visible; } - code.sourceCode > span { color: inherit; text-decoration: inherit; } - div.sourceCode { margin: 1em 0; } - pre.sourceCode { margin: 0; } - @media screen { - div.sourceCode { overflow: auto; } - } - @media print { - pre > code.sourceCode { white-space: pre-wrap; } - pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; } - } - pre.numberSource code - { counter-reset: source-line 0; } - pre.numberSource code > span - { position: relative; left: -4em; counter-increment: source-line; } - pre.numberSource code > span > a:first-child::before - { content: counter(source-line); - position: relative; left: -1em; text-align: right; vertical-align: baseline; - border: none; display: inline-block; - -webkit-touch-callout: none; -webkit-user-select: none; - -khtml-user-select: none; -moz-user-select: none; - -ms-user-select: none; user-select: none; - padding: 0 4px; width: 4em; - color: #aaaaaa; - } - pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; } - div.sourceCode - { } - @media screen { - pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; } - } - code span.al { color: #ff0000; font-weight: bold; } /* Alert */ - code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */ - code span.at { color: #7d9029; } /* Attribute */ - code span.bn { color: #40a070; } /* BaseN */ - code span.bu { color: #008000; } /* BuiltIn */ - code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */ - code span.ch { color: #4070a0; } /* Char */ - code span.cn { color: #880000; } /* Constant */ - code span.co { color: #60a0b0; font-style: italic; } /* Comment */ - code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */ - code span.do { color: #ba2121; font-style: italic; } /* Documentation */ - code span.dt { color: #902000; } /* DataType */ - code span.dv { color: #40a070; } /* DecVal */ - code span.er { color: #ff0000; font-weight: bold; } /* Error */ - code span.ex { } /* Extension */ - code span.fl { color: #40a070; } /* Float */ - code span.fu { color: #06287e; } /* Function */ - code span.im { color: #008000; font-weight: bold; } /* Import */ - code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */ - code span.kw { color: #007020; font-weight: bold; } /* Keyword */ - code span.op { color: #666666; } /* Operator */ - code span.ot { color: #007020; } /* Other */ - code span.pp { color: #bc7a00; } /* Preprocessor */ - code span.sc { color: #4070a0; } /* SpecialChar */ - code span.ss { color: #bb6688; } /* SpecialString */ - code span.st { color: #4070a0; } /* String */ - code span.va { color: #19177c; } /* Variable */ - code span.vs { color: #4070a0; } /* VerbatimString */ - code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */ /* CSS for citations */ div.csl-bib-body { } div.csl-entry { @@ -205,6 +140,41 @@ Builder
  • Setting Up Build Environment
  • +
  • Testing
  • +
  • Creating a New Project +
  • + +
  • Usage +
  • +
  • Appendix A: Build +Environment Notes +
  • Glossary
  • Bibliography
  • @@ -230,9 +200,8 @@ href="#ref-JohnHaverlackACEP" role="doc-biblioref">John

    Cloning the Basic Book Builder

    -

    Cloning the repository

    -
    git clone https://github.com/jehaverlack/basic-book-builder.git
    +

    Clone the repository

    +
    git clone https://github.com/jehaverlack/basic-book-builder.git

    Navigate to the repo directory

    @@ -240,17 +209,194 @@ class="sourceCode bash">Setting Up Build Environment
    -

    Debian Based Linux

    -

    This script only support Debian based linux system (Debian, Ubunutu, +

    ~Debian Linux

    +

    This script only support Debian based Linux system (Debian, Ubunutu, Zorin, etc) This script has not been widely tested across platforms

    Setup Build Environment

    -
    ./scripts/setup-linux-deb.sh
    +
    ./scripts/setup-linux-deb.sh

    For more information on setting up the build environment for your system see Appendix A.

    +

    Testing

    +

    If you can build all format for the Basic Book Build +then you have a working build environment.

    +
    +

    Testing Build Environment

    +
    make all
    +
    +

    Creating a New Project

    +

    Zotero Configuration +(Optional)

    +

    Usage

    +

    Editing Content

    +

    Building

    +

    PDF

    +
    make pdf
    +
    +

    NOTE: Building the PDF also builds the LaTeX version +of the book.

    +
    +

    HTML

    +
    make html
    +

    DocX

    +
    make docx
    +
    +

    NOTE: DocX is a work in progress. Frontmatter and formatting need +work.

    +
    +

    ODT

    +
    make odt
    +
    +

    NOTE: ODT is a work in progress. Frontmatter and formatting need +work.

    +
    +

    Make All

    +

    To build all supported formats

    +
    make all
    +

    Callouts

    +

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

    +
    +

    Established Concept

    +

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

    +
    +
    +

    Proposed Concept

    +

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

    +
    +
    +

    Speculative Concept

    +

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

    +
    +
    +

    Caution Note

    +

    Beware of this section.

    +
    +
    +

    Warning Note

    +

    Beware of this section.

    +
    +
    +

    Alerts

    +

    Extreme Highlight

    +
    +

    Appendix A

    +

    Appendix A: Build +Environment Notes

    +

    Installing Pre-Requisites

    +
    +

    Not Cross-platform Tested

    +

    For Debian / ZorinOS and likely Ubuntu based systems.

    +
    +

    Required

    +

    Pandoc

    + +
    +

    sudo apt install https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb

    +
    +

    Code Editor

    +
    +

    Code Editor

    +

    VSCodium is recommend for +privacy (telemetry/tracking) reasons - https://vscodium.com/

    +
    +

    But any text editor will work. #### make

    +
    sudo apt install make
    +

    jq and yq

    +
    sudo apt install jq yq
    +

    texlive

    +
    +

    sudo apt install texlive texlive-xetex texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra

    +
    +

    MathJax

    +
      +
    • https://www.mathjax.org/
    • +
    +
    wget https://registry.npmjs.org/mathjax/-/mathjax-3.2.2.tgz
    +tar xzf mathjax-3.2.2.tgz
    +mv package/es5/* lib/mathjax
    +rm -rf package mathjax-3.2.2.tgz
    +
    +

    TODO

    +

    This need to be rolled into a setup script.

    +
    +

    Optional

    +

    The following are not strictly requires to use this book builder +template.

    +

    Obsidian

    +
    +

    Highly Recommended

    +

    Editing book chapter content in Obsidian is a very productive means +for editing Markdown source content.

    +
    + +
    sudo apt install https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb
    +

    Zotero

    +
    +

    Highly Recommended

    +

    If you need to managed citations and references, Zotero integration +is highly recommended.

    +
    +
      +
    • https://www.zotero.org/
    • +
    +
    sudo cp ./scripts/deps/zotero.list /etc/apt/sources.list.d/
    +
    sudo apt update
    +
    sudo apt install zotero
    +
    Better BibTex for Zotero
    +

    Install the Better BibTex Plugin for Zotero - Zotero > Tool > +Plugins

    +
    Export citations.bib
    +
      +
    • Zotero > File > Export Library > Format: Better BibTeX
    • +
    • +
    • +
    • +
    +
    Zotero Connector Browser +Plugin
    +
      +
    • https://chromewebstore.google.com/detail/zotero-connector/ekhagklcjbdpajgpjgmbionohlpdbjgc
    • +
    +

    Provides you the ability to auto add Web resources to your Zotero +citation database.

    +

    lmodern

    +
    sudo apt install lmodern
    +

    epubcheck

    +
    sudo apt install epubcheck
    +

    foliate

    +

    An EPub Reader

    +
      +
    • https://johnfactotum.github.io/foliate/
    • +
    +
    sudo apt install https://github.com/johnfactotum/foliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb
    +

    calibre

    +

    An EPub Reader

    +
      +
    • https://calibre-ebook.com
    • +
    +
    sudo apt install calibre
    +

    Editing the Configuration

    +

    Glossary

    diff --git a/build/latex/basic-book-builder.aux b/build/latex/basic-book-builder.aux index 29df7dc..5114bc7 100644 --- a/build/latex/basic-book-builder.aux +++ b/build/latex/basic-book-builder.aux @@ -30,19 +30,85 @@ \newlabel{cloning-the-basic-book-builder}{{2.1}{2}{Cloning the Basic Book Builder}{section.2.1}{}} \@writefile{toc}{\contentsline {section}{\numberline {2.2}Setting Up Build Environment}{2}{section.2.2}\protected@file@percent } \newlabel{setting-up-build-environment}{{2.2}{2}{Setting Up Build Environment}{section.2.2}{}} +\@writefile{toc}{\contentsline {section}{\numberline {2.3}Testing}{3}{section.2.3}\protected@file@percent } +\newlabel{testing}{{2.3}{3}{Testing}{section.2.3}{}} +\@writefile{toc}{\contentsline {section}{\numberline {2.4}Creating a New Project}{3}{section.2.4}\protected@file@percent } +\newlabel{creating-a-new-project}{{2.4}{3}{Creating a New Project}{section.2.4}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {2.4.1}Zotero Configuration (Optional)}{3}{subsection.2.4.1}\protected@file@percent } +\newlabel{zotero-configuration-optional}{{2.4.1}{3}{Zotero Configuration (Optional)}{subsection.2.4.1}{}} +\@writefile{toc}{\contentsline {chapter}{\numberline {3}Usage}{4}{chapter.3}\protected@file@percent } +\@writefile{lof}{\addvspace {10\p@ }} +\@writefile{lot}{\addvspace {10\p@ }} +\newlabel{usage}{{3}{4}{Usage}{chapter.3}{}} +\@writefile{toc}{\contentsline {section}{\numberline {3.1}Editing Content}{4}{section.3.1}\protected@file@percent } +\newlabel{editing-content}{{3.1}{4}{Editing Content}{section.3.1}{}} +\@writefile{toc}{\contentsline {section}{\numberline {3.2}Building}{4}{section.3.2}\protected@file@percent } +\newlabel{building}{{3.2}{4}{Building}{section.3.2}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.1}PDF}{4}{subsection.3.2.1}\protected@file@percent } +\newlabel{pdf}{{3.2.1}{4}{PDF}{subsection.3.2.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.2}HTML}{4}{subsection.3.2.2}\protected@file@percent } +\newlabel{html}{{3.2.2}{4}{HTML}{subsection.3.2.2}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.3}DocX}{4}{subsection.3.2.3}\protected@file@percent } +\newlabel{docx}{{3.2.3}{4}{DocX}{subsection.3.2.3}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}\protected@file@percent } +\newlabel{odt}{{3.2.4}{4}{ODT}{subsection.3.2.4}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {3.2.5}Make All}{5}{subsection.3.2.5}\protected@file@percent } +\newlabel{make-all}{{3.2.5}{5}{Make All}{subsection.3.2.5}{}} +\@writefile{toc}{\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}\protected@file@percent } +\newlabel{callouts}{{3.3}{5}{Callouts}{section.3.3}{}} +\@writefile{toc}{\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}\protected@file@percent } +\@writefile{lof}{\addvspace {10\p@ }} +\@writefile{lot}{\addvspace {10\p@ }} +\newlabel{appendix-a-build-environment-notes}{{A}{6}{Appendix A: Build Environment Notes}{appendix.A}{}} +\@writefile{toc}{\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}\protected@file@percent } +\newlabel{installing-pre-requisites}{{A.1}{6}{Installing Pre-Requisites}{section.A.1}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}\protected@file@percent } +\newlabel{required}{{A.1.1}{6}{Required}{subsection.A.1.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}\protected@file@percent } +\newlabel{pandoc}{{A.1.1.1}{6}{Pandoc}{subsubsection.A.1.1.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}\protected@file@percent } +\newlabel{code-editor}{{A.1.1.2}{6}{Code Editor}{subsubsection.A.1.1.2}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}\protected@file@percent } +\newlabel{jq-and-yq}{{A.1.1.3}{7}{jq and yq}{subsubsection.A.1.1.3}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}\protected@file@percent } +\newlabel{texlive}{{A.1.1.4}{7}{texlive}{subsubsection.A.1.1.4}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}\protected@file@percent } +\newlabel{mathjax}{{A.1.1.5}{7}{MathJax}{subsubsection.A.1.1.5}{}} +\@writefile{toc}{\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}\protected@file@percent } +\newlabel{optional}{{A.1.2}{7}{Optional}{subsection.A.1.2}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}\protected@file@percent } +\newlabel{obsidian}{{A.1.2.1}{7}{Obsidian}{subsubsection.A.1.2.1}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}\protected@file@percent } +\newlabel{zotero}{{A.1.2.2}{8}{Zotero}{subsubsection.A.1.2.2}{}} +\newlabel{better-bibtex-for-zotero}{{A.1.2.2.1}{8}{Better BibTex for Zotero}{paragraph.A.1.2.2.1}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}\protected@file@percent } +\newlabel{export-citations.bib}{{A.1.2.2.2}{8}{Export citations.bib}{paragraph.A.1.2.2.2}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}\protected@file@percent } +\newlabel{zotero-connector-browser-plugin}{{A.1.2.2.3}{8}{Zotero Connector Browser Plugin}{paragraph.A.1.2.2.3}{}} +\@writefile{toc}{\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}\protected@file@percent } +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}\protected@file@percent } +\newlabel{lmodern}{{A.1.2.3}{8}{lmodern}{subsubsection.A.1.2.3}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}\protected@file@percent } +\newlabel{epubcheck}{{A.1.2.4}{8}{epubcheck}{subsubsection.A.1.2.4}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}\protected@file@percent } +\newlabel{foliate}{{A.1.2.5}{8}{foliate}{subsubsection.A.1.2.5}{}} +\@writefile{toc}{\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}\protected@file@percent } +\newlabel{calibre}{{A.1.2.6}{9}{calibre}{subsubsection.A.1.2.6}{}} +\@writefile{toc}{\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}\protected@file@percent } +\newlabel{editing-the-configuration}{{A.2}{9}{Editing the Configuration}{section.A.2}{}} \gdef \LT@i {\LT@entry {1}{86.68152pt}\LT@entry {1}{383.07349pt}} -\newlabel{glossary}{{2.2}{4}{Glossary}{chapter*.4}{}} -\@writefile{toc}{\contentsline {chapter}{Glossary}{4}{chapter*.4}\protected@file@percent } -\@writefile{toc}{\contentsline {chapter}{Index}{6}{chapter*.5}\protected@file@percent } +\newlabel{glossary}{{A.2}{10}{Glossary}{appendix*.4}{}} +\@writefile{toc}{\contentsline {chapter}{Glossary}{10}{appendix*.4}\protected@file@percent } +\@writefile{toc}{\contentsline {chapter}{Index}{12}{appendix*.5}\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}{{2.2}{8}{Bibliography}{chapter*.6}{}} -\@writefile{toc}{\contentsline {chapter}{Bibliography}{8}{chapter*.6}\protected@file@percent } -\newlabel{refs}{{2.2}{8}{Bibliography}{section*.7}{}} -\gdef \@abspage@last{13} +\newlabel{bibliography}{{A.2}{14}{Bibliography}{appendix*.6}{}} +\@writefile{toc}{\contentsline {chapter}{Bibliography}{14}{appendix*.6}\protected@file@percent } +\newlabel{refs}{{A.2}{14}{Bibliography}{section*.7}{}} +\gdef \@abspage@last{19} diff --git a/build/latex/basic-book-builder.log b/build/latex/basic-book-builder.log index eabab23..1639aaf 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 13:01 +This is XeTeX, Version 3.141592653-2.6-0.999994 (TeX Live 2022/Debian) (preloaded format=xelatex 2025.11.6) 5 FEB 2026 13:27 entering extended mode restricted \write18 enabled. file:line:error style messages enabled. @@ -1736,19 +1736,18 @@ LaTeX Font Info: Font shape `TU/NotoSerif(0)/m/n' will be LaTeX Font Info: Font shape `TU/NotoSerif(0)/b/n' will be (Font) scaled to size 14.4pt on input line 349. [2] -(./basic-book-builder.toc) +(./basic-book-builder.toc [1 + + +]) \tf@toc=\write5 \openout5 = `basic-book-builder.toc'. - [1 - - -] [2 - -] + [2] Chapter 1. [1 + ] Chapter 2. LaTeX Font Info: Font shape `TU/NotoSansMono(0)/m/n' will be @@ -1762,47 +1761,95 @@ k-builder.git[] [2 ] [3] -Underfull \hbox (badness 10000) in alignment at lines 479--487 +Chapter 3. +[4 + +] [5] +Appendix A. + +Overfull \hbox (295.84503pt too wide) in paragraph at lines 587--588 +[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/jgm/pandoc/rel +eases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb + [] + + +Underfull \hbox (badness 10000) in paragraph at lines 593--595 +[][][]\TU/NotoSerif(0)/m/n/12 VSCodium[][] is recommend for privacy (telemetry/ +tracking) reasons - + [] + +[6 + +] +Overfull \hbox (358.24503pt too wide) in paragraph at lines 656--656 +[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/obsidianmd/obs +idian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb[] + [] + + +Underfull \vbox (badness 1888) has occurred while \output is active [] + + [7] +Overfull \hbox (12.02498pt too wide) in paragraph at lines 701--703 +[]\TU/NotoSerif(0)/m/n/12 Symlink your ~/Documents/Lib/Citations.bib to basic-b +ook-builder/lib/zotero.bib + [] + + +Overfull \hbox (107.64897pt too wide) in paragraph at lines 711--712 +[]\TU/NotoSerif(0)/m/n/12 https://chromewebstore.google.com/detail/zotero-conne +ctor/ekhagklcjbdpajgpjgmbionohlpdbjgc + [] + + +Overfull \hbox (430.245pt too wide) in paragraph at lines 740--740 +[]\TU/NotoSansMono(0)/m/n/12 sudo apt install https://github.com/johnfactotum/f +oliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb[] + + [] + +[8] [9] +Underfull \hbox (badness 10000) in alignment at lines 767--775 [] [] [] -Underfull \hbox (badness 10000) in alignment at lines 487--489 +Underfull \hbox (badness 10000) in alignment at lines 775--777 [] [] [] -Overfull \hbox (1.68248pt too wide) in paragraph at lines 493--493 +Overfull \hbox (1.68248pt too wide) in paragraph at lines 781--781 []|\TU/NotoSerif(0)/b/n/12 Bibliography| [] -Underfull \hbox (badness 10000) in alignment at lines 489--541 +Underfull \hbox (badness 10000) in alignment at lines 777--829 [] [] [] -[4 +[10 -] [5] (./basic-book-builder.ind) [6 +] [11] (./basic-book-builder.ind) [12 -] [7 +] [13 ] -Underfull \hbox (badness 3977) in paragraph at lines 576--578 +Underfull \hbox (badness 3977) in paragraph at lines 864--866 []\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d. Https://www.uaf.edu/acep/about/our-team/john- [] -Underfull \hbox (badness 3977) in paragraph at lines 588--590 +Underfull \hbox (badness 3977) in paragraph at lines 876--878 []\TU/NotoSerif(0)/m/it/12 John Haverlack | ACEP\TU/NotoSerif(0)/m/n/12 . n.d. Https://www.uaf.edu/acep/about/our-team/john- [] -[8 +[14 -] [9 +] [15 ] (./basic-book-builder.aux) @@ -1810,12 +1857,12 @@ LaTeX Warning: There were multiply-defined labels. ) Here is how much of TeX's memory you used: - 36014 strings out of 478775 - 745203 string characters out of 5850945 - 1858991 words of memory out of 5000000 - 55441 multiletter control sequences out of 15000+600000 + 36087 strings out of 478775 + 746049 string characters out of 5850945 + 1859991 words of memory out of 5000000 + 55514 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,11n,122p,1015b,948s stack positions out of 10000i,1000n,20000p,200000b,200000s + 90i,12n,122p,1015b,954s stack positions out of 10000i,1000n,20000p,200000b,200000s -Output written on basic-book-builder.pdf (13 pages). +Output written on basic-book-builder.pdf (19 pages). diff --git a/build/latex/basic-book-builder.pdf b/build/latex/basic-book-builder.pdf index 2bc4a14..ff93834 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 91e4e11..aee226e 100644 --- a/build/latex/basic-book-builder.tex +++ b/build/latex/basic-book-builder.tex @@ -429,7 +429,7 @@ Haverlack.(\citeproc{ref-JohnHaverlackACEP}{\emph{John {Haverlack} \section{Cloning the Basic Book Builder}\label{cloning-the-basic-book-builder} -\begin{clibox}[Cloning the repository] +\begin{clibox}[Clone the repository] \begin{verbatim} git clone https://github.com/jehaverlack/basic-book-builder.git \end{verbatim} @@ -443,18 +443,11 @@ cd basic-book-builder \end{clibox} -\begin{codebox}[Code Example] -\begin{verbatim} -if then else -\end{verbatim} - -\end{codebox} - \section{Setting Up Build Environment}\label{setting-up-build-environment} -\begin{cautionbox}[Debian Based Linux] -This script only support Debian based linux system (Debian, Ubunutu, +\begin{cautionbox}[~Debian Linux] +This script only support Debian based Linux system (Debian, Ubunutu, Zorin, etc) This script has not been widely tested across platforms \end{cautionbox} @@ -468,6 +461,301 @@ Zorin, etc) This script has not been widely tested across platforms For more information on setting up the build environment for your system see Appendix A. +\section{Testing}\label{testing} + +If you can build all format for the \textbf{Basic Book Build} then you +have a working build environment. + +\begin{clibox}[Testing Build Environment] +\begin{verbatim} +make all +\end{verbatim} + +\end{clibox} + +\section{Creating a New Project}\label{creating-a-new-project} + +\subsection{Zotero Configuration +(Optional)}\label{zotero-configuration-optional} + +\chapter{Usage}\label{usage} + +\section{Editing Content}\label{editing-content} + +\section{Building}\label{building} + +\subsection{PDF}\label{pdf} + +\begin{verbatim} +make pdf +\end{verbatim} + +\begin{quote} +NOTE: Building the PDF also builds the \textbf{LaTeX} version of the +book. +\end{quote} + +\subsection{HTML}\label{html} + +\begin{verbatim} +make html +\end{verbatim} + +\subsection{DocX}\label{docx} + +\begin{verbatim} +make docx +\end{verbatim} + +\begin{quote} +NOTE: DocX is a work in progress. Frontmatter and formatting need work. +\end{quote} + +\subsection{ODT}\label{odt} + +\begin{verbatim} +make odt +\end{verbatim} + +\begin{quote} +NOTE: ODT is a work in progress. Frontmatter and formatting need work. +\end{quote} + +\subsection{Make All}\label{make-all} + +To build all supported formats + +\begin{verbatim} +make all +\end{verbatim} + +\section{Callouts}\label{callouts} + +A few callout box styles have been added to easily highlight content. + +\begin{establishedbox}[Established Concept] +Einsteins Relativistic Dynamics Equations +\[E^2 = (m_{0} \cdot c^2)^2 + (p \cdot c)^2 \] +\end{establishedbox} + +\begin{proposedbox}[Proposed Concept] +With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \] +\end{proposedbox} + +\begin{speculativebox}[Speculative Concept] +With the speed of light, \(c = 1\): \[E^2 = m_{0}^2 + p^2 \] +\end{speculativebox} + +\begin{cautionbox}[Caution Note] +Beware of this section. +\end{cautionbox} + +\begin{warningbox}[Warning Note] +Beware of this section. +\end{warningbox} + +\begin{dangerbox}[Alerts] +Extreme Highlight +\end{dangerbox} + +\appendix + +Appendix A + +\chapter{Appendix A: Build Environment +Notes}\label{appendix-a-build-environment-notes} + +\section{Installing Pre-Requisites}\label{installing-pre-requisites} + +\begin{cautionbox}[Not Cross-platform Tested] +For Debian / ZorinOS and likely Ubuntu based systems. +\end{cautionbox} + +\subsection{Required}\label{required} + +\subsubsection{Pandoc}\label{pandoc} + +\begin{itemize} +\tightlist +\item + https://pandoc.org/ +\item + \href{https://github.com/jgm/pandoc/releases/tag/3.8.2.1}{Download} +\end{itemize} + +\begin{quote} +\texttt{sudo\ apt\ install\ https://github.com/jgm/pandoc/releases/download/3.8.2.1/pandoc-3.8.2.1-1-amd64.deb} +\end{quote} + +\subsubsection{Code Editor}\label{code-editor} + +\begin{establishedbox}[Code Editor] +\href{https://vscodium.com/}{VSCodium} is recommend for privacy +(telemetry/tracking) reasons - https://vscodium.com/ +\end{establishedbox} + +But any text editor will work. \#\#\#\# make + +\begin{verbatim} +sudo apt install make +\end{verbatim} + +\subsubsection{jq and yq}\label{jq-and-yq} + +\begin{verbatim} +sudo apt install jq yq +\end{verbatim} + +\subsubsection{texlive}\label{texlive} + +\begin{quote} +\texttt{sudo\ apt\ install\ texlive\ texlive-xetex\ texlive-latex-extra\ texlive-fonts-recommended\ texlive-fonts-extra} +\end{quote} + +\subsubsection{MathJax}\label{mathjax} + +\begin{itemize} +\tightlist +\item + https://www.mathjax.org/ +\end{itemize} + +\begin{verbatim} +wget https://registry.npmjs.org/mathjax/-/mathjax-3.2.2.tgz +tar xzf mathjax-3.2.2.tgz +mv package/es5/* lib/mathjax +rm -rf package mathjax-3.2.2.tgz +\end{verbatim} + +\begin{cautionbox}[TODO] +This need to be rolled into a setup script. +\end{cautionbox} + +\subsection{Optional}\label{optional} + +The following are not strictly requires to use this book builder +template. + +\subsubsection{Obsidian}\label{obsidian} + +\begin{establishedbox}[Highly Recommended] +Editing book chapter content in Obsidian is a very productive means for +editing Markdown source content. +\end{establishedbox} + +\begin{itemize} +\tightlist +\item + https://obsidian.md/ +\item + \href{https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb}{Deb + Package} +\end{itemize} + +\begin{verbatim} +sudo apt install https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb +\end{verbatim} + +\subsubsection{Zotero}\label{zotero} + +\begin{establishedbox}[Highly Recommended] +If you need to managed citations and references, Zotero integration is +highly recommended. +\end{establishedbox} + +\begin{itemize} +\tightlist +\item + https://www.zotero.org/ +\end{itemize} + +\begin{verbatim} +sudo cp ./scripts/deps/zotero.list /etc/apt/sources.list.d/ +\end{verbatim} + +\begin{verbatim} +sudo apt update +\end{verbatim} + +\begin{verbatim} +sudo apt install zotero +\end{verbatim} + +\paragraph{Better BibTex for Zotero}\label{better-bibtex-for-zotero} + +Install the Better BibTex Plugin for Zotero - Zotero \textgreater{} Tool +\textgreater{} Plugins + +\paragraph{Export citations.bib}\label{export-citations.bib} + +\begin{itemize} +\tightlist +\item + Zotero \textgreater{} File \textgreater{} Export Library + \textgreater{} Format: Better BibTeX +\item[$\square$] + Keep Updated +\item[$\square$] + Save to: \textasciitilde/Documents/Lib/zotero.bib +\item[$\square$] + Symlink your \textasciitilde/Documents/Lib/Citations.bib to + basic-book-builder/lib/zotero.bib +\end{itemize} + +\paragraph{Zotero Connector Browser +Plugin}\label{zotero-connector-browser-plugin} + +\begin{itemize} +\tightlist +\item + https://chromewebstore.google.com/detail/zotero-connector/ekhagklcjbdpajgpjgmbionohlpdbjgc +\end{itemize} + +Provides you the ability to auto add Web resources to your Zotero +citation database. + +\subsubsection{lmodern}\label{lmodern} + +\begin{verbatim} +sudo apt install lmodern +\end{verbatim} + +\subsubsection{epubcheck}\label{epubcheck} + +\begin{verbatim} +sudo apt install epubcheck +\end{verbatim} + +\subsubsection{foliate}\label{foliate} + +An EPub Reader + +\begin{itemize} +\tightlist +\item + https://johnfactotum.github.io/foliate/ +\end{itemize} + +\begin{verbatim} +sudo apt install https://github.com/johnfactotum/foliate/releases/download/2.6.4/com.github.johnfactotum.foliate_2.6.4_all.deb +\end{verbatim} + +\subsubsection{calibre}\label{calibre} + +An EPub Reader + +\begin{itemize} +\tightlist +\item + https://calibre-ebook.com +\end{itemize} + +\begin{verbatim} +sudo apt install calibre +\end{verbatim} + +\section{Editing the Configuration}\label{editing-the-configuration} + \backmatter \chapter*{Glossary}\label{glossary} diff --git a/build/latex/basic-book-builder.toc b/build/latex/basic-book-builder.toc index 94c6f6f..7f3af36 100644 --- a/build/latex/basic-book-builder.toc +++ b/build/latex/basic-book-builder.toc @@ -2,6 +2,37 @@ \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 {chapter}{Glossary}{4}{chapter*.4}% -\contentsline {chapter}{Index}{6}{chapter*.5}% -\contentsline {chapter}{Bibliography}{8}{chapter*.6}% +\contentsline {section}{\numberline {2.3}Testing}{3}{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}% +\contentsline {section}{\numberline {3.1}Editing Content}{4}{section.3.1}% +\contentsline {section}{\numberline {3.2}Building}{4}{section.3.2}% +\contentsline {subsection}{\numberline {3.2.1}PDF}{4}{subsection.3.2.1}% +\contentsline {subsection}{\numberline {3.2.2}HTML}{4}{subsection.3.2.2}% +\contentsline {subsection}{\numberline {3.2.3}DocX}{4}{subsection.3.2.3}% +\contentsline {subsection}{\numberline {3.2.4}ODT}{4}{subsection.3.2.4}% +\contentsline {subsection}{\numberline {3.2.5}Make All}{5}{subsection.3.2.5}% +\contentsline {section}{\numberline {3.3}Callouts}{5}{section.3.3}% +\contentsline {chapter}{\numberline {A}Appendix A: Build Environment Notes}{6}{appendix.A}% +\contentsline {section}{\numberline {A.1}Installing Pre-Requisites}{6}{section.A.1}% +\contentsline {subsection}{\numberline {A.1.1}Required}{6}{subsection.A.1.1}% +\contentsline {subsubsection}{\numberline {A.1.1.1}Pandoc}{6}{subsubsection.A.1.1.1}% +\contentsline {subsubsection}{\numberline {A.1.1.2}Code Editor}{6}{subsubsection.A.1.1.2}% +\contentsline {subsubsection}{\numberline {A.1.1.3}jq and yq}{7}{subsubsection.A.1.1.3}% +\contentsline {subsubsection}{\numberline {A.1.1.4}texlive}{7}{subsubsection.A.1.1.4}% +\contentsline {subsubsection}{\numberline {A.1.1.5}MathJax}{7}{subsubsection.A.1.1.5}% +\contentsline {subsection}{\numberline {A.1.2}Optional}{7}{subsection.A.1.2}% +\contentsline {subsubsection}{\numberline {A.1.2.1}Obsidian}{7}{subsubsection.A.1.2.1}% +\contentsline {subsubsection}{\numberline {A.1.2.2}Zotero}{8}{subsubsection.A.1.2.2}% +\contentsline {paragraph}{\numberline {A.1.2.2.1}Better BibTex for Zotero}{8}{paragraph.A.1.2.2.1}% +\contentsline {paragraph}{\numberline {A.1.2.2.2}Export citations.bib}{8}{paragraph.A.1.2.2.2}% +\contentsline {paragraph}{\numberline {A.1.2.2.3}Zotero Connector Browser Plugin}{8}{paragraph.A.1.2.2.3}% +\contentsline {subsubsection}{\numberline {A.1.2.3}lmodern}{8}{subsubsection.A.1.2.3}% +\contentsline {subsubsection}{\numberline {A.1.2.4}epubcheck}{8}{subsubsection.A.1.2.4}% +\contentsline {subsubsection}{\numberline {A.1.2.5}foliate}{8}{subsubsection.A.1.2.5}% +\contentsline {subsubsection}{\numberline {A.1.2.6}calibre}{9}{subsubsection.A.1.2.6}% +\contentsline {section}{\numberline {A.2}Editing the Configuration}{9}{section.A.2}% +\contentsline {chapter}{Glossary}{10}{appendix*.4}% +\contentsline {chapter}{Index}{12}{appendix*.5}% +\contentsline {chapter}{Bibliography}{14}{appendix*.6}% diff --git a/build/odt/basic-book-builder.odt b/build/odt/basic-book-builder.odt new file mode 100644 index 0000000..ba734f7 Binary files /dev/null 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 2bc4a14..ff93834 100644 Binary files a/build/pdf/basic-book-builder.pdf and b/build/pdf/basic-book-builder.pdf differ diff --git a/chapters/01_Getting_Started.md b/chapters/01_Getting_Started.md index fab6121..4e181fa 100644 --- a/chapters/01_Getting_Started.md +++ b/chapters/01_Getting_Started.md @@ -3,7 +3,7 @@ ## Cloning the Basic Book Builder -> [!cli] Cloning the repository +> [!cli] Clone the repository > ``` > git clone https://github.com/jehaverlack/basic-book-builder.git > ``` @@ -14,16 +14,11 @@ > cd basic-book-builder > ``` -> [!code] Code Example -> ``` -> if then else -> ``` - ## Setting Up Build Environment -> [!caution] Debian Based Linux -> This script only support Debian based linux system (Debian, Ubunutu, Zorin, etc) +> [!caution] ~Debian Linux +> This script only support Debian based Linux system (Debian, Ubunutu, Zorin, etc) > This script has not been widely tested across platforms @@ -35,3 +30,23 @@ For more information on setting up the build environment for your system see Appendix A. + + + + + +## Testing + + +If you can build all format for the **Basic Book Build** then you have a working build environment. + +> [!cli] Testing Build Environment +> ``` +> make all +> ``` + + +## Creating a New Project + + +### Zotero Configuration (Optional) \ No newline at end of file diff --git a/chapters/02_Usage.md b/chapters/02_Usage.md index e69de29..14184f1 100644 --- a/chapters/02_Usage.md +++ b/chapters/02_Usage.md @@ -0,0 +1,46 @@ +# Usage + +## Editing Content + + + +## Building + +### PDF + +``` +make pdf +``` + +> NOTE: Building the PDF also builds the **LaTeX** version of the book. + +### HTML + +``` +make html +``` + +### DocX + +``` +make docx +``` + +> NOTE: DocX is a work in progress. Frontmatter and formatting need work. + +### ODT + +``` +make odt +``` + +> NOTE: ODT is a work in progress. Frontmatter and formatting need work. + +### Make All + +To build all supported formats + +``` +make all +``` + diff --git a/chapters/03_Features.md b/chapters/03_Features.md index 5c3a3e6..b5e014b 100644 --- a/chapters/03_Features.md +++ b/chapters/03_Features.md @@ -32,372 +32,3 @@ $$E^2 = m_{0}^2 + p^2 $$ -# Example Content - -In $R\nu$ the [Planck Length](https://en.wikipedia.org/wiki/Planck_units#Planck_length) is the universal unit for measurement of distance, and is defined approximately to be: -$$\boxed{L_P=\sqrt{\hbar}=5.72928\times10^{-35}m=1 L}$$ -Where $1\ L$, is 1 Planck Length of distance. - -### SI Conversion Factors - -The following conversion factors can be used to convert observable quantities of measure from the _SI_ system of units to $R\nu$ to ~6 significant digits. - -| Conversion Factor | Symbol | Value | -| ---------------------------- | -------- | -------------------------------------------------- | -| meters to Planck Length | $\chi_P$ | $1.74542\times10^{34} \frac{L}{m}$ | -| seconds to Planck Length | $\tau_p$ | $5.23264\times10^{42} \frac{L}{s}$ | -| mass to Planck Length | $G_P$ | $1.62871\times10^8 \frac{L}{kg}$ | -| energy to Planck Length | $E_P$ | $1.81219\times10^9 \frac{L}{J}$ | -| momentum to Planck Length | $P_P$ | $5.43280\times10^{-1} \frac{L\cdot s}{kg \cdot m}$ | -| temperature to Planck Length | $k_P$ | $2.501998\times10^{-14} \frac{L}{K}$ | -| charge to Planck Length | $C_P$ | $1.89007\times10^{18} \frac{L}{C}$ | - -### Physical Constants -Applying conversion factors from the table above, we can convert SI values to Reduced Natural Units. For example, performing this analysis on the the speed of light yields a unit-less number with a value of 1: - -$c = 299792458 \frac{m}{s} = 299792458 \frac{m}{s} \cdot 1.74542\times10^{34} \frac{L}{m} \cdot \frac{1}{5.23264\times10^{42} \frac{L}{s}} = 1.00000$ - -| Quantity | Symbol | SI | $\nu$ | -| ------------------------------ | ------------ | ------------------------------------------------------------ | ------------------------------ | -| Speed of Light | $c$ | $299792458 \frac{m}{s}$ | 1 | -| Reduced Gravitational Constant | $G_0$ | $8.38659\times10^{-10} \frac{m^3}{kg \cdot s^2}$ | 1 | -| Boltzmann's Constant | $k$ | $k=1.380649\times10^-23 \frac{J}{K}$ | 1 | -| Permittivity of Free Space | $\epsilon_o$ | $8.854187817620\times10^{-12} \frac{C^{2}s^2}{kg \cdot m^3}$ | 1 | -| Permeability of Free Space | $\mu_o$ | $\huge{\frac{1}{\epsilon_{o} \cdot c^{2}}}$ | 1 | -| Reduced Planck's Constant | $\hbar$ | $1.054571726\times10^-34 \frac{kg \cdot m^2}{s}$ | $1 L^2$ | -| Mass of the Electron | $m_e$ | $9.10938\times10^{-31} kg$ | $1.48366\times10^{-22} L$ | -| Charge of the Electron | $e^-$ | $-1.60218\times10^{-19} C$ | $-3.02822\times10^{-1} L$ | -| Unit Cycle | $\Theta$ | $2\pi = 6.28318...\ Radians$ | $1 \tau = 6.28318...\ Radians$ | - -## Fine Structure Constant - -As a consistency check, we compute the _[Fine Structure Constant](https://en.wikipedia.org/wiki/Fine-structure_constant)_ using Reduced Natural Units which is a unit less ratio that should be independent of our system of units. - -$\huge{\alpha=\frac{e^2}{4\pi\epsilon_o\hbar c}=\frac{e^2}{2\tau}=0.00729735≈\frac{1}{137}}$ - - -#### Dimensional Analysis - -The reader should be familiar with high school physics and chemistry [dimensional analysis](https://en.wikipedia.org/wiki/Dimensional_analysis). - -- $1\ meter\ (m) = 100\ centimeters\ (cm)$ -- $1\ kilometer\ (km) = 1000\ meters\ (m)$ -- $1\ mile = 5280\ feet\ (ft\ or\ ')$ -- $1\ foot\ (ft\ or\ ') = 12\ inches\ (in\ or\ ")$ -- $1\ inch\ (") = 2.54\ centimeters\ (cm)$ - -How many kilometers are in 1 mile? -$1\ mile = 1\ mile \times \frac{5280\ ft}{mile} \times \frac{12\ in}{ft} \times \frac{2.54\ cm}{in}\times \frac{1\ m}{100 cm} \times \frac{1\ km}{1000 m} = \frac{5280 \times 12 \times 2.54}{100 \times 1000}\ km = \frac{160934.40}{100000}\ km = 1.6\ km$ -Note that each unit in the denominator cancels with one if the numerator until we are left with only km. - - -## Newton's Law of Gravity - -The force of gravity ($F_g$) between 2 masses, $m1$ and $m2$ separated by distance $r$ is given by [Newton's Law of Gravity](https://en.wikipedia.org/wiki/Newton%27s_law_of_universal_gravitation): - -$F_{g} = G \frac{m_{1} m_{2}}{r^{2}}$ - -Where $G$, is the [Gravitational Constant](http://en.wikipedia.org/wiki/Gravitational_Constant). - -$G = 6.67430 \times 10^{-11}\ N\frac{m^2}{kg^2}$ - -The strength of gravitational force follow the inverse square law distributing gravitational flux over the surface area of a sphere ($4\pi r^2$). - -#### Inverse Square Law - -Any source of a signal strength ($S_0$) that radiates isotropically in 3-dimensional space will distribute that signal strength ($S_0$) over the surface area of a sphere ($SA = 4 \pi r$) of radius ($r$). Such that the intensity ($I$) at distance ($r$) is: - -$$I(r) = \frac{S_0}{4 \pi r^{2}}=\frac{S_0}{2 \tau r^{2}}$$ -![inverse square law](lib/img/Inverse_square_law.svg.png) -#### $R\nu$ Reduced Gravitational Constant -In this version of Newton's Law of Gravity we introduce a new constant $G_0$, the reduced gravitational constant to accommodate for the factor of $4\pi = 2\tau$ which is has been integrated in the SI version of the gravitational constant. - -$F_g =G \frac{m_{1} m_{2}}{r^{2}}= G_0 \frac{m_{1} m_{2}}{4 \pi r^{2}}=G_0 \frac{m_{1} m_{2}}{2 \tau r^{2}}$ - -Where: - -$G = \frac{G_{0}}{2\tau} = 6.67384 \times 10^{-11} \frac{N \cdot m^2}{kg^2}$ - -Analyzing the units: -$$\frac{N \cdot m^2}{kg^2} = \left( \frac{\left( kg \cdot \frac{m}{s^2} \right) \cdot m^2}{kg^2} \right)=\frac{m^3}{s^2 kg}$$ -Converting seconds to meters with the SI speed of light as a conversion factor: -$$\frac{m^3}{s^2 kg}\cdot\frac{1}{c^2}=\frac{m^3}{s^2 kg}\cdot\frac{s^2}{m^2}=\frac{m}{kg}$$ - -Thus where space and time are measured in units of meters, the reduced gravitational constant, is: - -$$\boxed{G_0=\frac{2\tau G}{c^2}=\frac{2\tau \cdot 6.67384 \times 10^{-11}}{299792458^2} \frac{m}{kg} = 9.33135 \times 10^-27 \frac{m}{kg}}$$ - -> Observation -> This implies that not only can space an time be measure in units of meters, but so can mass. - -### Relativistic Energy Momentum Relation - -Einsteins [Relativistic Energy Momentum](https://en.wikipedia.org/wiki/Energy%E2%80%93momentum_relation) relationship shows a Pythagorean relation between the total energy ($E$), rest mass ($m_0$) and momentum ($p$) of a system. - -$E^{2} = (m_0 \cdot c^2)^2 + (p \cdot c)^2$ - -Where space and time are both measure in units of meters, c=1. - -$E^2=(m_0)^2+(p)^2$ - -From this we can see that Energy, Momentum and Mass have equivalent units. - -> -> _While we do not really know what energy, mass and momentum are we know that they are fundamentally “made” out of the same stuff because they have the same units._ - -##### Objects of mass at rest - -For an object at rest with no momentum ($p = 0$) we see Einstein's famous equations: - -$E = m_{0} \cdot c^2$ - -Or, with $c=1$, this is much simpler to understand. Energy = Mass - -$E = m_0$ - -##### Zero mass objects moving at the speed of light - -And for objects with no mass, like photos, ($m_{0}= 0$): - -$E=pc$ - -Or, with $c=1$, this is much simpler to understand. Energy = Momentum - -$E=p$ - -## Planck's Constant - -The [Reduced Planck constant](https://en.wikipedia.org/wiki/Planck_constant) , ħ, represents a conversion factor for relating the frequency, $\omega$ (in $2\pi$ radians per second), of a photon to the energy of that photon. This can easily be seen from the simple but profound relationship: - -$E=\hbar\omega$ - -Where: - -$\hbar=1.054571726 \times 10^{−34} J \cdot s$ - -and - -$J \cdot s = {kg}\cdot\frac{m^2}{s}$ - -> Reduced Planck's Constant -> $\hbar = \frac{h}{2\pi} = \frac{h}{\tau}$ - - -Simplifying our units by converting time and mass to units of meters: -$$\boxed{\hbar=1.054571726 \times 10^{−34} {kg}\cdot\frac{m^2}{s}\cdot\frac{G_0}{c}=3.282462\times10^{-69}m^2}$$ - -Which suggest that the Plank constant can be interpreted as an areas for which the square root of is suspiciously close to the Plank length: - -$$\boxed{\sqrt{\hbar}=\sqrt{3.282462\times10^{-69}m^2}=5.72928\times10^{-35}m}$$ - -#### Planck Area - -The [Planck Area](https://en.wikipedia.org/wiki/Planck_units#Derived_units) is the square of the [Planck Length](https://en.wikipedia.org/wiki/Planck_units#Planck_length). - -$l_{P}= \sqrt{\frac{\hbar G}{c^3}}$ - -and $l_{P}^{2}= \frac{\hbar G}{c^3}$ - -In $R\nu$ units both $c$ and $G_o$ are 1. - -$l_{P} = \sqrt{\hbar}$ - -and $l_P^{2}=\hbar$ -## Bekenstein's Bound -After having recently read _Three Roads to Quantum Gravity_ by Lee Smolin, I now suspect the meaning of this areas is related to the [Bekensteins Law](https://en.wikipedia.org/wiki/Bekenstein_bound) as applied to a surface areas surrounding a mass. Where the [thermodynamic entropy](https://en.wikipedia.org/wiki/Entropy_(statistical_thermodynamics)), _S_, is proportional to the the enclosed surface area, $A$. - -$S=\frac{1}{4}\cdot\frac{A}{G\hbar}$ - -$S=\frac{k c^{3} A}{4 G \hbar}$ - - -$S \le \frac{2\pi k R E}{\hbar c} = \frac{\tau R k E}{\hbar c}$ - -From our new values for $G_0$and $\hbar$ we can likely rewrite this: - -$S=\frac{\pi\cdot A}{\hbar G_0}$ - -With the limiting case being at the Plank scale. - -$S=\frac{\pi\cdot \sqrt{\hbar}}{\hbar G_0}$ - -## Planck Length -https://en.wikipedia.org/wiki/Planck_length - -The concept of the Planck Length comes from exploring the limits of Quantum Mechanics and General Relativity. The limits of General Relativity can be seen a the event horizon of a black hole, described by the Schwarzschild Radius. And the limits of Quantum Mechanics can be found in the Compton Wavelength for a given quanta. - -The [Schwarzschild Radius](https://simple.wikipedia.org/wiki/Schwarzschild_radius) is defined as the distance at which light cannot escape from the gravitational field of a mass (m): - -Classic Derivation. - -$r_S=\frac{2G m}{c^2}$ - -The reduced [Compton Wavelength](https://en.wikipedia.org/wiki/Compton_wavelength) represents a lower limit on the wavelength for quanta that can interact with a quantum particle with mass (m): - -$\lambda_C=\frac{h}{m c}$ - -$\bar{\lambda_C}=\frac{2\pi\hbar}{m c}=\frac{\tau\hbar}{m c}$ - -And set the Schwarzschild Radius equal to the Compton Wavelength: -$r_S=\lambda_C$ - -$\frac{2Gm}{c^{2}}=\frac{h}{m c}$ - -$m^{2}= \frac{hc}{2G}$ - -$m = \sqrt{\frac{hc}{2G}}$ - -$l_P=\frac{2G\sqrt{\frac{hc}{2G}}}{c^2}$ -$l_P=\frac{2G\sqrt{\frac{hc}{2G}}}{c^{2}}= \sqrt{\frac{2Gh}{c^2}}$ - -With reduced Compton Wavelength -$r_S=\bar{\lambda_C}$ - -$\frac{2Gm}{c^{2}}=\frac{\tau\hbar}{m c}$ - -$m^2=\frac{\tau\ \hbar\ c}{2G}$ - -$m = \sqrt{\frac{\tau\ \hbar\ c}{2G}}$ - -$l_P=\frac{2G\sqrt{\frac{\tau\ \hbar\ c}{2G}}}{c^2}$ - -$l_P=\frac{2G\sqrt{\frac{\tau\ \hbar\ c}{2G}}}{c^{2}}=\sqrt{\frac{4\ \tau\ G\ \hbar}{c^3}}$ - -If we reduce the units in these equation to those of mass and time measured in meters. - -$l_P=\sqrt{4\tau\hbar G_{o}}$ - -and - -$\lambda_C=\frac{\hbar}{m}$ - -$m=R_s=\lambda_C=\frac{\hbar}{m}$ - -This is known as the Planck Mass, $M_P$. -$M_P=m=\sqrt{\hbar}$ - -Solving the Compton Wavelength for distance we find the classic Plank Length: - -$\lambda_C=\frac{\hbar}{\sqrt{\hbar}}=\frac{\sqrt{\hbar}}{\sqrt{\hbar}}\cdot\frac{\hbar}{\sqrt{\hbar}}=\sqrt{\hbar}=L_P$ - -Which is in precise agreement with the value we found in above. Thus the Plank Length is: - -$L_P=\sqrt{\hbar}=5.72928\times10^{-35}m$ - -When we measure distance, time, and mass in units of distance, c=1, and the Plank Time, $T_P$, is equal to Plank Length, $L_P$, which is equal to the Plank Mass, $M_P$: - -$$\boxed{L_P=T_P=M_P}$$ - -Conversion Factor | Symbol | Value ---- | --- | ---- -meters to Planck Length | $\chi_P$ | $1.74542\times10^{34} \frac{L}{m}$ -seconds to Planck Length | $\tau_p$ | $5.23264\times10^{42} \frac{L}{s}$ -mass to Planck Length | $G_P$ | $1.62871\times10^8 \frac{L}{kg}$ -energy to Planck Length | $E_P$ | $1.81219\times10^9 \frac{L}{J}$ -momentum to Planck Length | $P_P$ | $5.43280\times10^{-1} \frac{L\cdot s}{kg \cdot m}$ -temperature to Planck Length | $k_P$ | $2.501998\times10^{-14} \frac{L}{K}$ -charge to Planck Length | $C_P$| $1.89007\times10^{18} \frac{L}{C}$ - -Applying conversion factors from the table above, we can convert SI values to Reduced Natural Units. -$c=\frac{1}{\sqrt{\epsilon_o \mu_o}}$ - -Quantity | Symbol | SI | $\nu$ ---- | --- | --- | ---- -Speed of Light | $c$ | $299792458 \frac{m}{s}$ | 1 -Gravitational Constant | $G_0$ | $8.38659\times10^{-10} \frac{m^3}{kg \cdot s^2}$ | 1 -Boltzmann's Constant | $k$ | $k=1.380649\times10^-23 \frac{J}{K}$ | 1 -Permittivity of Free Space | $\epsilon_o$ | $8.854187817620\times10^{-12} \frac{C^{2}s^2}{kg \cdot m^3}$ | 1 -Permeability of Free Space | $\mu_o$ | $\huge{\frac{1}{\epsilon_{o} \cdot c^{2}}}$ | 1 -Planck's Constant | $\hbar$ | $1.054571726\times10^-34 \frac{kg \cdot m^2}{s}$ | $1 L^2$ -Mass of the Electron | $m_e$ | $9.10938\times10^{-31} kg$ | $1.48366\times10^{-22} L$ -Charge of the Electron | $e^-$ | $-1.60218\times10^{-19} C$ | $-3.02822\times10^{-1} L$ - -## Fine Structure Constant -https://en.wikipedia.org/wiki/Fine-structure_constant -As a consistency check, we compute the _Fine Structure Constant_ using Reduced Natural Units which is a unit less ratio that should be independent of our system of units. - -$\huge{\alpha=\frac{e^2}{4\pi\epsilon_o\hbar c}=\frac{e^2}{4\pi}=0.00729735≈\frac{1}{137}}$ - -This check confirms that our system of Reduced Natural Units has internally consistent values for $c$, $\epsilon_o$, $\hbar$ and $e-$. And also $G_o$ which was used to computer prior values is also consistent. - -## Sage Code -Unit Analysis computations have been performed with [Sage Math](https://www.sagemath.org/). - -```bash -# Define constance -one = 1.n(digits=6) -pi = pi.n(digits=6) -tau = 2 * pi -t = tau - -# Define the units -meters = var('m') -m = one*meters - -seconds = var('s') -s = seconds - -kilograms = var('kg') -kg = kilograms - -newtons = kg * m / s^2 -N = newtons - -joules = N * m -J = joules - -print("pi =", pi) -print("tau =", t) - -# Speed of light in meters/second -speed_of_light = 299792458 * meters/seconds -sol = speed_of_light -c = sol -print("si c =", c) - -rnu_c = c / c -print("R\u03BD c =", rnu_c) - -# Gravitational Constant -gravitational_constant = 6.67384e-11 * N*(m^2/kg^2) -G = gravitational_constant -print("si G =", G) - -rnu_G = 4*pi*G/c^2 -Go = rnu_G -print("R\u03BD Go =", Go) - - -# Planck's Constant -reduced_plancks_constant = 1.054571726e-34 * J*s -h_bar = reduced_plancks_constant -print("si \u210F =", h_bar) - -rnu_h_bar = h_bar * Go / c -print("R\u03BD "u"\u210F =", rnu_h_bar) - -# Planck Length -rnu_h_bar_str = str(rnu_h_bar) -numerical_part_str = rnu_h_bar_str.split('*')[0] -numerical_part_str = numerical_part_str.strip('()') -numerical_part = float(numerical_part_str) -rnu_sqrt_h_bar = numerical_part^(1/2) -# ^ Sage cannot process sqrt on units... Lame. -lP = rnu_sqrt_h_bar * m -print("R\u03BD \u221A\u210F =", lP) -``` - -#### Output -``` -pi = 3.14159 -tau = 6.28319 -si c = 299792458*m/s -Rν c = 1 -si G = (6.67384e-11)*m^3/(kg*s^2) -Rν Go = (9.33135e-27)*m/kg -si ℏ = (1.05457e-34)*kg*m^2/s -Rν ℏ = (3.28246e-69)*m^2 -Rν √ℏ = (5.72928e-35)*m -si lP = (1.61620e-35)*sqrt(m^2) -Rν lP = (2.77455e-47)*sqrt(m^3/kg) -``` diff --git a/chapters/04_Design.md b/chapters/04_Design.md new file mode 100644 index 0000000..4f8447d --- /dev/null +++ b/chapters/04_Design.md @@ -0,0 +1,12 @@ +# Design + +## Directory Structure + + +## Configuration Files + + + + +## Build Workflow + diff --git a/templates/pandoc.yaml b/templates/pandoc.yaml index d5d3b00..2f14194 100644 --- a/templates/pandoc.yaml +++ b/templates/pandoc.yaml @@ -3,9 +3,10 @@ input-files: # - chapters/Preface.md - chapters/00_Introduction.md - chapters/01_Getting_Started.md - # - chapters/02_Features.md - # - chapters/Appendix.md - # - chapters/AppendixA.md + - chapters/02_Usage.md + - chapters/03_Features.md + - chapters/Appendix.md + - chapters/AppendixA.md # - chapters/AppendixB.md - chapters/Glossary.md - chapters/Index.md