Welcome | Get started | Dive | Contribute | Topics | Reference | Changes | More

Shared Sphinx resources

The shared Sphinx resources is a folder with files we use when building our document trees. The folder is shared over several repositories.

/shared

The /shared folder of a doctree.

tested.rst

The tested.rst file is used by adding the following line before the startup block:

.. include:: /../docs/shared/include/tested.rst
defs.rst

Defines a selection of icons for inline use.

To use these definitions, add the following line to the top of your document:

.. include:: /../docs/shared/include/defs.rst

A doctree that uses Shared Sphinx resources should add the following to its conf.py file:

exclude_patterns = ['.build/*', 'shared/include/*']

Here is a list of PrimeIcon icons that are available in Lino documentation trees:

  • bars button bars

  • bell button bell

  • copy button copy

  • eject eject

  • envelope button envelope

  • external link external-link

  • filter button filter

  • home button home

  • pencil button pencil

  • plus-circle button plus-circle

  • plus-circle button plus-circle

  • refresh button refresh

  • save button save

  • sliders-h sliders-h

  • times button times

  • close button times-circle

  • trash button trash

  • user button user