X-Git-Url: http://git.ithinksw.org/philo.git/blobdiff_plain/b4cd9f878117f7398442acb09d40b520f321a91d..886de29e37c1dbfe17a69c65d4aa010a0d60e1c1:/docs/conf.py?ds=sidebyside diff --git a/docs/conf.py b/docs/conf.py index d6c70af..c888d0e 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -24,6 +24,13 @@ os.environ['DJANGO_SETTINGS_MODULE'] = 'dummy-settings' # Import loader so that loader_tags will be correctly added to builtins. Weird import situations... this is necessary for doc build to work. from django.template import loader +# HACK to override descriptors that would cause AttributeErrors to be raised otherwise (which would keep them from being documented.) +from philo.contrib.sobol.models import SearchView +SearchView.searches = 5 +from philo.models.nodes import TargetURLModel, File +TargetURLModel.reversing_parameters = 5 +File.file = 5 + # -- General configuration ----------------------------------------------------- # If your documentation needs a minimal Sphinx version, state it here. @@ -31,7 +38,7 @@ needs_sphinx = '1.0' # Add any Sphinx extension module names here, as strings. They can be extensions # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. -extensions = ['djangodocs', 'sphinx.ext.autodoc'] +extensions = ['djangodocs', 'sphinx.ext.autodoc', 'philodocs'] # Add any paths that contain templates here, relative to this directory. templates_path = ['_templates'] @@ -225,3 +232,12 @@ man_pages = [ ('index', 'philo', u'Philo Documentation', [u'Stephen Burrows'], 1) ] + +def skip_attribute_attrs(app, what, name, obj, skip, options): + if name in ("attribute_set", "get_attribute_mapper", "nodes"): + return True + return skip + +def setup(app): + app.connect('autodoc-skip-member', skip_attribute_attrs) + #app.connect('autodoc-process-signature', )