tidy up docs for blocks, ensure that block icons are displayed

Author: petercorke

docs/source/blocks.rst

@@ -4,9 +4,8 @@ bdsim blocks
 .. image:: https://raw.githubusercontent.com/petercorke/bdsim/master/figs/[email protected]
     :width: 400
 
-A set of block definitions that provide robotic capability to `bdsim <https://github.com/petercorke/bdsim>`_.
-
-.. warning:: This capability is still experimental
+A set of block definitions that add robotic capability to the `bdsim <https://github.com/petercorke/bdsim>`_
+block diagram simulation environment.
 
 .. toctree::
    :maxdepth: 2

docs/source/exts/blockname.py

@@ -11,7 +11,27 @@ def block_name(name, rawtext, text, lineno, inliner, options={}, content=[]):
     # inliner: The docutils.parsers.rst.states.Inliner object that called role_fn. It contains the several attributes useful for error reporting and document tree access.
     # options: A dictionary of directive options for customization (from the "role" directive), to be interpreted by the role function. Used for additional attributes for the generated elements and other functionality.
     # content: A list of strings, the directive content for customization (from the "role" directive). To be interpreted by the role function.
-    html_node = nodes.raw(text='<p style="border:10px; background-color:#000000; padding: 1em; color: white; font-size: 30px; font-weight: bold;">' + text + '</p>', format='html')
+
+    html = """
+    <table width="100%">
+    	<col style="width:80%">
+	    <col style="width:20%">
+    <tr>
+    <td>
+    <p style="border:10px; background-color:#000000; padding: 1em; color: white; font-size: 30px; font-weight: bold;">
+    {0}
+    </p>
+    </td>
+    <td>
+    <img src="{1}" width=80 height=80>
+    </td>
+    </tr>
+    </table>
+    """
+
+    # this is the path to the icons within the github repo
+    path =  "https://github.com/petercorke/robotics-toolbox-python/raw/master/roboticstoolbox/blocks/Icons/" + text.lower() + ".png"
+    html_node = nodes.raw(text=html.format(text, path), format='html')
     return [html_node], []
 
 
@@ -21,4 +41,4 @@ def setup(app):
         'version': '0.1',
         'parallel_read_safe': True,
         'parallel_write_safe': True,
-    }
+    }