X-Git-Url: http://gitweb.michael.orlitzky.com/?p=dunshire.git;a=blobdiff_plain;f=doc%2Fsource%2Fconf.py;h=d8c6a9b0242862af8dc408fd6edbbe26a3232d7a;hp=7ac6e2afb03c6034e3def7540d212c2f217ee608;hb=1567b13174de89884c7cbdd06b2f87bce63ed83e;hpb=839939c0d080dfe1c3adeee1e6565aac13c545bf

diff --git a/doc/source/conf.py b/doc/source/conf.py
index 7ac6e2a..d8c6a9b 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -7,21 +7,24 @@ import shlex
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('../../src/'))
-sys.path.insert(0, os.path.abspath('../../src/dunshire'))
+sys.path.insert(0, os.path.abspath('../../'))
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
     'sphinx.ext.autodoc',
-    'sphinx.ext.autosummary',
-    'sphinx.ext.coverage',
-    'sphinx.ext.ifconfig',
+    'sphinx.ext.doctest',
+    'sphinx.ext.mathjax',
+    'sphinx.ext.napoleon',
     'sphinx.ext.viewcode',
 ]
 
-autosummary_generate = True
+# Don't automatically test every >>> block in the documentation. This
+# avoids testing the API docs as part of the documentation build,
+# which is exactly what we intend, because those are tested as part of
+# the (much faster) unittest test suite.
+doctest_test_doctest_blocks = ''
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
@@ -37,10 +40,10 @@ copyright = '2016, Michael Orlitzky'
 author = 'Michael Orlitzky'
 
 # The short X.Y version.
-version = '0.0.1'
+version = '0.1.0'
 
 # The full version, including alpha/beta/rc tags.
-release = '0.0.1'
+release = '0.1.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -53,6 +56,9 @@ language = None
 # directories to ignore when looking for source files.
 exclude_patterns = []
 
+# Don't show "dunshire.games" before every damned method.
+add_module_names = False
+
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
 
@@ -71,10 +77,18 @@ html_theme = 'alabaster'
 
 # Remove the search box from the default list of sidebars.
 html_sidebars = {
-    '**': [
-        'about.html',
-        'navigation.html'
-    ]
+  '**': [
+    'about.html',
+    'navigation.html'
+  ]
+}
+
+# http://alabaster.readthedocs.io/en/latest/customization.html#theme-options
+html_theme_options = {
+  'github_button': False,
+  'github_user': False,
+  'github_repo': False,
+  'show_powered_by': False
 }
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
@@ -91,13 +105,11 @@ html_show_sphinx = False
 html_show_copyright = False
 
 # This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
+html_file_suffix = ".xhtml"
 
-# Language to be used for generating the HTML full-text search index.
-# Sphinx supports the following languages:
-#   'da', 'de', 'en', 'es', 'fi', 'fr', 'h', 'it', 'ja'
-#   'nl', 'no', 'pt', 'ro', 'r', 'sv', 'tr'
-#html_search_language = 'en'
+# Don't include the restructured text source files for the XHTML
+# pages, and don't display a link to them either.
+html_show_sourcelink = False
 
 # The name of a javascript file (relative to the configuration directory) that
 # implements a search results scorer. If empty, the default will be used.
@@ -109,14 +121,16 @@ htmlhelp_basename = 'dunshiredoc'
 # -- Options for LaTeX output ---------------------------------------------
 
 latex_elements = {
+    'preamble' : '\usepackage{amsfonts,amssymb}',
+    'printindex' : ''
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-  (master_doc, 'dunshire.tex', 'Dunshire Documentation',
-   'author', 'manual'),
+  (master_doc, 'dunshire.tex', project + ' Documentation',
+   author, 'manual'),
 ]
 
 # -- Options for manual page output ---------------------------------------
@@ -124,7 +138,7 @@ latex_documents = [
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
-    (master_doc, 'Dunshire', 'Dunshire Documentation',
+    (master_doc, project, project + ' Documentation',
      [author], 1)
 ]
 
@@ -138,7 +152,7 @@ man_pages = [
 # (source start file, target name, title, author,
 #  dir menu entry, description, category)
 texinfo_documents = [
-  (master_doc, 'Dunshire', 'Dunshire Documentation',
+  (master_doc, project, project + ' Documentation',
    author, 'derp', 'One line description of project.',
    'Miscellaneous'),
 ]