practical

Directives for use in practical exercises.

Directives

.. practical::

Directive for practical exercise.

.. practical::

   Some instructions here.

   .. practical::

      Here is an exercise to complete

Practical

Some instructions here.

Practical

Here is an exercise to complete

.. practical-extension::

Directive for practical exercise extensions.

.. practical-extension::

   Here is a follow-on exercise

Practical Extension

Here is a follow-on exercise

.. spoiler::

Directive for content which is hidden by default.

.. spoiler:: Spoiled warning

   Hidden text which will display with class ``warning``.

Spoiled

Hidden text which will display with class warning.

Arguments
title

Title to give the admonition

class

The admonition class to give this element (effects display) i.e. one of:

  • hint

  • note

  • warning

  • error

.. tutorial::

Provides a formatted admonition to make a reader aware of a tutorial related to the content they are currently reading.

For example if we had a tutorial like this:

.. _example-tutorial:

Example Tutorial
----------------

Meh.

We could reference it like this:

.. tutorial:: example-tutorial

Related Tutorial

Directives