From cae7479ef74c12cadc7013d737de88fb9b6dcf01 Mon Sep 17 00:00:00 2001 From: Altair Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Sun, 4 Dec 2022 21:41:18 +0100 Subject: [PATCH 1/3] docs: Updated installation instructions --- README.md | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index ad2aef1..d50ba02 100644 --- a/README.md +++ b/README.md @@ -14,14 +14,25 @@ A clean **pandoc LaTeX template** to convert your markdown files to PDF or LaTeX ## Installation -1. Install pandoc from . You also need to install [LaTeX](https://en.wikibooks.org/wiki/LaTeX/Installation#Distributions). -2. Download the latest version of the Eisvogel template from [the release page](https://github.com/Wandmalfarbe/pandoc-latex-template/releases/latest). -3. Extract the downloaded ZIP archive and open the folder. -4. Move the template `eisvogel.latex` to your pandoc templates folder. The location of the templates folder depends on your operating system: - - Unix, Linux, macOS: `/Users/USERNAME/.local/share/pandoc/templates/` or `/Users/USERNAME/.pandoc/templates/` - - Windows Vista or later: `C:\Users\USERNAME\AppData\Roaming\pandoc\templates\` - - If there are no folders called `templates` or `pandoc` you need to create them and put the template `eisvogel.latex` inside. You can find the default user data directory on your system by looking at the output of `pandoc --version`. +### Requisites + +- [Pandoc](http://pandoc.org/) +- [LaTeX](https://en.wikibooks.org/wiki/LaTeX/Installation#Distributions) + +### Unix, Linux, macOS + +```sh +PANDOC_HOME="$(pandoc --version | sed -n 's|^User data.*: \(.*\)$|\1|gp')" +mkdir -p "$PANDOC_HOME/templates" +curl -o "$PANDOC_HOME/templates/eisvogel.tex" "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.1.0/eisvogel.tex" +``` + +### Windows (Powershell) + +```powershell +mkdir "$home\AppData\Roaming\pandoc\templates" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.1.0/eisvogel.tex" -OutFile "$home\AppData\Roaming\pandoc\templates\eisvogel.tex" +``` ## Usage From 79d4046d3e72140dcb9754652c62b422860ca3b6 Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Mon, 23 Jan 2023 14:11:40 +0100 Subject: [PATCH 2/3] chores: Update README URL --- README.md | 335 +++++++++++++++++++++++++++++++++--------------------- 1 file changed, 203 insertions(+), 132 deletions(-) diff --git a/README.md b/README.md index 9c2e37c..9e8a9b4 100644 --- a/README.md +++ b/README.md @@ -4,12 +4,14 @@ [![Build Status](https://travis-ci.com/Wandmalfarbe/pandoc-latex-template.svg?branch=master)](https://travis-ci.com/Wandmalfarbe/pandoc-latex-template) -A clean **pandoc LaTeX template** to convert your markdown files to PDF or LaTeX. It is designed for lecture notes and exercises with a focus on computer science. The template is compatible with pandoc 3. +A clean **pandoc LaTeX template** to convert your markdown files to PDF or +LaTeX. It is designed for lecture notes and exercises with a focus on computer +science. The template is compatible with pandoc 3. ## Preview -| A custom title page | A basic example page | -| :------------------: | :------------------: | +| A custom title page | A basic example page | +| :-------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------: | | [![A custom title page](examples/title-page-custom/preview.png)](examples/title-page-custom/document.pdf) | [![A basic example page](examples/basic-example/preview.png)](examples/basic-example/document.pdf) | ## Installation @@ -24,31 +26,37 @@ A clean **pandoc LaTeX template** to convert your markdown files to PDF or LaTeX ```sh PANDOC_HOME="$(pandoc --version | sed -n 's|^User data.*: \(.*\)$|\1|gp')" mkdir -p "$PANDOC_HOME/templates" -curl -o "$PANDOC_HOME/templates/eisvogel.tex" "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.1.0/eisvogel.tex" +curl -o "$PANDOC_HOME/templates/eisvogel.tex" "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" ``` ### Windows (Powershell) ```powershell mkdir "$home\AppData\Roaming\pandoc\templates" -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.1.0/eisvogel.tex" -OutFile "$home\AppData\Roaming\pandoc\templates\eisvogel.tex" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" -OutFile "$home\AppData\Roaming\pandoc\templates\eisvogel.tex" ``` ## Usage -1. Open the terminal and navigate to the folder where your markdown file is located. +1. Open the terminal and navigate to the folder where your markdown file is + located. 2. Execute the following command - ``` bash + ```bash pandoc example.md -o example.pdf --from markdown --template eisvogel --listings ``` where `example.md` is the markdown file you want to convert to PDF. -In order to have nice headers and footers you need to supply metadata to your document. You can do that with a [YAML metadata block](http://pandoc.org/MANUAL.html#extension-yaml_metadata_block) at the top of your markdown document (see the [example markdown file](examples/basic-example/document.md)). Your markdown document may look like the following: +In order to have nice headers and footers you need to supply metadata to your +document. You can do that with a +[YAML metadata block](http://pandoc.org/MANUAL.html#extension-yaml_metadata_block) +at the top of your markdown document (see the +[example markdown file](examples/basic-example/document.md)). Your markdown +document may look like the following: -``` markdown +```markdown --- title: "The Document Title" author: [Example Author, Another Author] @@ -61,140 +69,174 @@ Here is the actual document text... ### Custom Template Variables -This template defines some new variables to control the appearance of the resulting PDF document. The existing template variables from pandoc are all supported and their documentation can be found in [the pandoc manual](https://pandoc.org/MANUAL.html#variables-for-latex). +This template defines some new variables to control the appearance of the +resulting PDF document. The existing template variables from pandoc are all +supported and their documentation can be found in +[the pandoc manual](https://pandoc.org/MANUAL.html#variables-for-latex). - - `titlepage` (defaults to `false`) +- `titlepage` (defaults to `false`) - turns on the title page when `true` + turns on the title page when `true` - - `titlepage-color` +- `titlepage-color` - the background color of the title page. The color value must be given as an HTML hex color like `D8DE2C` without the leading number sign (`#`). When specifying the color in YAML, it is advisable to enclose it in quotes like so `titlepage-color: "D8DE2C"` to avoid the truncation of the color (e.g. `000000` becoming `0`). + the background color of the title page. The color value must be given as an + HTML hex color like `D8DE2C` without the leading number sign (`#`). When + specifying the color in YAML, it is advisable to enclose it in quotes like so + `titlepage-color: "D8DE2C"` to avoid the truncation of the color + (e.g. `000000` becoming `0`). - - `titlepage-text-color` (defaults to `5F5F5F`) +- `titlepage-text-color` (defaults to `5F5F5F`) - the text color of the title page + the text color of the title page - - `titlepage-rule-color` (defaults to `435488`) +- `titlepage-rule-color` (defaults to `435488`) - the color of the rule on the top of the title page + the color of the rule on the top of the title page - - `titlepage-rule-height` (defaults to `4`) +- `titlepage-rule-height` (defaults to `4`) - the height of the rule on the top of the title page (in points) + the height of the rule on the top of the title page (in points) - - `titlepage-logo` +- `titlepage-logo` - path to an image that will be displayed on the title page. The path is always relative to where pandoc is executed. The option `--resource-path` has no effect. + path to an image that will be displayed on the title page. The path is always + relative to where pandoc is executed. The option `--resource-path` has no + effect. - - `titlepage-background` +- `titlepage-background` - the path to a background image for the title page. The background image is scaled to cover the entire page. In the examples folder under `titlepage-background` are a few example background images. + the path to a background image for the title page. The background image is + scaled to cover the entire page. In the examples folder under + `titlepage-background` are a few example background images. - - `page-background` +- `page-background` - the path to a background image for any page. The background image is scaled to cover the entire page. In the examples folder under `page-background` are a few example background images. + the path to a background image for any page. The background image is scaled to + cover the entire page. In the examples folder under `page-background` are a + few example background images. - - `page-background-opacity` (defaults to `0.2`) +- `page-background-opacity` (defaults to `0.2`) - the background image opacity + the background image opacity - - `caption-justification` (defaults to `raggedright`) +- `caption-justification` (defaults to `raggedright`) - justification setting for captions (uses the `justification` parameter of the [caption](https://ctan.org/pkg/caption?lang=en) package) + justification setting for captions (uses the `justification` parameter of the + [caption](https://ctan.org/pkg/caption?lang=en) package) - - `toc-own-page` (defaults to `false`) +- `toc-own-page` (defaults to `false`) - begin new page after table of contents, when `true` + begin new page after table of contents, when `true` - - `listings-disable-line-numbers` (defaults to `false`) +- `listings-disable-line-numbers` (defaults to `false`) - disables line numbers for all listings + disables line numbers for all listings - - `listings-no-page-break` (defaults to `false`) +- `listings-no-page-break` (defaults to `false`) - avoid page break inside listings + avoid page break inside listings - - `disable-header-and-footer` (default to `false`) +- `disable-header-and-footer` (default to `false`) - disables the header and footer completely on all pages + disables the header and footer completely on all pages - - `header-left` (defaults to the title) +- `header-left` (defaults to the title) - the text on the left side of the header + the text on the left side of the header - - `header-center` +- `header-center` - the text in the center of the header + the text in the center of the header - - `header-right` (defaults to the date) +- `header-right` (defaults to the date) - the text on the right side of the header + the text on the right side of the header - - `footer-left` (defaults to the author) +- `footer-left` (defaults to the author) - the text on the left side of the footer + the text on the left side of the footer - - `footer-center` +- `footer-center` - the text in the center of the footer + the text in the center of the footer - - `footer-right` (defaults to the page number) +- `footer-right` (defaults to the page number) - the text on the right side of the footer + the text on the right side of the footer - - `footnotes-pretty` (defaults to `false`) +- `footnotes-pretty` (defaults to `false`) - prettifies formatting of footnotes (requires package `footmisc`) + prettifies formatting of footnotes (requires package `footmisc`) - - `footnotes-disable-backlinks` (defaults to `false`) +- `footnotes-disable-backlinks` (defaults to `false`) - disables making the reference from the footnote at the bottom of the page into a link back to the occurence of the footnote in the main text (enabling requires package `footnotebackref`). + disables making the reference from the footnote at the bottom of the page into + a link back to the occurence of the footnote in the main text (enabling + requires package `footnotebackref`). - - `book` (defaults to `false`) +- `book` (defaults to `false`) - typeset as book + typeset as book - - `logo-width` (defaults to `35mm`) +- `logo-width` (defaults to `35mm`) - the width of the logo. One needs to specify the width with a (TeX) unit e.g. `100pt` or `35mm`. The following units can be used: + the width of the logo. One needs to specify the width with a (TeX) unit e.g. + `100pt` or `35mm`. The following units can be used: - - `pt`: Point - - `pc`: pica (12 `pt`) - - `in`: inch (72.27 `pt`) - - `bp`: Big point (72 `bp` = 1 `in`) - - `cm`: Centimeter - - `mm`: Millimeter - - `dd`: Didot point - - `cc`: cicero (12 `dd`) - - `sp`: Scaled point (65,536 `sp` = 1 `pt`) - - `ex`: Nomimal x-height - - `em`: Nominal m-width - - `px`: Pixel (only for pdfTeX and LuaTeX) The dimension given to the `\pdfpxdimen` primitive; default value is 1 `bp`, corresponding to a pixel density of 72 dpi. + - `pt`: Point + - `pc`: pica (12 `pt`) + - `in`: inch (72.27 `pt`) + - `bp`: Big point (72 `bp` = 1 `in`) + - `cm`: Centimeter + - `mm`: Millimeter + - `dd`: Didot point + - `cc`: cicero (12 `dd`) + - `sp`: Scaled point (65,536 `sp` = 1 `pt`) + - `ex`: Nomimal x-height + - `em`: Nominal m-width + - `px`: Pixel (only for pdfTeX and LuaTeX) The dimension given to the + `\pdfpxdimen` primitive; default value is 1 `bp`, corresponding to a pixel + density of 72 dpi. - A visual overview of the length units is available at . + A visual overview of the length units is available at + . - - `first-chapter` (defaults to `1`) +- `first-chapter` (defaults to `1`) - if typesetting a book with chapter numbers, specifies the number that will be assigned to the first chapter + if typesetting a book with chapter numbers, specifies the number that will be + assigned to the first chapter - - `float-placement-figure` (defaults to `H`) +- `float-placement-figure` (defaults to `H`) - Reset the default placement specifier for figure environments to the supplied value e.g. `htbp`. The available specifiers are listed below. The first four placement specifiers can be combined. + Reset the default placement specifier for figure environments to the supplied + value e.g. `htbp`. The available specifiers are listed below. The first four + placement specifiers can be combined. - 1. `h`: Place the float *here*, i.e., approximately at the same point it occurs in the source text. - 2. `t`: Place the float at the *top* of the page. - 3. `b`: Place the float at the *bottom* of the page. - 4. `p`: Place the float on the next *page* that will contain only floats like figures and tables. - 5. `H`: Place the float *HERE* (exactly where it occurs in the source text). The `H` specifier is provided by the [float package](https://ctan.org/pkg/float) and may not be used in conjunction with any other placement specifiers. + 1. `h`: Place the float _here_, i.e., approximately at the same point it + occurs in the source text. + 2. `t`: Place the float at the _top_ of the page. + 3. `b`: Place the float at the _bottom_ of the page. + 4. `p`: Place the float on the next _page_ that will contain only floats like + figures and tables. + 5. `H`: Place the float _HERE_ (exactly where it occurs in the source text). + The `H` specifier is provided by the + [float package](https://ctan.org/pkg/float) and may not be used in + conjunction with any other placement specifiers. - - `table-use-row-colors` (defaults to `false`) +- `table-use-row-colors` (defaults to `false`) - enables row colors for tables. The default value is `false` because the coloring extends beyond the edge of the table and there is currently no way to change that. + enables row colors for tables. The default value is `false` because the + coloring extends beyond the edge of the table and there is currently no way to + change that. - - `code-block-font-size` (defaults to `\small`) +- `code-block-font-size` (defaults to `\small`) - 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. + 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 @@ -202,8 +244,7 @@ LaTeX manages addons and additional functionality in so called packages. You might get the following error when compiling a document with the Eisvogel template: - -``` sh +```sh ! LaTeX Error: File `footnotebackref.sty' not found. Type X to quit or to proceed, @@ -236,112 +277,134 @@ unicode-math upquote xecjk xurl zref Install them with the following command: -``` sh +```sh tlmgr 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: +Additional information about the different texlive packages can be found at this +TeX-StackExchange answer: ### MiKTeX -If you don't want to install all missing packages manually, [MiKTeX might be -an alternative](https://miktex.org/howto/miktex-console). +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: +> 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` +> - `Ask me` +> - `Always install missing packages on-the-fly` +> - `Never install missing packages on-the-fly` ## Examples ### Numbered Sections -For PDFs with [numbered sections](http://pandoc.org/MANUAL.html#options-affecting-specific-writers) use the `--number-sections` or `-N` option. +For PDFs with +[numbered sections](http://pandoc.org/MANUAL.html#options-affecting-specific-writers) +use the `--number-sections` or `-N` option. -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --number-sections ``` ### Syntax Highlighting with Listings -You can get syntax highlighting of delimited code blocks by using the LaTeX package listings with the option `--listings`. This example will produce the same syntax highlighting as in the example PDF. +You can get syntax highlighting of delimited code blocks by using the LaTeX +package listings with the option `--listings`. This example will produce the +same syntax highlighting as in the example PDF. -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --listings ``` ### Syntax Highlighting Without Listings -The following examples show [syntax highlighting of delimited code blocks](http://pandoc.org/MANUAL.html#syntax-highlighting) without using listings. To see a list of all the supported highlight styles, type `pandoc --list-highlight-styles`. +The following examples show +[syntax highlighting of delimited code blocks](http://pandoc.org/MANUAL.html#syntax-highlighting) +without using listings. To see a list of all the supported highlight styles, +type `pandoc --list-highlight-styles`. -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --highlight-style pygments ``` -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --highlight-style kate ``` -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --highlight-style espresso ``` -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel --highlight-style tango ``` ### Standalone LaTeX Document -To produce a standalone LaTeX document for compiling with any LaTeX editor use `.tex` as an output file extension. +To produce a standalone LaTeX document for compiling with any LaTeX editor use +`.tex` as an output file extension. -``` bash +```bash pandoc example.md -o example.tex --template eisvogel ``` ### Changing the Document Language -The default language of this template is American English. The `lang` variable identifies the main language of the document, using a code according to [BCP 47](https://tools.ietf.org/html/bcp47) (e.g. `en` or `en-GB`). For an incomplete list of the supported language codes see [the documentation for the hyph-utf8 package (Section 2)](http://mirrors.ctan.org/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdf). The following example changes the language to British English: +The default language of this template is American English. The `lang` variable +identifies the main language of the document, using a code according to +[BCP 47](https://tools.ietf.org/html/bcp47) (e.g. `en` or `en-GB`). For an +incomplete list of the supported language codes see +[the documentation for the hyph-utf8 package (Section 2)](http://mirrors.ctan.org/language/hyph-utf8/doc/generic/hyph-utf8/hyph-utf8.pdf). +The following example changes the language to British English: -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel -V lang=en-GB ``` The following example changes the language to German: -``` bash +```bash pandoc example.md -o example.pdf --template eisvogel -V lang=de ``` ### Typesetting a Book -To typeset a book supply the template variable `-V book` from the command line or via `book: true` in the metadata. +To typeset a book supply the template variable `-V book` from the command line +or via `book: true` in the metadata. -To get the correct chapter headings you need to tell pandoc that it should convert first level headings (indicated by one `#` in markdown) to chapters with the command line option `--top-level-division=chapter`. Chapter numbers start at 1. If you need to change that, specify `first-chapter` in the template variables. +To get the correct chapter headings you need to tell pandoc that it should +convert first level headings (indicated by one `#` in markdown) to chapters with +the command line option `--top-level-division=chapter`. Chapter numbers start +at 1. If you need to change that, specify `first-chapter` in the template +variables. -There will be one blank page before each chapter because the template is two-sided per default. So if you plan to publish your book as a PDF and don’t need a blank page you should add the class option `onesided` which can be done by supplying a template variable `-V classoption=oneside`. +There will be one blank page before each chapter because the template is +two-sided per default. So if you plan to publish your book as a PDF and don’t +need a blank page you should add the class option `onesided` which can be done +by supplying a template variable `-V classoption=oneside`. ### Example Images -| A green title page | A background image on the title page | -| :----------------: | :----------------: | +| A green title page | A background image on the title page | +| :----------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------: | | [![A green title page](examples/title-page-green/preview.png)](examples/title-page-green/document.pdf) | [![A background image on the title page](examples/title-page-background/preview.png)](examples/title-page-background/document.pdf) | -| images and tables | Code blocks styled without listings | -| :---------------: | :---------------: | +| images and tables | Code blocks styled without listings | +| :-----------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------: | | [![images and tables](examples/images-and-tables/preview.png)](examples/images-and-tables/document.pdf) | [![Code blocks styled without listings](examples/code-blocks-without-listings/preview.png)](examples/code-blocks-without-listings/document.pdf) | -| A book | Code blocks styled with listings | -| :----: | :----: | +| A book | Code blocks styled with listings | +| :----------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------: | | [![A book](examples/book/preview.png)](examples/book/document.pdf) | [![Code blocks styled with listings](examples/code-blocks-listings/preview.png)](examples/code-blocks-listings/document.pdf) | -| A background images on all pages | CJK Support (when using XeLaTeX) | -| :----: | :----: | +| A background images on all pages | CJK Support (when using XeLaTeX) | +| :----------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------: | | [![A background images on all pages](examples/page-background/preview.png)](examples/page-background/document.pdf) | [![CJK Support (when using XeLaTeX)](examples/language-japanese/preview.png)](examples/language-japanese/document.pdf) | ## Common Errors / Issues @@ -351,14 +414,14 @@ Eisvogel template. ### LaTeX Errors `Missing endcsname inserted` or `File x not found` when using `titlepage-background`, `logo`, or `titlepage-logo`. -``` latex +```latex Error producing PDF. ! Missing endcsname inserted. protect ``` -``` latex +```latex Error producing PDF. ! Package pdftex.def Error: File `logo\T1\textunderscoreimage.pdf' not fou nd: using draft setting. @@ -374,20 +437,20 @@ A quick fix would be to replace all underscores in the filename of the image with a hyphen (`-`). If the background image is specified in your YAML front matter like so, -``` yaml +```yaml titlepage-background: "background_image.pdf" ``` you can advise pandoc to interpret this as LaTeX and include it in the document without parsing. -``` yaml +```yaml titlepage-background: "`background_image.pdf`{=latex}" ``` The same fix can be used for the logo image as well: -``` yaml +```yaml logo: "`logo_image.pdf`{=latex}" ``` @@ -411,11 +474,13 @@ l.7 < ``` This error indicates that you try to use some text file for conversion that is -not the Eisvogel template. Please download the [latest Eisvogel template](https://github.com/Wandmalfarbe/pandoc-latex-template/releases/latest) from the releases page and start the conversion again. +not the Eisvogel template. Please download the +[latest Eisvogel template](https://github.com/Wandmalfarbe/pandoc-latex-template/releases/latest) +from the releases page and start the conversion again. ### LaTeX Error `auto expansion is only possible with scalable fonts` -``` latex +```latex Error producing PDF. ! pdfTeX error (font expansion): auto expansion is only possible with scalable fonts. @@ -427,7 +492,10 @@ l.643 \begin{lstlisting} This error likely occurs on Windows with MiKTeX installed. StackOverflow user [Krebto provided the following fix](https://tex.stackexchange.com/a/392467): -> To solve the problem navigate to `C:\Program Files\MiKTeX 2.9\miktex\bin\x64` and run `updmap.exe`. The program may seem as it hangs for a while, but its probably because it tries to update the whole font tree. This solved the problem for me. After re-compiling everything should work fine. +> To solve the problem navigate to `C:\Program Files\MiKTeX 2.9\miktex\bin\x64` +> and run `updmap.exe`. The program may seem as it hangs for a while, but its +> probably because it tries to update the whole font tree. This solved the +> problem for me. After re-compiling everything should work fine. Corresponding issue: @@ -435,7 +503,7 @@ Corresponding issue: ### LaTeX Error `cannot find image file` -``` latex +```latex Error producing PDF. ! error: (file "/tmp/tex2pdf.-be734e802ef6d0c3/""fdcfc29edcf252186f1b0a52f18f50 43abaeb2d0".png) (pdf backend): cannot find image file '"/tmp/tex2pdf.-be734e802 @@ -457,8 +525,11 @@ Corresponding issues: ## Credits - - This template includes code for styling block quotations from [pandoc-letter](https://github.com/aaronwolen/pandoc-letter) by [Aaron Wolen](https://github.com/aaronwolen). +- This template includes code for styling block quotations from + [pandoc-letter](https://github.com/aaronwolen/pandoc-letter) by + [Aaron Wolen](https://github.com/aaronwolen). ## License -This project is open source licensed under the BSD 3-Clause License. Please see the [LICENSE file](LICENSE) for more information. +This project is open source licensed under the BSD 3-Clause License. Please see +the [LICENSE file](LICENSE) for more information. From 9e5a131bb10cfabd175836ba2b2e8eb58ce46326 Mon Sep 17 00:00:00 2001 From: Altair-Bueno <67512202+Altair-Bueno@users.noreply.github.com> Date: Mon, 23 Jan 2023 14:12:41 +0100 Subject: [PATCH 3/3] fix: Replace extension .tex with .latex --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9e8a9b4..a37f265 100644 --- a/README.md +++ b/README.md @@ -26,14 +26,14 @@ science. The template is compatible with pandoc 3. ```sh PANDOC_HOME="$(pandoc --version | sed -n 's|^User data.*: \(.*\)$|\1|gp')" mkdir -p "$PANDOC_HOME/templates" -curl -o "$PANDOC_HOME/templates/eisvogel.tex" "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" +curl -o "$PANDOC_HOME/templates/eisvogel.latex" "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" ``` ### Windows (Powershell) ```powershell mkdir "$home\AppData\Roaming\pandoc\templates" -Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" -OutFile "$home\AppData\Roaming\pandoc\templates\eisvogel.tex" +Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Wandmalfarbe/pandoc-latex-template/v2.2.0/eisvogel.tex" -OutFile "$home\AppData\Roaming\pandoc\templates\eisvogel.latex" ``` ## Usage