documented latest changes
14 KiB
Changelog
All notable changes to this project are documented in this file. On the releases page you can see all released versions of the Eisvogel template and download the latest version.
[Unreleased]
[2024-05-20]
Added
- Custom colors for headings, captions, blockquotes, and listings.
- Custom commands
\customheading
and\customcaption
for flexible styling. - Support for custom background images on title pages and all pages.
- Flexible geometry settings for title page layout.
- Enhanced handling of paragraph and list spacing.
- New variables for header and footer customization: 'header-left','header-center', 'header-right',
footer-center
,footer-left
, andfooter-right
. - Customizable copyright text (default usage for footer-left) through a new
\copyrighttext
macro.
Changed
- Updated README.md to include detailed instructions on using and customizing the template.
- Integrated custom styling options directly into the template for better user experience.
- Enhanced flexibility for setting date values via the
date
variable. - Default behavior for
footer-right
now includes the total page count (\thepage{} / \pageref{LastPage}
).
Fixed
- Minor formatting issues and improved compatibility with various LaTeX distributions.
- Corrected handling of page numbers in the footer to prevent duplication.
2.4.2 - 2023-11-25
- Merge changes from the pandoc default LaTeX template from version 3.1.9 (f7d8b62).
- Merge changes from the pandoc default LaTeX template from version 3.1.8 (2d42e04) (#364, David Mehren).
- Add fix for
table-use-row-colors
which previously stopped working (#301, Chris Fenner).
2.4.1 - 2023-09-06
- Merge changes from the pandoc default LaTeX template from version 3.1.7 (as of 2023-08-31, 8a5b381).
2.4.0 - 2023-04-17
- Merge changes from the pandoc default LaTeX template (as of 2023-03-29, a5159c2).
- Fix placement of float figures (tables, images, etc.). Float figures should now appear
exactly where they are included. The option
float-placement-figure
is also restored. - Remove Travis CI build
- Fix wrong font sizes on the title page. The problem went away on its own, likely because of an updated LaTeX package.
2.3.0 - 2023-03-13
The Eisvogel template is now available in the Docker image pandoc/extra! For more Information refer to the documentation in the Readme or the documentation on docker hub.
- Merge changes from the pandoc default LaTeX template (as of 2023-03-10, 9b04036).
- Add
CJKsansfont
andCJKmonofont
for XeLaTeX.CJKsansfont
andCJKmonofont
will be set for XeLaTeX only ifCJKmainfont
is also provided (#328, Yudong Jin).
- Add
- Add documentation in the README on how to use the
pandoc/extra
docker image (#319, damien clochard). - Fix wrong literate of characters
è
andÈ
in listings. The characterè
was wrongly converted toé
andÈ
toÉ
(#324, damien clochard).
2.2.0 - 2023-01-22
- Merge changes from the pandoc default LaTeX template (as of 2023-01-13, 909ced5).
- This change adds support for pandoc 3.
2.1.0 - 2022-12-04
- Merge changes from the pandoc default LaTeX template (as of 2022-11-19, 144bf90ab9).
- Restructure the examples. Any example folder now contains at least the following files:
document.md
: the Markdown document to convert to a PDFdocument.pdf
: the resulting PDF documentbuild.sh
: a shell script to convert the documentdocument.md
with pandoc. This script might call pandoc with additional arguments (e.g. filters or template variables).preview.png
: a PNG image of the resulting PDF document intended as a quick preview
- Use the Koma-Script package
scrlayer-scrpage
for the headers and footers instead of the packagefancyhdr
(#174, khaveesh).- Fix a header and footer bug when using
oneside
introduced by the migration toscrlayer-scrpage
(#248, ret2src). - Restore pagestyle
plain
for chapters (#275). Headers and footers are removed from chapter pages, as it has been before the migration toscrlayer-scrpage
.
- Fix a header and footer bug when using
- Correct the examples and documentation (#239, mprobson), (#261, supcik).
- Exclude title page from page count (#230, shmalebx9).
- Make code-block-font-size not affect inline listings (#229, LudvigHz).
- Rename the Eisvogel template variable
logo
totitlepage-logo
.logo
is already used by beamer, and one might want to use both formats (beamer and latex) without the logo appearing as a background image on beamer slides.
- Add an example for a table of contents (#283).
2.0.0 - 2021-01-31
This release includes breaking changes.
-
Merged changes from the pandoc default LaTeX template.
-
Fix broken travis build by modifying the
--resource-path
When specifying the resource path via
--resource-path
the template will be searched there since pandoc 2.9.2.1. To fix the broken travis build (Could not find data file templates/eisvogel.latex
) the current working directory.
is included in the resource path for pandoc to find the template again.For more information visit the pandoc issue https://github.com/jgm/pandoc/issues/6618.
-
Rename template to
eisvogel.latex
after release (#182). There is no need for renaming the template file after the download.This is a breaking change because there will be no file
eisvogel.latex
in the released artifacts anymore. -
Option
logo-width
has no hard coded unitpt
anymore (#221).The width of the logo can be specified with various units e.g.
pt
,in
,mm
.This is a breaking change because a previously specified
logo-width
without a unit needs a unit now. If there is no unit LaTeX will emit an errorIllegal unit of measure (pt inserted)
and no document will be created.The default value for
logo-width
has also changed from100pt
to35mm
.
1.6.1 - 2020-11-26
- Merged changes from the pandoc default LaTeX template (https://github.com/jgm/pandoc/blob/master/data/templates/default.latex).
- This merge should fix a compilation error when using tables because of the missing
calc
package.
- This merge should fix a compilation error when using tables because of the missing
1.6.0 - 2020-11-02
- Merged changes from the pandoc default LaTeX template (https://github.com/jgm/pandoc/blob/master/data/templates/default.latex).
- This merge should fix problems related to using CSL bibliographies (#201).
- Added documentation about common errors to the readme.
- The command
\thedate
can be used in the source document or metadata fields (#163).
1.5.0 - 2020-06-14
- Create release assets with and without version number for easy access (#175).
- Added example
boxes-with-pandoc-latex-environment-and-tcolorbox
This example shows how to render beautiful boxes with the filterpandoc-latex-environment
and the packagetcolorbox
. - Fix LaTeX installation problems on Travis by installing everything manually.
- Fixed a couple of LuaLaTeX warnings (#169, khaveesh)
- Mention required LaTeX package for option
footnotes-disable-backlinks
in the Readme (#148, salim-b). - Remove
graphicx
dependency (#149, noraj). Please see https://github.com/jgm/pandoc/issues/5848 for the full discussion.
1.4.0 - 2020-02-02
- Added support for a page background (#138, evildead).
- The variable
page-background
specifies the path to a background image for any page. The background image is scaled to cover the entire page. - The variable
page-background-opacity
specifies the background image opacity.
- The variable
- Added an example on how to generate admonition boxes (#115). The example demonstrates the use of the filter
pandoc-latex-environments
to create custom admonition boxes with theawesomebox
package. - Added an example on how to compile Chinese documents (#140).
- Added a section on required LaTeX packages to the readme (#141). The section explains how to install the required packages with TeX Live and MiKtEX.
- Corrected the command
tlmgr
inREADME.md
(#143).
1.3.1 - 2019-12-08
- Fixed wrong margins when not using the titlepage option (#135).
1.3.0 - 2019-10-26
- Clarified the location of the pandoc templates directory in the readme.
- Added missing
$endif$
that caused a compilation failure (#125, 0az). - Merged changes from the pandoc default LaTeX template.
- Fixed a bug where specifying a font via
mainfont
when using pdfLaTeX would not apply the default font Source Sans Pro. - Improve formatting of footnotes with the variables
footnotes-pretty
andfootnotes-disable-backlinks
(#107, salim-b). - Added the variable
code-block-font-size
to change the font size for code blocks via the supplied LaTeX command (#123, #17). - Improve Japanese dummy text (#86, JKPOKE)
- Added an example on how to change header and footer (#109).
- Added example backgrounds to the titlepage example.
- Added support for background images on the title page with the variable
titlepage-background
(#31, #41). - Disabled striped tables per default. Enable them with the variable
table-use-row-colors: true
(#29). - Updated listings definition for Java which is the default language when using listings. This means that more keywords such as
var
from Java 10 are highlighted. - Added support for additional keyword colors when using
listings
for syntax highlighting. The support depends on the used language. Some languages likemotorola68k
,x86masm
,inform
,llvm
,lua
,metapost
,mupad
,ocl
,python
,verrilog
,basic
,cil
,fortran
andhansl
will have additional colors for some keywords. - Fixed: Long lines in code blocks (verbatim environment) wrap automatically (#2).
1.2.4 - 2019-06-16
- Fixed: The template now compiles with the output format
beamer
(#99). The styling for the generated slides is currently not customized.
1.2.3 - 2019-06-12
- Fixed: Code blocks were too close to the text above.
- Fixed: The default float placement of figures can be changed with the variable
float-placement-figure
. - Changed: Merged changes from the pandoc default LaTeX template.
- Added: A changelog is available as
CHANGELOG.md
. - Changed: Updated installation instructions in the README with new XDG support (#89, Andrew Zhou).
1.2.2 - 2019-04-09
- Merged changes from the pandoc default LaTeX template.
- Fixed: Support custom values for
secnumdepth
andtoc-depth
(#87, Juan Grigera).
1.2.1 - 2019-03-10
- Removed double inclusion of package
xcolor
and cleaned up some comments. - Removed unused
\captionsetup[longtable]
. - Moved listing colors to the listings block in the template.
- Changed the top and bottom spacing of listings.
- Merged changes from the pandoc default LaTeX template.
- Changed the release script to also create a
tar.gz
archive.
1.2.0 - 2019-03-03
- Fixed curly quotes in code listings under XeTeX engine (#79, Andrew Hodgkinson).
- Merged changes from the pandoc default LaTeX template
default.latex
. - Updated the installation instructions in the README and moved the release script to the
tools
folder.
1.1.0 - 2019-02-17
- Defined a default pagestyle to make it easier to change the pagestyle on certain pages or define a custom one (#77).
- Add support for
first-chapter
variable in case it's desirable for a book not to begin with chapter 1 (#74, umanovskis).
1.0.0 - 2018-12-07
- First release of the template as a ZIP file with the examples.