Changeset a42b091 in sasmodels for doc

Timestamp:

Mar 30, 2019 2:23:16 AM (6 years ago)

Author:

Paul Kienzle <pkienzle@…>

Branches:

master

Children:

d57b06c

Parents:

c1e44e5

Message:

suggest a way to do syntax highlighting

File:

• doc/genmodel.py (modified) (1 diff)

doc/genmodel.py

@@ -157 +157 @@
     downloads = [":download:`%s <src/%s>`"%(path, path) for path in sources]
 
+    # Could do syntax highlighting on the model files by creating a rst file
+    # beside each source file named containing source file with
+    #
+    #    src/path.rst:
+    #
+    #    .. {{ path.replace('/','_') }}:
+    #
+    #    .. literalinclude:: {{ src/path }}
+    #        :language: {{ "python" if path.endswith('.py') else "c" }}
+    #        :linenos:
+    #
+    # and link to it using
+    #
+    #     colors = [":ref:`%s`"%(path.replace('/','_')) for path in sources]
+    #
+    # Probably need to dump all the rst files into an index.rst to build them.
+
     # Link to github repo (either the tagged sasmodels version or master)
     url = "https://github.com/SasView/sasmodels/blob/v%s"%sasmodels.__version__