update docs/extensions/fancy_include.py with git_cast_file2repos.py

RI-imaging · Nov 16, 2017 · 1f6a60c · 1f6a60c
1 parent 79027ac
commit 1f6a60c
Showing 1 changed file with 7 additions and 2 deletions.
diff --git a/docs/extensions/fancy_include.py b/docs/extensions/fancy_include.py
@@ -47,14 +47,19 @@ def run(self):
         with io.open(full_path, "r") as myfile:
             text = myfile.read()
 
+        # add reference
+        name = op.basename(full_path)[:-3]
+        rst = [".. _example_{}:".format(name),
+               "",
+               ]
+
+        # add docstring
         source = text.split('"""')
         doc = source[1].split("\n")
         doc.insert(1, "~" * len(doc[0]))  # make title heading
 
         code = source[2].split("\n")
 
-        # documentation
-        rst = []
         for line in doc:
             rst.append(line)