Better handling for explain snippet in docs output.

sandbox/cli.py

@@ -216,6 +216,10 @@ This command is used to parse configuration files and output the commands.
                 continue
 
             if snippet.name == "explain":
+                if snippet.header:
+                    output.append("## %s" % snippet.name.title())
+                    output.append("")
+
                 output.append(snippet.args[0])
                 output.append("")
             elif snippet.name == "screenshot":

scripttease/data/inventory/radicale/steps.ini

@@ -1,12 +1,23 @@
+[introduction]
+explain: "In this tutorial, we are going to install Radicale."
+header: yes
+
 [make sure a maintenance root exists]
 mkdir: /var/www/maint/www
 group: www-data
 owner: www-data
 recursive: yes
 
+[about maintenance root]
+explain: "The maintenance root is used to register an SSL certificate (below) before the site is completed and (later) after the site is live."
+
 [install radicale]
 pip3: radicale
 
+;[install radicale screenshot]
+;screenshot: images/install.png
+;caption: Radical Installed
+
 [create radicale configuration directory]
 mkdir: /etc/radicale/config
 owner: radicale