tufte 0.15.0

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

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

tufte 0.12

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

tufte 0.11

• Fix an issue with Pandoc’s table support in tufte_handout() (thanks, @chrisjake, #104).

• Fix an issue with Pandoc’s citation processing by updating latex template (thanks, @rmcd1024, #106).

tufte 0.10

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

tufte 0.9

• 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

• 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

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

tufte 0.6

NEW FEATURES

• Arbitrary full width content is supported now; see https://rstudio.github.io/tufte/#arbitrary-full-width-content for the syntax (thanks, @mlovelace @josiekre, #33).

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

BUG FIXES

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

tufte 0.4

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

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

• When link-citations: no in YAML, citations should not be moved into the page margin in the HTML output (https://stackoverflow.com/q/39053097/559676).

• Horizontal lines could bisect margin notes and footnotes (thanks, @ajdamico, #32).

• Compatibility issues with Pandoc 2.0 (thanks, @peetCreative, #51).

tufte 0.2

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

NEW FEATURES

• added three output formats for R Markdown: tufte_html(), tufte_handout(), and tufte_book()