From 788291920a447be16af9f330973816b6ca56c7b0 Mon Sep 17 00:00:00 2001 From: Michael Orlitzky Date: Mon, 10 Oct 2016 10:51:32 -0400 Subject: [PATCH] Move the README into doc/, add it to the Sphinx index, and tweak that. --- README => doc/README.rst | 6 ++++-- doc/source/conf.py | 24 +++++++++++++----------- doc/source/index.rst | 15 ++++++--------- 3 files changed, 23 insertions(+), 22 deletions(-) rename README => doc/README.rst (92%) diff --git a/README b/doc/README.rst similarity index 92% rename from README rename to doc/README.rst index 06dead0..6fe9ba6 100644 --- a/README +++ b/doc/README.rst @@ -1,10 +1,12 @@ -== Overview == +Overview +-------- Dunshire is a CVXOPT-based library for solving linear (cone) games. The notion of a cone game was introduced by Gowda[1] and extended to asymmetric cones in my thesis[2]. -== Requirements == +Requirements +------------ The only requirement is the CVXOPT library, available for most Linux distributions. Dunshire is targeted at python-3.x, but python-2.x will diff --git a/doc/source/conf.py b/doc/source/conf.py index 7ac6e2a..62ac530 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -17,7 +17,7 @@ extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.autosummary', 'sphinx.ext.coverage', - 'sphinx.ext.ifconfig', + 'sphinx.ext.pngmath', 'sphinx.ext.viewcode', ] @@ -71,10 +71,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, @@ -93,12 +101,6 @@ html_show_copyright = False # This is the file name suffix for HTML files (e.g. ".xhtml"). #html_file_suffix = None -# 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' - # The name of a javascript file (relative to the configuration directory) that # implements a search results scorer. If empty, the default will be used. #html_search_scorer = 'scorer.js' diff --git a/doc/source/index.rst b/doc/source/index.rst index 57c74d4..dcb28d5 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -1,13 +1,16 @@ Dunshire -================================ +======== + +.. include:: ../README.rst Contents: .. toctree:: :maxdepth: 2 - dunshire - modules + +API Documentation +----------------- .. autosummary:: :toctree: _autosummary @@ -17,9 +20,3 @@ Contents: dunshire.options dunshire.matrices dunshire.symmetric_linear_game - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -- 2.43.2