Changing the creation of the tags linking to be document cross-refere…

…nces, which seems to care less about the doc structure under which it's built.

openmdao/docs/_exts/tags.py

@@ -55,11 +55,9 @@ def run(self):
         links = []
 
         for tagg in taggs:
-            # Create rst hyperlinks of format `Python <http://www.python.org/>`_.
-            import os
-            cwd = os.getcwd()
-            html_dir = os.path.join(cwd, "_build", "html")
-            link = "`" + tagg + " <" + html_dir + os.sep + "tags" + os.sep + tagg + ".html>`_ "
+            # Create Sphinx doc refs of format :ref:`Tagname<Tagname>`
+            link = ":ref:`" + tagg + "<" + tagg + ">`"
+            #link = "`" + tagg + " <http://openmdao.org/twodocs/versions/latest/tags/" + tagg + ".html>`_"
             links.append(link)
         # Put links back in a single comma-separated string together
         linkjoin = ", ".join(links)

openmdao/docs/_utils/preprocess_tags.py

@@ -52,15 +52,18 @@ def make_tagfiles(docdirs, tagdir):
 
                         # If the tagfile doesn't exist, let's put in a header
                         if not os.path.exists(filepath):
+                            tagfilelabel = ".. _" + tag + ": \n"
                             tagfileheader = """
 =========================
 %s
 =========================
   .. toctree::
 """ % tag
 
+
                             # Write the header for this tag's file.
                             with open(filepath, 'a') as tagfile:
+                                tagfile.write(tagfilelabel)
                                 tagfile.write(tagfileheader)
                         # Write a link into an existing tagfile.
                         with open(filepath, 'a') as tagfile:
@@ -71,9 +74,8 @@ def make_tagindex(tagdir):
     # Once all the files exist, create a simple index.rst file
     indexfile = tagdir + "/index.rst"
 
-    for filepath, dirnames, filenames in os.walk(tagdir):
-        with open(indexfile, 'a') as index:
-            index.write("""
+    with open(indexfile, 'a') as index:
+        index.write("""
 :orphan:
 
 ================

openmdao/docs/examples/index.rst

@@ -1,4 +1,4 @@
-.. _Examples:
+.. _OpenMDAO_Examples:
 
 ********
 Examples

openmdao/docs/feature_reference/core_features/working_with_derivatives/specifying_partials.rst

@@ -43,5 +43,4 @@ Here are several examples of how you can specify derivative values for different
     openmdao.jacobians.tests.test_jacobian_features.SimpleCompConst
 
 
-.. tags:: Partial Derivatives
-
+.. tags:: PartialDerivatives