diff options
author | Calum Lind <calumlind+deluge@gmail.com> | 2014-02-20 17:24:11 +0000 |
---|---|---|
committer | Calum Lind <calumlind+deluge@gmail.com> | 2014-02-20 17:38:51 +0000 |
commit | 9290cc1f7a49edcd121ec961dbbaec873c143af6 (patch) | |
tree | 528bbbaa0a3eb8c4c55c8f4ea190a6fc52edcf66 /docs/source/conf.py | |
parent | c64da3ceb4a1312efde6cfbb39c9ab0309ce8acd (diff) | |
download | deluge-9290cc1f7a49edcd121ec961dbbaec873c143af6.tar.gz deluge-9290cc1f7a49edcd121ec961dbbaec873c143af6.tar.bz2 deluge-9290cc1f7a49edcd121ec961dbbaec873c143af6.zip |
Fix building the code documentation with sphinx
Updated Sphinx conf and tested with Sphinx 1.2.1
Moved webui gen_gettext script
Fixed docstring warning in code
Renamed console update-tracker to update_tracker
Diffstat (limited to 'docs/source/conf.py')
-rw-r--r-- | docs/source/conf.py | 54 |
1 files changed, 41 insertions, 13 deletions
diff --git a/docs/source/conf.py b/docs/source/conf.py index 392cee1a5..9af04754e 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -1,7 +1,6 @@ # -*- coding: utf-8 -*- # -# deluge documentation build configuration file, created by -# sphinx-quickstart on Tue Nov 4 18:24:06 2008. +# Deluge documentation build configuration file # # This file is execfile()d with the current directory set to its containing dir. # @@ -13,18 +12,49 @@ import sys, os import deluge.common +from version import get_version +from datetime import date # If your extensions are in another directory, add it here. If the directory # is relative to the documentation root, use os.path.abspath to make it # absolute, like shown here. -sys.path.append(os.path.abspath(os.path.dirname(__file__ + "../../"))) +sys.path.append(os.path.abspath(os.path.dirname(__file__ + '../../'))) + +class Mock(object): + + __all__ = [] + + def __init__(self, *args, **kwargs): + pass + + def __call__(self, *args, **kwargs): + return Mock() + + @classmethod + def __getattr__(cls, name): + if name in ('__file__', '__path__'): + return '/dev/null' + elif name[0] == name[0].upper(): + mockType = type(name, (), {}) + mockType.__module__ = __name__ + return mockType + else: + return Mock() + +MOCK_MODULES = ['deluge.ui.languages', 'deluge.ui.countries', 'deluge.ui.gtkui.gtkui', + 'deluge.libtorrent', 'psyco', 'rencode', 'win32file', 'win32event', + 'win32gui', 'win32api', 'win32con', '_winreg'] + +for mod_name in MOCK_MODULES: + sys.modules[mod_name] = Mock() + # General configuration # --------------------- # 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.doctest'] +extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinxcontrib.napoleon'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -37,20 +67,17 @@ master_doc = 'index' # General substitutions. project = 'Deluge' -copyright = '2008-2010, Deluge Team' +current_year = date.today().year +copyright = '2008-%s, Deluge Team' % current_year # The default replacements for |version| and |release|, also used in various # other places throughout the built documents. # -def find_version(): - f = open("../../setup.py", "r") - for line in f: - if " version = " in line: - return line.strip().replace("\"", "").replace(" ", "").replace(",", "").split("=")[1] - # The short X.Y version. -version = find_version() +version = get_version(prefix='deluge-', suffix='.dev0') +# remove the created file by get_version +os.remove('RELEASE-VERSION') # The full version, including alpha/beta/rc tags. release = version @@ -66,6 +93,7 @@ today_fmt = '%B %d, %Y' # List of directories, relative to source directories, that shouldn't be searched # for source files. #exclude_dirs = [] +exclude_pattern = ['deluge/_libtorrent.py', 'deluge/__rpcapi.py'] # The reST default role (used for this markup: `text`) to use for all documents. #default_role = None @@ -112,7 +140,7 @@ html_style = 'default.css' # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". -html_static_path = ['_static'] +# html_static_path = ['_static'] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. |