Re: Bug#527538: python-sphinx: Exception raised: TypeError: encode() argument 1 must be string, not None

2009-05-13 Thread Mikhail Gusarov
tags 527538 moreinfo thanks Twas brillig at 18:55:22 13.05.2009 UTC-03 when llu...@gmail.com did gyre and gimble: LL> If it's not easy to see what's wrong from the backtrace maybe you LL> can close the bug and I'll reopen it if I hit the bug again so I LL> can send a test case or something.

Re: Bug#527538: python-sphinx: Exception raised: TypeError: encode() argument 1 must be string, not None

2009-05-13 Thread Mikhail Gusarov
Twas brillig at 21:56:31 07.05.2009 UTC-03 when llu...@gmail.com did gyre and gimble: LL> resolving references... LL> Exception occurred: LL> File "/usr/lib/pymodules/python2.5/sphinx/application.py", line 147, in warn LL> self._warning.write(warntext.encode(encoding, 'replace')) LL>

Builder specific content

2009-05-13 Thread juha . p . mustonen
Hi I'm not sure if I remember incorrectly, but is there a way to write builder specific content - the possibility to write content for example only for 'html' output? I've found the ifconfig extension from the documentation, but it is intended for all output formats, right? What I'd like to have

Re: trouble building pylons docs (FormEncode and WebOb)

2009-05-13 Thread Philip Jenvey
On May 13, 12:10 am, Georg Brandl wrote: > Walter Cruz schrieb: > > > I reported first at the Pylons list, you can see the thread here: > > >http://groups.google.com/group/pylons-discuss/browse_thread/thread/c5... > > > With the patch from Philip Jenvey, I can solve the first problem, but I > >

Logging module is causing Sphinx to crash.

2009-05-13 Thread Piotrek Byzia
Hi everybody, I'm having some problem due to the way I use logging module. Basically, I have separate file with configuration for logging and in each of my modules I define: logging.config.fileConfig(os.getcwd() + "/log/logconf.ini") and this is where Sphinx stops: Exception occurred:[ 33%] de

Re: "class" renaming - feedback needed!

2009-05-13 Thread sffjunkie
On May 13, 10:42 am, Doug Hellmann wrote: > > "classobj" is good, but why is it the only one "possible"? > > Doug Or the Docbook tag 'ooclass' Simon --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "sphinx-dev" g

Re: Bug#527538: python-sphinx: Exception raised: TypeError: encode() argument 1 must be string, not None

2009-05-13 Thread Leandro Lucarella
Mikhail Gusarov, el 14 de mayo a las 03:21 me escribiste: > > Twas brillig at 21:56:31 07.05.2009 UTC-03 when llu...@gmail.com did gyre and > gimble: > > LL> resolving references... > LL> Exception occurred: > LL> File "/usr/lib/pymodules/python2.5/sphinx/application.py", line 147, > in w

Please include GeoServer in the "Projects using Sphinx" page

2009-05-13 Thread Mike Pumphrey
GeoServer [1] has started the progress of migrating its documentation system to Sphinx. [2] is the main static page, but all the manuals it links to are Sphinx-based ([3] is an example) Please add us to the list on http://sphinx.pocoo.org/examples.html . [1] http://geoserver.org [2] http://

Re: "class" renaming - feedback needed!

2009-05-13 Thread Felix Hummel
Hi, classobj is fine, though I like Christophe's "classdef" (or "classdefinition" or even "clsdef"?) suggestion better. +1 for the extensions repository Felix --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "sphi

Re: "class" renaming - feedback needed!

2009-05-13 Thread Gerard Flanagan
> > There have been suggestions to move all code-documenting directives into > a namespace of sorts, i.e. "code.class", "code.function" etc.  This doesn't > appeal to me very much; it sounds like a complication where none is needed, > and doesn't lead to nice to read markup. I don't know how it

Re: Centering figures in LaTeX output

2009-05-13 Thread Guenter Milde
On 2009-05-13, Georg Brandl wrote: > Guenter Milde schrieb: >> However, the "arbitrary" alignment of the caption is a `known Docutils >> bug`__ that I am currently working on. The solution is to use the >> "caption" LaTeX package and explicitly set the alignment. Actually, the situation is a bit

Re: "class" renaming - feedback needed!

2009-05-13 Thread Doug Hellmann
On May 13, 2009, at 3:31 AM, Georg Brandl wrote: > > Looking at Python naming tradition, both "type" and "classobj" would > be > candidates. "klass" is also commonly used when a Python identifier is > called for, but of these, only "classobj" would be possible I think. "classobj" is good, bu

