id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
17177	Building django documentation with Sphinx 1.1	Oleksandr Gavenko	Dan Poirier	"I install **python-sphinx** from Cygwin:
{{{
  $ cygcheck.exe -c python-sphinx
Cygwin Package Information
Package              Version        Status
python-sphinx        1.1-1          OK
}}}
Get Django from official mirror:
{{{
  $ hg clone https://bitbucket.org/django/django
  $ hg up -r releases/1.3.1
}}}
and try build **html** docs:
{{{
  $ cd docs
  $ make html
}}}
I get error:
{{{
sphinx-build -b djangohtml -d _build/doctrees   . _build/html
Running Sphinx v1.1
loading pickled environment... done
building [djangohtml]: targets for 205 source files that are out of date
updating environment: [config changed] 205 added, 0 changed, 0 removed
reading sources... [100%] topics/testing
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [  5%] howto/apache-auth
Exception occurred:
  File ""/usr/lib/python2.6/site-packages/sphinx/writers/html.py"", line 522, in visit_row
    self._table_row_index += 1
AttributeError: DjangoHTMLTranslator instance has no attribute '_table_row_index'
}}}
I go to **docs/_ext/djangodocs.py** class **DjangoHTMLTranslator** and just add **_table_row_index** field. Next build stoped at:
{{{
  $ make html
sphinx-build -b djangohtml -d _build/doctrees   . _build/html
Running Sphinx v1.1
loading pickled environment... done
building [djangohtml]: targets for 205 source files that are out of date
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
preparing documents... done
writing output... [  7%] howto/custom-management-commands
Exception occurred:
  File ""/usr/lib/python2.6/site-packages/sphinx/writers/html.py"", line 125, in visit_desc_parameter
    self.body.append(self.param_separator)
AttributeError: DjangoHTMLTranslator instance has no attribute 'param_separator'
}}}
So I add **param_separator** to **DjangoHTMLTranslator**. So I get:
{{{
class DjangoHTMLTranslator(SmartyPantsHTMLTranslator):
    """"""
    Django-specific reST to HTML tweaks.
    """"""

    _table_row_index = 0
    param_separator = ', '

    ....
}}}
After this I succesfully build Djando docs!"	Bug	closed	Documentation	1.3	Normal	duplicate		Oleksandr Gavenko	Unreviewed	0	0	0	0	0	0