ExternalVendorCode/pandoc-latex-template
1
0
Fork 0
mirror of https://github.com/Wandmalfarbe/pandoc-latex-template.git synced 2024-12-18 22:07:51 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Issue 141: Added a section on *required LaTeX packages* to the readme.

Browse Source 
The section explains how to install the required packages with texlive and MiKtEX.
This commit is contained in:
Wandmalfarbe 2020-01-19 15:13:08 +01:00
parent 3527df56e3
commit 8237b646ee
1 changed files with 63 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
README.md
View File

@ -170,6 +170,69 @@ This template defines some new variables to control the appearance of the result
LaTeX command to change the font size for code blocks. The available values are `\tiny`, `\scriptsize`, `\footnotesize`, `\small`, `\normalsize`, `\large`, `\Large`, `\LARGE`, `\huge` and `\Huge`. This option will change the font size for default code blocks using the verbatim environment and for code blocks generated with listings.
## Required LaTeX Packages
LaTeX manages addons and additional funktionality in so called packages. You
might get the following error when compiling a document with the Eisvogel
template:
``` sh
! LaTeX Error: File `footnotebackref.sty' not found.
Type X to quit or <RETURN> to proceed,
or enter new name. (Default extension: sty)
Enter file name:
! Emergency stop.
<read *>
```
LaTeX informs you that the additional package `footnotebackref` is required to
render the document.
### Texlive
Eisvogel requires a full texlive distribution that can be installed by running
`apt-get install texlive-full` in the terminal. Because `texlive-full` is very
large (about 5 Gigabytes) you can also install the smaller texlive bundles and
add any missing packages manually.
A smaller texlife bundle is `texlive-latex-extra`. With `texlive-latex-extra`
you also need to install these packages manually:
```
adjustbox babel-german background bidi collectbox csquotes everypage filehook
footmisc footnotebackref framed fvextra letltxmacro ly1 mdframed mweights
needspace pagecolor sourcecodepro sourcesanspro titling ucharcat ulem
unicode-math upquote xecjk xurl zref
```
Install them with the following command:
``` sh
tlmgt install adjustbox babel-german background bidi collectbox csquotes everypage filehook footmisc footnotebackref framed fvextra letltxmacro ly1 mdframed mweights needspace pagecolor sourcecodepro sourcesanspro titling ucharcat ulem unicode-math upquote xecjk xurl zref
```
Additional information about the different texlive packages can be found at
this TeX-StackExchange answer: <https://tex.stackexchange.com/a/504566>
### MiKTeX
If you don't want to install all missing packages manually, [MiKTeX might be
an alternative](https://miktex.org/howto/miktex-console).
> MiKTeX has the ability to automatically install missing packages.
> You can turn this feature on or off. And you can let MiKTeX ask you each time a package has to be installed:
>
> - Click `Settings` to navigate to the settings page.
> - Click the `General` tab.
> - Click one of the radio buttons:
> - `Ask me`
> - `Always install missing packages on-the-fly`
> - `Never install missing packages on-the-fly`
## Examples
### Numbered Sections