Appendix A

# Appendix A: Build Environment Notes
## Installing Pre-Requisites



> [!caution] Not Cross-platform Tested
> For Debian / ZorinOS and likely Ubuntu based systems.

### Required

#### Pandoc

- https://pandoc.org/
- [Download](https://github.com/jgm/pandoc/releases/tag/3.8.2.1)

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

#### Code Editor


> [!established] Code Editor
> [VSCodium](https://vscodium.com/) 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
```

> [!caution] TODO
> This need to be rolled into a setup script.



### Optional

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

#### Obsidian

> [!established] Highly Recommended
> Editing book chapter content in Obsidian is a very productive means for editing Markdown source content.

- https://obsidian.md/
- [Deb Package](https://github.com/obsidianmd/obsidian-releases/releases/download/v1.9.14/obsidian_1.9.14_amd64.deb)

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

#### Zotero

> [!established] 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
- [ ] Keep Updated
- [ ] Save to:  ~/Documents/Lib/zotero.bib
- [ ] Symlink your ~/Documents/Lib/Citations.bib to basic-book-builder/lib/zotero.bib

##### 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