smalldocs now gives a warning for each key of the config that it does not read. It checks the keys
inside the navbar, the sidebar and a listing too. In front matter, it gives a warning only for an option of Quarto
that it does not read, so your own keys are fine. The options that run code, such as jupyter and
freeze, give a warning that says smalldocs runs no code. With smalldocs render --strict, a warning
makes the exit code 1. See
Options that smalldocs does not read.
A site that uses none of the new options builds as before.
Markdown
- Table captions,
: Caption {#tbl-a}, andtbl-cap-location. - Content for some builds only, with
.content-visibleand.content-hidden. - The shortcodes
kbdandvideo. - Tabsets with the same
groupswitch together. - Code options:
code-line-numbers,code-overflow, andcode-foldwithcode-summary. - Subscripts,
H~2~O, and superscripts,x^2^. - Lists numbered with letters or roman numerals.
fig-align,fig-alt, andlayout-ncol,layout-nrowandlayouton a div.callout-appearanceandcallout-iconfor each callout of a page.anchor-sectionsandnumber-depth.
See Writing pages.
Page and site
- The table of contents at the left, in the body or in two places, with
toc-locationandtoc-expand. - Fonts, colours and the width of the text from options, such as
mainfontandmax-width. See Themes. - More options for the navbar, the sidebar, the footer and the search box, and attributes such as
targeton each link. - A logo for the light mode and one for the dark mode.
google-analytics,twitter-card,keywords,title-prefix,licenseandcopyright.back-to-top-navigation,other-links,code-links,link-external-iconandsmooth-scroll.- Drafts, with
draft-modeanddrafts. - Comments on each page, with giscus, utterances or Hypothesis.
See The configuration.
Notebook cells
A code cell of a notebook can set fig-cap, fig-alt, fig-align, tbl-cap, column, layout-ncol
and the code options in its #| lines. See Notebooks.