Skip to contents

Changelog

Source: NEWS.md

tufte 0.15.0

CRAN release: 2026-05-21

New features

  • tufte_handout() and tufte_book() gain a margin_fig_pos argument for controlling the vertical offset of margin figures globally. Set in YAML (margin_fig_pos: "0cm"), via knitr::opts_chunk$set(), or per-chunk. Per-chunk fig.pos still overrides it, and a global opts_chunk$set(fig.pos = ...) (intended for regular figures) no longer leaks onto margin chunks (#62).

  • New tufte_handout2(), tufte_book2(), and tufte_html2() wrap the corresponding bookdown output formats, enabling text references (ref:label) in figure and table captions and cross-references. Markdown links in fig.cap are now converted to LaTeX. Requires the bookdown package (suggested) (#60).

Minor improvements and fixes

  • fig.margin = TRUE (and fig.fullwidth = TRUE) are now honoured in HTML output when fig.align is set. The margin/fullwidth wrapper was previously dropped because the figure hook missed the style attribute added by knitr (#54).

  • The obsolete usenames option is no longer passed to the xcolor LaTeX package, suppressing a warning on TeX Live 2022+ (#127).

  • quote_footer() now renders an em-dash consistently across tufte and non-tufte outputs when the caller writes a leading "---". For non-tufte HTML the leading "---" is stripped to avoid doubling with Bootstrap’s ::before em-dash; for tufte HTML an em-dash glyph is inserted in the markup; for LaTeX the leading "---" is preserved so pandoc’s smart-punctuation extension converts it (#73).

  • quote_footer() now right-aligns the footer in non-tufte HTML output (e.g. html_document, including bslib Bootstrap 4 and 5 themes) and tags it with class="blockquote-footer" so Bootstrap 4/5 class-based styling applies. quote_footer() no longer warns when called outside a pandoc context, so it can be used unconditionally in inline R expressions (#73).

  • tufte_handout() and tufte_book() no longer place pandoc’s \citep and \citet natbib citations inline when citation_package: natbib is used. The patched tufte-common.def routes both through the margin sidenote machinery; \citet keeps its textual “Author (Year)” form inline while adding the full reference to the margin. Suppress-author citations ([-@key], emitted as \citeyearpar) are intentionally left inline (thanks, @jlorieau, #48).

  • tufte_handout() and tufte_book() use fig_crop = "auto" by default (matching rmarkdown::pdf_document()), avoiding a spurious warning about pdfcrop when crop tools are not installed (thanks, @sandhya9215, #124).

  • tufte_html() no longer drops nocite references when link-citations: yes. References without in-text citations are preserved in the bibliography section at the bottom of the document (#35).

tufte 0.14

  • Patch release to fix some CRAN notes about Rd file changes.

tufte 0.13

CRAN release: 2023-06-22

  • Fix issue with margin content when using Pandoc 2.19 and later by adding --wrap preserve by default (thanks, @TomBen, #115).

tufte 0.12

CRAN release: 2022-01-27

  • Fix footnotes as sidenotes issue with Pandoc 2.15 and later (thanks, @MCMaurer, #108).

tufte 0.11

CRAN release: 2021-12-19

tufte 0.10

CRAN release: 2021-05-17

  • Fix an issue with the wrong references placed in margins when link-citations: yes is used with Pandoc 2.11+ (#92)

tufte 0.9

CRAN release: 2020-12-02

  • Add the missing CSLReferences environment in the template required by Pandoc 2.11+ and its new citeproc (#89)

  • tufte_handout() now uses default tidy knitr option, which is FALSE. It can be changed with knitr::opts_chunk$set(tidy = TRUE) and requires in that case the formatR package.

tufte 0.8

CRAN release: 2020-10-30

  • References are now moved in the margin correctly with Pandoc 2.11 (#86).

  • Add a runningheader variable in the template for tufte_handout() and tufte_book() to have a different running header than the title if provided. (#82)

tufte 0.7

CRAN release: 2020-09-25

  • Add the cslreferences environment in the template (thanks, @jonathan-g, #80).

tufte 0.6

CRAN release: 2020-05-08

NEW FEATURES

BUG FIXES

  • Footnotes no longer work with Pandoc >= 2.7 (thanks, @grimbough, #76).

  • Margin references do not work with Pandoc 2.9.2.1 (thanks, @Selbosh, #78).

tufte 0.5

CRAN release: 2019-05-12

BUG FIXES

  • Make references generated by Pandoc >= 2.7 work in the margin (thanks, @dfeng, #64).

tufte 0.4

CRAN release: 2018-07-15

BUG FIXES

  • Should use the Pandoc argument --top-level-division=chapter instead of --chapters for tufte_book() (thanks, @jtth, #52).

  • Processing of multi-line footnotes fails with the Pandoc option --wrap preserve (thanks, @aoles, #57 #58).

tufte 0.3

CRAN release: 2018-01-24

NEW FEATURES

  • It is possible to select a subset of some features of the default Tufte style (tufte-css) via the tufte_features argument of tufte_html():

    • Disable the et-book fonts.
    • Remove the default light-yellow background color.
    • Use italics for document headers or not.

  • A new variant of the Tufte style, envisioned, is added to tufte_html(). You can use tufte_html(tufte_variant = 'envisioned') to enable this style. The major difference with the default Tufte style is: the font family is Roboto Condensed, the background color is #fefefe, and the text color is #222 (thanks, @eddelbuettel, #21).

  • You can choose whether references from citations should be placed in the document margins or at the bottom using the margin_references argument of tufte_html() (thanks, @stefanfritsch, #49).

BUG FIXES

tufte 0.2

CRAN release: 2016-02-07

NEW FEATURES

  • it is possible to generate PDF output using the ctex package for R Markdown documents in Chinese; you just need to specify ctex: yes in the YAML metadata

BUG FIXES

  • the default LaTeX template for tufte_handout() may not work when the LaTeX package soul is installed, or ifxetex/xltxtra are not installed

  • the number_sections option did not work for LaTeX output

tufte 0.1

CRAN release: 2016-01-20

NEW FEATURES