News

What changed in smalldocs, newest first.

smalldocs 0.2.0

Themes from git repositories, and notes in the margin

release

A site can now use a theme from a git repository. smalldocs add org/repo copies the theme into the folder _extensions/ of the project, and theme: <name> uses it. The same…

smalldocs 0.3.0

More options, and a warning for each option that is not read

release

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…

smalldocs 0.3.1

Double dollars in a sentence are display maths

release

Maths between double dollars inside a sentence, such as Text $$x = 1$$ more text., is now display maths on a line of its own, as in Quarto. Before, smalldocs drew it as…

smalldocs 0.1.5

Defaults in the docs, and fewer wrong links

release

Linkify now links a name in backticks only when it looks like code. Calls such as inventory(), dotted names such as Site.build, names with an underscore and classes such as…

smalldocs 0.1.4

Diffs in red and green, and whole code blocks

release

A diff block now shows each removed line in red and each added line in green, as on GitHub. A hunk header, the line that starts with @@, is grey. The text of the block stays…

smalldocs 0.1

The first release

release

The first release of smalldocs builds websites from Quarto projects. It makes these parts of a site:

smalldocs 0.1.3

A config file of its own, and a better API reference

release

smalldocs now has a config file of its own, _smalldocs.yml. In it, the options of a page, such as theme and toc, are at the top level. The options of smalldocs, such as…

Why smalldocs exists

design

release

Quarto makes PDF files, books, slides and websites, and it runs code. To do so, it installs Pandoc, Deno, Sass, esbuild and Typst, which take more than 600 MB. Many projects…