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).
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).
--wrap preserve by default (thanks, @TomBen, #115).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).
link-citations: yes is used with Pandoc 2.11+ (#92)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.
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)
cslreferences environment in the template
(thanks, @jonathan-g, #80).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).
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).
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():
et-book fonts.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).
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).
ctex: yes in the YAML metadatathe 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_html(), tufte_handout(), and
tufte_book()