Sphinx extensions

These are in rstgen.sphinxconf.

Commands

.. command::

Define a “command”, i.e. a suite of words to be typed at a command line.

:cmd:

Refer to a command defined elsewhere.

command role.

Don’t mix up .. command:: and :cmd: with Sphinx’s built-in .. program::, .. option::, :command: and :option::

Blogging

.. blogger_year::

Inserts a calendar for the given year with the twelve months. The individual days are linked to their respective daily entry.

.. blogger_index::

Inserts a main index page for this blog, one entry for every year.

The complextable directive

.. complextable::

Create tables with complex cell content.

Usage example (imagine that A1…B2 are complex blocks of text that can contain other tables, images, code snippets, …):

.. complextable::

  A1
  <NEXTCELL>
  A2
  <NEXTROW>
  B1
  <NEXTCELL>
  B2

Result:

A1

A2

B1

B2

The cards directive (deprecated)

.. cards::

Render the content in individual “cards” that are positioned side by side on large screens and after each other on small screens.

Deprecated. We recommend using sphinx-design instead of this.

Individual cards may not contain titles.

Usage example (imagine that A1…B2 are complex blocks of text that can contain other tables, images, code snippets, …):

.. cards::

  A1
  <NEXTCARD>
  A2
  <NEXTROW>
  B1
  <NEXTCARD>
  B2

Result (requires a theme that uses bootstrap):

A1

A2

B1

B2

Miscellaneous