Changes in version 0.15.0.9000 Changes in version 0.15.0 (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). Changes in version 0.14 - Patch release to fix some CRAN notes about Rd file changes. Changes in version 0.13 (2023-06-22) - Fix issue with margin content when using Pandoc 2.19 and later by adding --wrap preserve by default (thanks, @TomBen, #115). Changes in version 0.12 (2022-01-27) - Fix footnotes as sidenotes issue with Pandoc 2.15 and later (thanks, @MCMaurer, #108). Changes in version 0.11 (2021-12-19) - 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). Changes in version 0.10 (2021-05-17) - Fix an issue with the wrong references placed in margins when link-citations: yes is used with Pandoc 2.11+ (#92) Changes in version 0.9 (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. Changes in version 0.8 (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) Changes in version 0.7 (2020-09-25) - Add the cslreferences environment in the template (thanks, @jonathan-g, #80). Changes in version 0.6 (2020-05-08) 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). Changes in version 0.5 (2019-05-12) BUG FIXES - Make references generated by Pandoc >= 2.7 work in the margin (thanks, @dfeng, #64). Changes in version 0.4 (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). Changes in version 0.3 (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 - 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). Changes in version 0.2 (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 Changes in version 0.1 (2016-01-20) NEW FEATURES - added three output formats for R Markdown: tufte_html(), tufte_handout(), and tufte_book()