Re: Override templates per page

2009-05-13 Thread tuos
On May 13, 10:05 am, Georg Brandl wrote: > tuos schrieb: > > > > > Is there any way to override templates per page? > > > After reading source, it seems to me that there is not. > > Apparently, html_additional_pages are used for other purposes and > > cannot be used for this because empty conte

Re: "class" renaming - feedback needed!

2009-05-13 Thread Max Battcher
Georg Brandl wrote: > Now, finding a new name for "class" is hard. > > Looking at Python naming tradition, both "type" and "classobj" would be > candidates. "klass" is also commonly used when a Python identifier is > called for, but of these, only "classobj" would be possible I think. > > Other

Re: "class" renaming - feedback needed!

2009-05-13 Thread Christophe de VIENNE
Hi, classobj looks good to me. What about classdef ? Christophe --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-dev@googlegroups.com To unsubscribe f

"class" renaming - feedback needed!

2009-05-13 Thread Georg Brandl
Hi all, thanks for your feedback in the "status update" thread. It is now clear to me that the "class" directive should be consistent in docutils and sphinx; and so we need a new name for "class". First the easy thing, i.e. the transition: I think it would be good to introduce a config value "c

Re: trouble building pylons docs (FormEncode and WebOb)

2009-05-13 Thread Georg Brandl
Walter Cruz schrieb: > I reported first at the Pylons list, you can see the thread here: > > http://groups.google.com/group/pylons-discuss/browse_thread/thread/c5d52b60bfd7c193?hl=en > > With the patch from Philip Jenvey, I can solve the first problem, but I > get a error when building the WebOb

Re: Long tables with the latex builder

2009-05-13 Thread Georg Brandl
Christophe de VIENNE schrieb: > Hi, > > I made a patch that add a "longtable" option to the "tabularcolumns" > directive. You can pull it from > https://bitbucket.org/cdevienne/sphinx-longtable/ (Note that it is a > fork of sphinx-06) > > More details on the ticket : > http://bitbucket.org/birke

Re: autodoc and optparse

2009-05-13 Thread Georg Brandl
Tim Michelsen schrieb: >>> Why not simply run >>> >>> print.py --help >>> >>> and include the output in the rst source? >> >> I would advise that as well. > I though I could somehow capture the "print.py --help" output. > > Is there any idea how this could be trapped and included automatica

Re: Autosummary Extension

2009-05-13 Thread Georg Brandl
Pauli Virtanen schrieb: > Mon, 11 May 2009 05:05:56 -0700, Timmie wrote: > >>>http://sphinx.pocoo.org/latest/ext/autosummary.html >> This must be new in that place. >> >> I have been fiddeling with this... >> I do not really understand how the configuration for this works: >> http://sphi

Re: Override templates per page

2009-05-13 Thread Georg Brandl
tuos schrieb: > Is there any way to override templates per page? > > After reading source, it seems to me that there is not. > Apparently, html_additional_pages are used for other purposes and > cannot be used for this because empty context is passed to the > handler: > > ./html.py-494-#

Re: [PATCH] Support excluding files matching a given shell pattern.

2009-05-13 Thread Georg Brandl
James Rowe schrieb: > The patch attached adds a config option "exclude_file_pattern" that > is a general solution to the problem of removing files that can be > applied on top of glob inclusion. I think it makes sense because there > are definitely include/exclude patterns that hard to express

Re: Autodoc Quick Start

2009-05-13 Thread Georg Brandl
Casey McGinty schrieb: > The ".. automodule" command has an "exclude-members" option to filter > the output. Is there a way to exclude the modules doc string as well? I > want to have ".. automodule" w/ ":members:", but not show the modules > doc string. No, that's not possible using an option, b

Re: Centering figures in LaTeX output

2009-05-13 Thread Georg Brandl
Guenter Milde schrieb: > On 2009-05-08, Janet Swisher wrote: > >> On Tue, May 5, 2009 at 4:03 AM, Guenter Milde wrote: >>> On 2009-05-01, Janet Swisher wrote: On Sun, Nov 16, 2008 at 11:53 AM, Georg Brandl wrote: > Ananth schrieb: > >> - The figures that are generated in latex see

Re: How to set document title tag etc. for SEO

2009-05-13 Thread Georg Brandl
Sanjay schrieb: > Hi Guenter, > >> In Docutils, you can use the ``.. title::`` directive. >> Seehttp://docutils.sf.net/docutils/docs/ref/rst/directives.html > > Thanks a lot for this input. However, I tried giving this near the top > of the document: > > .. title:: Some title I want to appear