Re: [sphinx-dev] autodoc and modules

2011-01-12 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 09.01.2011 22:42, schrieb Vinay Sajip: > Hi Georg, > >> I'm not sure how to "fix" this. Even if you could get Sphinx to import > >> the contents of baz via foo, the __module__ attribute of classes and >> functions would be wrong, and therefore

Re: [sphinx-dev] Re: :param: and :keyword: rendering

2011-01-12 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 12:36, schrieb Fred Drake: > On Wed, Jan 12, 2011 at 3:14 AM, Guenter Milde wrote: >> Addition: to avoid confusion with keywords of a programming language, I >> change my suggestion to >> (i.e. "kwarg" instead of "keyword"). > > If we

Re: [sphinx-dev] Using Sphinx with C extensions

2011-01-12 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 13.01.2011 05:05, schrieb Jason: > I have written a Python module including a submodule written in C: the > module itself is called "foo" and the C part is "foo._bar". The > structure looks like: > > src/ > foo/__init__.py <- contains the public

Re: [sphinx-dev] Possible to break a title across two lines?

2011-01-12 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 22:21, schrieb Kevin Cole: > Hi, > > I haven't been fooling w/ Sphinx or reST very long, and don't know LaTeX. I'm > currently running Sphinx 1.0.1 under Ubuntu Maverick. > > I've tried a few different ways to get a document subtitle,

Re: [sphinx-dev] Patch request for node line numbering

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 14.01.2011 22:57, schrieb Kevin Dunn: > On Fri, Jan 7, 2011 at 05:17, Georg Brandl wrote: >> -BEGIN PGP SIGNED MESSAGE- >> Hash: SHA1 >> >> Am 24.08.2010 15:53, schrieb Kevin Dunn: >>> Hi, >>&

Re: [sphinx-dev] Re: Using Sphinx with C extensions

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 13.01.2011 09:12, schrieb Jason: > On Jan 13, 3:33 pm, Georg Brandl wrote: >> > Is there any way around this? >> >> Yes: build the C extension before you build the docs. > > I use distutils to build it all,

Re: [sphinx-dev] classes inside automodule

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 14.01.2011 09:59, schrieb Chris Withers: > On 14/01/2011 03:58, TP wrote: >>> If I do, for example: >>> >>> >>> .. automodule:: testfixtures >>> >>> .. class:: Comparison >>> >>> ...then I end up with two sections for the Comparison class, one >>>

Re: [sphinx-dev] Add Sphinx project

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 13.01.2011 15:51, schrieb Andy Harrington: > The Python 3.1 versio of my Hands-on Python Tutorial uses Sphinx for > both the html and pdf versions. > > http://anh.cs.luc.edu/python/hands-on/3.1/handsonHtml/ > > http://anh.cs.luc.edu/python/hands-o

Re: [sphinx-dev] Projects using Sphinx

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 11.01.2011 15:55, schrieb SHIBUKAWA Yoshiki: > Hi, > > Many Sphinx sites in Japan are listed at the following page. > > http://sphinx-users.jp/example.html > > And I wrote 3 books with Sphinx(sorry, all of them are Japanese). > > 1. "Simple and

Re: [sphinx-dev] Projects using Sphinx

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 11.01.2011 15:19, schrieb Jan Ulrich Hasecke: > Hi, > > you may want to add two projects to the page: > Projects using Sphinx > > Plone 4 Benutzerhandbuch (German) > http://www.hasecke.com/plone-benutzerhandbuch/4.0/ > > and a non-software projec

Re: [sphinx-dev] Projects using Sphinx

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 11.01.2011 16:00, schrieb Enrique J. Hernández Blasco: > Sorry for hijacking the thread. > > We also use sphinx in an open-source project called Zentyal. > > The documentation is available at: > > http://doc.zentyal.org > > It would be great to

Re: [sphinx-dev] productionlist/latex problem (regression I think)

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 09:31, schrieb Georg Brandl: > Am 11.01.2011 21:44, schrieb Marcin Wojdyr: >> Hello, > >> I have such a thing: > >> .. productionlist:: >>line: [`statement`] [`comment`] >>... > >

Re: [sphinx-dev] Intersphinx problem with Generator

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 13:30, schrieb cool-RR: > On Wed, Jan 12, 2011 at 2:24 PM, cool-RR > wrote: > > Hello, > > I write :term:`generator` in my docs, and do `make html`, but it doesn't > make a link to Python's docu

Re: [sphinx-dev] Feature request with :lines: with :linenos:

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 16:23, schrieb Andy Harrington: > I suggest/request that either the default or at least an option with > > .. literalinclude:: > >:lines: 10-15 > >:linenos: > > > be that the line numbers are in sync with the lines. The code

Re: [sphinx-dev] Re: Problem with mailto: links

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 22:45, schrieb Giles Thomas: > Georg Brandl wrote: >>> Thanks for the reply. We're using docutils 0.7 too; we're still on >>> Python 2.5, though. Might that be the problem, do you think? >>>

Re: [sphinx-dev] attributes inside autoclass

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 13.01.2011 23:31, schrieb Chris Withers: > Hi All, > > When I do, for example: > > .. autoclass:: TempDirectory > :members: > > .. attribute:: path > > This is the path attribute > > ...the attribute isn't shown in the rendered ht

[sphinx-dev] Sphinx 1.0.7 released

2011-01-15 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi all, I'm happy to announce the release of Sphinx 1.0.7, a bug-fix release in the 1.0 series, fixing a number of bugs in the 1.0 line of releases, most importantly a regression in LaTeX output introduced in 1.0.6. What is it? === Sphinx is

Re: [sphinx-dev] Using Sphinx in education

2011-01-16 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 22:12, schrieb Tim Bower: > This is not exactly a new project using Sphinx, but I wanted to > mention that I have been using Sphinx for course material delivery in > college classes. I think Sphinx has a great deal of value to > educatio

Re: [sphinx-dev] Intersphinx problem with Generator

2011-01-16 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 16.01.2011 12:47, schrieb cool-RR: > > Hello, > > > > I write :term:`generator` in my docs, and do `make html`, but it > doesn't > > make a link to Python's documentation. I also tried prefixing it > with :py, > >

Re: [sphinx-dev] productionlist/latex problem (regression I think)

2011-01-18 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 18.01.2011 15:47, schrieb Marcin Wojdyr: >> >> Yes, it was indeed. Should now be fixed with rev 70f2984f86d7. > > Thanks, the references work now. > > Is it possible to somehow switch off latex_show_pagerefs only for > productionlists? > Grammar

Re: [sphinx-dev] automodule/autodoc line numbers impossible to interpret

2011-01-24 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 24.01.2011 20:24, schrieb Erik Tollerud: > I've been making quite a bit of use of autodoc (specifically, > automodule) for documenting a project. However, as the project has > grown, I find it's difficult to tell where warnings are occurring in > t

Re: [sphinx-dev] How does sphinx auto-generate "nightly" docs?

2011-01-24 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 24.01.2011 20:13, schrieb Erik Tollerud: > I've noticed the sphinx "latest" documentation page seems to stay in > sync with the development version on bitbucket. Is this done by an > automatic tool to keep the documentation page up-to-date with the

Re: [sphinx-dev] Release of 1.1: any plans?

2011-02-28 Thread Georg Brandl
On 28.02.2011 19:41, Prof. Roberto Bagnara wrote: > > Has this been planned? I am looking forward to the > possibility of having multiple terms per entry in > a glossary. Unfortunately, I currently was and still am quite busy (as you also can see from my lack of responses to this list). But Pyt

Re: [sphinx-dev] Release of 1.1: any plans?

2011-06-22 Thread Georg Brandl
On 22.06.2011 21:50, Roberto Bagnara wrote: > On 02/28/11 20:09, Georg Brandl wrote: >> On 28.02.2011 19:41, Prof. Roberto Bagnara wrote: >>> >>> Has this been planned? I am looking forward to the >>> possibility of having multiple terms per entry in &g

Re: [sphinx-dev] Release of 1.1: any plans?

2011-06-22 Thread Georg Brandl
On 22.06.2011 22:00, Roberto Bagnara wrote: > On 06/22/11 21:57, Georg Brandl wrote: >> On 22.06.2011 21:50, Roberto Bagnara wrote: >>> On 02/28/11 20:09, Georg Brandl wrote: >>>> On 28.02.2011 19:41, Prof. Roberto Bagnara wrote: >>>>> >>>

Re: [sphinx-dev] Estonian translation

2011-09-18 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 18.09.2011 10:09, schrieb Aivar: > Hi! > > I translated UI strings to Estonian (locale code 'et'). > http://www.aivarannamaa.ee/sphinx/sphinx.po > > Hopefully this can be added to next release. Thank you! Please add it to a tracker issue, so tha

Re: [sphinx-dev] New extensions : word writer & clearquest directive

2011-09-21 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.09.2011 15:09, schrieb Robin Jarry: > Hello everyone, > > I've been using RST for over a year now and I wrote a couple of things > around it. I don't know how I managed to miss the Sphinx project but hey, > nobody's perfect :-) > > I would lik

Re: [sphinx-dev] Re: Images and re-builds

2011-09-22 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 31.08.2011 21:24, schrieb Aivar: > Hi! > > This quirk causes problems for me as well. I use Sphinx for generating > course materials, where I occasionally update a chapter, rebuild and upload > corresponding html file to the course site. Usually I

Re: [sphinx-dev] Strange behaviour of :abbr:

2011-09-23 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 23.09.2011 09:31, schrieb Stefano David: > Hi, I started using sphinx around six months ago and find it easy to use > and powerful. I found, however, a problem when using :abbr:and I do not > know whether it is a bug or something I am missing. So,

Re: [sphinx-dev] How do I add a cross-reference to js:attribute::

2011-09-23 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 31.08.2011 11:05, schrieb Frank Schröder: > Hi, > > I have a list of js:attribute:: entries and I would like to cross-reference > them within the same document. How do I do this? Something similar to this > (which does not work for me). I'm using S

[sphinx-dev] Sphinx 1.0.8 released

2011-09-23 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi all, I'm happy to announce the release of Sphinx 1.0.8, a bug-fix release in the 1.0 series, fixing a large number of bugs in the 1.0 line of releases. The full changelog is at . What is it? === Sphi

Re: [sphinx-dev] Sphinx 1.0.8 released

2011-09-24 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I see... this is with docutils 0.6, right? I'll update the tests to care for this case, but you should upgrade to at least 0.7 anyway. cheers, Georg Am 24.09.2011 21:12, schrieb Chris Lea: > I get two errors when I try to run the test suite on an Ub

Re: [sphinx-dev] no quick search in Konqueror

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/04/11 22:40, Paulette wrote: > Hi, > > I have a user who cannot see the Quick Search box when he uses the > Konqueror brower (on Linux). This search box appears for all the other > browsers we tried (IE, Chrome, Safari, Firefox, etc.). If you

Re: [sphinx-dev] sphinx tcl highlighting problem

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/02/11 01:41, bulletmark wrote: > The small tcl code fragment: > > .. code-block:: tcl :linenos: > > set a 1 puts ${a} > > fails to render in sphinx but does render when I run it through pygmentize > manually. Also runs fine in tclsh of course

Re: [sphinx-dev] All Latex symbols rendered on new line

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/04/11 18:35, Pavel Solin wrote: > Hi, after a change in our Sphinx docs that we are unable to trace back > anymore, all math symbols such as $x$ are not rendered in line anymore, but > on a new line. This literally broke all formatting of our do

Re: [sphinx-dev] Error in cpp:namespace directive

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 09/30/11 19:39, Jack Poulson wrote: > Hello, > > It would appear that the C++ domain's 'cpp:namespace' directive does not > work (in 1.0.7 or 1.0.8). For instance, when adding in the following code: > > .. cpp:namespace:: mpi > > .. cpp:clase:: T

Re: [sphinx-dev] sphinx v1.0.7/automodule does load package, only shared lib

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 09/29/11 17:04, Avi Bahra wrote: > If I have a C++ python extension say _ecflow.so. The normal convention is > to place it in a directory with same name as extension. > > ecflow/ _ecflow.so __init__.py > > where __init__.py: has as the first line

Re: [sphinx-dev] sphinx tcl highlighting problem

2011-10-05 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/05/11 16:02, bulletmark wrote: > I was running pygmentize to my terminal and after your comment I have > realized that some of the output is underlined so I guess that means > pygmentize believes it is invalid syntax? Yep, this is how the defaul

Re: [sphinx-dev] referencing hyperlinks using :ref:

2011-10-07 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/06/11 22:00, Christian Rohling wrote: > Hey everyone, I am new to sphinx, and am using it to document a project. I > have run into a something that I feel I should be able to do, but cannot > find out how. I want to reference a hyperlink section

Re: [sphinx-dev] disable search for html

2011-10-07 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/02/11 14:39, mbedward wrote: > Hello folks, > > For html output, I would like to disable creation of the search index and > search page but I haven't been able to find any clues on how to do this in > the docs or archived posts. I suspect I'm mi

[sphinx-dev] Sphinx 1.1 released

2011-10-09 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi all, I'm happy to announce the release of Sphinx 1.1, a new feature release. The full changelog is at . Highlights == * Added Python 3.x support. * Added a Texinfo builder. * Added i18n support for c

Re: [sphinx-dev] Override the release name

2011-11-01 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/31/2011 06:14 PM, Jan Ulrich Hasecke wrote: > Hi, > > is it possible to overwrite the release name in Sphinx. > > I want to have a custom name (subtitle) on the pdf-output. You can set "release" in conf.py, or give it on the command line, with

Re: [sphinx-dev] Re: parsed-literal problems

2011-11-01 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 10/29/2011 01:19 PM, Guenter Milde wrote: > On 2011-10-29, Andrea Crotti wrote: >> On 10/28/2011 10:28 PM, Guenter Milde wrote: >>> What do you expect and what do you get? > > >> I would think to get the code highlighted, instead is just not recog

Re: [sphinx-dev] Override the release name

2011-11-01 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 11/01/2011 09:43 AM, Jan Ulrich Hasecke wrote: > Am 01.11.11 08:50, schrieb Georg Brandl: >> On 10/31/2011 06:14 PM, Jan Ulrich Hasecke wrote: >>> Hi, > >>> is it possible to overwrite the release name in Sphinx.

[sphinx-dev] Sphinx 1.1.1 released

2011-11-01 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi all, I'm happy to announce the release of Sphinx 1.1.1, a bug-fix release in the 1.1 series, fixing a number of bugs of the initial 1.1 release. What is it? === Sphinx is a tool that makes it easy to create intelligent and beautiful docum

[sphinx-dev] Sphinx 1.1.2 released

2011-11-01 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Hi all, I'm announcing the release of Sphinx 1.1.2, codename "1.1.1 Is A Silly Version Number Anyway". It fixes building from the source tarball with Python 3 by actually including our custom 2to3 fixers. What is it? === Sphinx is a tool

Re: [sphinx-dev] Re: Some characters rendering wrongly in HTML output

2011-11-25 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 25.11.2011 22:17, schrieb Guenter Milde: > On 2011-11-25, Guenter Milde wrote: >> On 2011-11-25, Friedrich Romstedt wrote: >>> Am 25.11.2011 um 08:44 schrieb Guenter Milde : On 2011-11-24, Friedrich Romstedt wrote: > > I'm experiencing som

Re: [sphinx-dev] How to reduce memory usage of sphinx-build

2012-01-06 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On 01/06/2012 03:44 PM, Neck Acm wrote: > Hi all, I am new to sphinx, I am trying to convert massive plain text files > to well-organized html, not program documentation, just some plain text > record. > > The source text files is about 116 MB, I use

Re: [sphinx-dev] PULL REQ: Add URL #anchor checking to 'linkcheck' builder

2012-03-10 Thread Georg Brandl
On 07.03.2012 17:23, Marti Raudsepp wrote: Hi! Last week I submitted a pull request to the Sphinx Bitbucket repository, but there has been no activity on the request. Is there another way to submit patches to Sphinx? Anyway, the patch downloads all pages that have '#' in their address, and then

[sphinx-dev] Sphinx 1.1.3 released

2012-03-10 Thread Georg Brandl
Hi all, I'm happy to announce the release of Sphinx 1.1.3. It fixes over 20 bugs and buglets in the 1.1 series of Sphinx. What is it? === Sphinx is a tool that makes it easy to create intelligent and beautiful documentation for Python projects (or other documents consisting of multiple

Re: [sphinx-dev] Re: Exception when using Sphinx 1.1.2 to create the Leo documentation

2012-03-14 Thread Georg Brandl
On 14.03.2012 16:15, VR wrote: Hello everyone, Am Samstag, 18. Februar 2012 09:36:39 UTC+1 schrieb VR: when running Sphinx 1.1.2 I receive the following exception. - See 'Log-1' for the exception: ... and 'Log-2' for the output from 'sphinx-err-7u9urs.log':

Re: [sphinx-dev] autodoc and module variables

2012-03-17 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 I agree. I will fix the doc to make this clearer. cheers, Georg On 03/16/2012 11:54 AM, Rob Reilink wrote: > I have to say that the doc is not very clear: ...'documentation can either > be put into a special-formatted comment'... but the colon is no

[sphinx-dev] Sphinx: Co-Maintainer(s) wanted

2012-10-28 Thread Georg Brandl
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Dear Sphinx users, dear Python community, unfortunately, it has turned out that at the moment I don't have enough spare time to fulfill my duties as Python core developer and release manager, as well as fully maintain my other open-source projects. T

Re: Patch for using XeLaTeX

2008-08-30 Thread Georg Brandl
Markus Gritsch schrieb: > Hi, > > when using xelatex instead of pdflatex (to be able to use OpenType > fonts and Unicode), [EMAIL PROTECTED] and [EMAIL PROTECTED] get not defined. > The attached patch fixes the problem. > > IMO the patch could be improved to be merged somehow with the lines > ab

Re: few question

2008-08-30 Thread Georg Brandl
Pavel Kosina schrieb: > These might be rather my wishes than anything else: I'm sorry it took so long to find time to answer properly. > * finding for "pyt" should find also python and pythonic The search is somewhat whole-word-oriented. It stems words using a stemmer for the English language (

Re: Jinja2 templating

2008-08-30 Thread Georg Brandl
Sebastian Wiesner schrieb: > Hi, > > It's probably even a bit too early to switch the template engine, > considering, that the first final e of jinja 2 was just a month ago, but > jinja 1 will obviously become outdated sooner or later. > > Therefore I put some effort in porting Sphinx templati

Re: Missing import in setup_command.py

2008-08-30 Thread Georg Brandl
Sebastian Wiesner schrieb: > Hello list, > > I need to admit, that I failed to add a required import for SystemMessage > class in setup_command.py. The attached patch fixes this. Sorry for the > inconvenience. Fixed in r66070! Georg --~--~-~--~~~---~--~~ You

Re: special directive for sidebar toc

2008-08-30 Thread Georg Brandl
schoenborno schrieb: > It would be handy to have some control over the TOC in the sidebar. > E.g. specify to what depth it should go, whether it should include > section headers (rather than just page titles), etc. Would this be > difficult to implement? The TOC in the sidebar should always inclu

Re: syntax highlight

2008-08-30 Thread Georg Brandl
Pavel Kosina schrieb: > This code: > > Argumenty > - > > Funkce:: > > def rada(napeti): > print("-- Vas kolega vas nebude ", action, end=' ') > > is not syntax highlighted. Might be a bug I can't reproduce that here. Can you verify the snippet does

Re: Sphinx locale object conflicts with locale.py from Python distribution

2008-08-30 Thread Georg Brandl
Bob Tolbert schrieb: > I've checked out SVN trunk and installed Sphinx and all dependencies > into a clean install of Python 2.5.2 on Windows. Now all script > invocations include the following error: > > > > import locale # directory > C:\cygwin\home\bob\devel\Sphinx\doctools\trunk\sphinx\loca

Re: control text width

2008-08-30 Thread Georg Brandl
schoenborno schrieb: > Is there any way to control the width of main text area? Most web > pages limit text width to something like 1000 pixels so the text is > easier to read (it's well known that short lines are easier to read > than long lines). Thanks, Interesting; I've so far only had compla

Re: Documenting SQLAlchemy models with Sphinx fails (table already defined)

2008-08-30 Thread Georg Brandl
Christoph Haas schrieb: > Dear list... > > I'm on a documentation frenzy now in my current Pylons project. And I'm > using Sphinx for that purpose. All my controllers and helper functions are > documented automatically. Great. Unfortunately Sphinx fails to create > module documentation for my

Re: Feature request for cmdoption

2008-08-30 Thread Georg Brandl
Bob Tolbert schrieb: > I'd like to offer a suggestion for an enhancement to cmdoption. I find > that I need to document multiple, small programs in the same document. > And many of them have a common option like "-in". > > The current method will cause a clash if the two are defined in the > same

Re: syntax highlight

2008-09-01 Thread Georg Brandl
Pavel Kosina schrieb: > Georg Brandl napsal(a): >> Pavel Kosina schrieb: >> >>> This code: >>> >>> Argumenty >>> - >>> >>> Funkce:: >>> >>> def rada(napeti): >>>

Re: The extrahead block in layout.html

2008-09-06 Thread Georg Brandl
Tarek Ziadé schrieb: > Hello > > I have customized my Sphinx look and feel, by overriding layout.html > like this: > > > {% extends '!layout.html' %} > > {% block extrahead %} >href="{{ pathto('_static/mine.css', 1) }}" > type="text/css" /> > {% endblock %} > > > The problem

Re: few question

2008-09-06 Thread Georg Brandl
Georg Brandl schrieb: > Pavel Kosina schrieb: >> These might be rather my wishes than anything else: > > I'm sorry it took so long to find time to answer properly. > >> * finding for "pyt" should find also python and pythonic > > The search is somew

Re: few question

2008-09-06 Thread Georg Brandl
Pavel Kosina schrieb: > Georg Brandl napsal(a): >>> * date in bootom could be formatted according to format in translation ... >>> >> >> It should already be. The format is html_last_updated_fmt, and should be >> in the message catalog as well. >&g

Re: Exception occured

2008-09-06 Thread Georg Brandl
You're trying to use the web builder, which is dead by all means. :) A replacement may come in the future, for the time being 0.5 ships with new serializing builders. Georg Neal Becker schrieb: > sphinx-0.4.2 > > make web > mkdir -p .build/web .build/doctrees > mkdir -p .static .templates > s

Re: Issue with automodule

2008-09-06 Thread Georg Brandl
Pierre GM schrieb: > All, > Once again, I have a problem with the .. automodule:: directive (r66095) > Now, it doesn't print take any members of a module when module.__all__ is > defined. It lokos like the problem comes from that line (L503): > > all_members = inspect.getmembers(todoc, lambda x:

Re: syntax highlight

2008-09-09 Thread Georg Brandl
Pavel Kosina schrieb: > :-D > > Sorry, I forgot two things: > > - mentioned that .. highlight:: python3 helped for the example I stated > before. > - translation with codes: http://python.gymdom.cz/dokumentace/errors.html You're right... recognition of doctests isn't done when using some lexer

Re: html2rest script

2008-09-09 Thread Georg Brandl
Gerard Flanagan schrieb: > It's not perfect but maybe useful for anyone wanting to convert an > existing site to Sphinx. > For uncomplicated HTML without tables it can be a 100% solution, but > don't expect this. > > (The link will probably wrap) > > http://bazaar.launchpad.net/~grflanagan/pytho

Re: few question

2008-09-09 Thread Georg Brandl
Pavel Kosina schrieb: > Georg Brandl napsal(a): >> This is now done in trunk. Translators, if you want to update your >> .po files, you're welcome to do so! >> > > Well, until I do easy_install babel Ill get following during upgrading > to latest d

Re: rst2pdf and sphinx

2008-09-10 Thread Georg Brandl
Pavel Kosina schrieb: > ralsina napsal(a): >> Hello, I am one of the authors of a tool to generate PDFs straight >> from Restructured Text without passing through LaTeX. >> >> I played a little with Sphinx trying to get a PDF version of the >> Django docs, and am having partial success. Is there i

Re: Extension repository

2008-09-11 Thread Georg Brandl
Stéfan van der Walt schrieb: > Hey all, > > We've developed some extensions and documentation extraction plugins > as part of the NumPy documentation project. The Matplotlib project > also developed ways of including plots and IPython highlighted > code-snippets. We are looking for a central pl

Re: Problems with i18n

2008-09-11 Thread Georg Brandl
Michal Kandulski schrieb: > Hi! > > I've got some problems trying to use sphinx with Polish: > > 1. 'Index', 'Module Index' and 'Search Page' are still in English. > > In conf.py file: > > language = 'pl' > > In index.rst: > > * :ref:`genindex` > * :ref:

Re: LateX and ucs

2008-09-11 Thread Georg Brandl
Tarek Ziadé schrieb: > > I finally managed to do it without changing the code, thanks to the > latex_preamble option. > > I am injecting in the latex file my latex options to be able to render a > PDF that looks french > and compiles well on my environment. > > latex_preamble = open('my-options

Re: [RFC] graphviz extension

2008-09-11 Thread Georg Brandl
Charles Duffy schrieb: > Per subject. This is my first attempt at a Sphinx extension, so I'm > certain there's plenty of room for improvement; see attached. > > Usage is as follows: > > .. graphviz:: > strict digraph { > foo -> bar -> baz; > foo -> qux; > } > > > This in rendered

Re: Documenting SQLAlchemy models with Sphinx fails (table already defined)

2008-09-11 Thread Georg Brandl
[EMAIL PROTECTED] schrieb: > On Aug 30, 7:35 am, Georg Brandl <[EMAIL PROTECTED]> wrote: > >> Problems can arise, however, if the module is imported under different names, >> e.g. once as "myapp.application" and once as "application". >> >&

Re: Extension repository

2008-09-12 Thread Georg Brandl
Georg Brandl schrieb: > Stéfan van der Walt schrieb: >> Hey all, >> >> We've developed some extensions and documentation extraction plugins >> as part of the NumPy documentation project. The Matplotlib project >> also developed ways of including plots an

Re: Documenting SQLAlchemy models with Sphinx fails (table already defined)

2008-09-12 Thread Georg Brandl
Thorsten Lockert schrieb: > On Sep 11, 2008, at 15:40 , Georg Brandl wrote: >> >> [EMAIL PROTECTED] schrieb: >>> Note the trailing dot in the second occurrence of the import. >>> Immediately after than second import SQLAlchemy throws >>> "Argument

Re: graphviz extension

2008-09-12 Thread Georg Brandl
Charles Duffy schrieb: > I appreciate the report... that said, I'm a little unclear on what the > Right Way to fix this is. sphinx.ext.pngmath appears to reference a > self.builder.imgpath in render_math, but app.builder.imgpath doesn't > appear to exist when process_graphviz_nodes is called from

Re: LaTeX footers broken?

2008-09-24 Thread Georg Brandl
[EMAIL PROTECTED] schrieb: > I've noticed that (when rendered to PDF), the LaTeX footers all show > "Contents" as the section name. This is happening in my documentation, > as well other people's PDFs (for example, the Sphinx docs at > http://sphinx.pocoo.org/sphinx.pdf). Does anyone have any clue

Re: sphinx-quickstart and index.rst

2008-09-24 Thread Georg Brandl
Pavel Kosina schrieb: > idea: when restarting generation of conf.py with sphinx-quickstart (to > get all the new choices), then my index.rst should stay the same or at > least back it up quickstart isn't meant to "update" existing projects at all. I've now added a warning to quickstart to p

Re: Numpy's Sphinx extensions

2008-10-02 Thread Georg Brandl
Hi Pauli, many thanks for doing this! I'll look at the extensions more thoroughly when I've got more time again, in two weeks. Thanks, Georg Pauli Virtanen schrieb: > Hi, > > On ti, 2008-09-30 at 23:19 +0300, Pauli Virtanen wrote: >> (CC to sphinx-dev list, in case Sphinx devs want to start co

Re: another project using sphinx for docs

2008-10-02 Thread Georg Brandl
Gary Poster schrieb: > Thanks for sphinx! > > If you'd like to include this on your list of projects using sphinx, > here's a link to the docs. These use the default template, and only > customize the CSS (which ATM looks best on a Mac because of a font > choice I made... :-/ ). > > http:

Re: Sphinx and Setuptools

2008-10-02 Thread Georg Brandl
Mike Hansen schrieb: > Hello, > > I was running into some issues installing the SVN version of Sphinx. > It's the same issue as is here: > http://groups.google.com/group/sphinx-dev/browse_thread/thread/1ececc73364fbca0 > . The problem is that in setup.py ( > http://svn.python.org/projects/docto

Re: best place to report a bug (with patch)?

2008-10-08 Thread Georg Brandl
Trent Mick schrieb: > Hello, > > Where is the best place to report a bug (with a suggested patch for a > fix) in sphinx? > Here on this list? Some bug database? There is an issue tracker at Google code (http://code.google.com/p/sphinx), but you can as well use the list; I keep track of things to

Re: How to document private functions (functions that start with '__')?

2008-10-08 Thread Georg Brandl
Vikram Ramakanth schrieb: > Hi, > I am trying to use Sphinx to document a python project. I used > `autoclass` and noticed that it skips private functions in classes. Is > there any way to force it to generate documentation for private > functions too? You'll have to manually use automethod direc

Re: Itegrating 3rd party docs

2008-10-08 Thread Georg Brandl
boothead schrieb: > Hi All, > > Thanks first of all for a wonderful piece of software, sphinx has made > an awesome difference to our codebase and documentation! Great to hear! Thank you very much! > I've just started a subproject and I'm trying to integrate some 3rd > party docs into my docume

Re: weird loss of "directive" directive

2008-10-08 Thread Georg Brandl
Bob Tolbert schrieb: > Hi, > > This may be a strange question, but I'm frankly at a loss for what > I've done. For some reason, I can no longer use the "directive" > directive. I get an error like: > > (ERROR/3) Unknown directive type "directive". > > .. directive:: .. code-block:: filename >

Re: Cython using sphinx

2008-10-08 Thread Georg Brandl
Gabriel Gellner schrieb: > Just wanted to see that the Cython documentation is now using Sphinx, > hosted at: > > http://docs.cython.org > > Just in case someone wanted to add it to the list of packages using it. > > Thanks for all the great tool! Thanks for the note! I've added Cython to the

Re: Stripped-down template

2008-10-08 Thread Georg Brandl
Ian Bicking schrieb: > Are there any templates for Sphinx that contain only the minimal > functional structure? That seems like an easier place to start from > when creating a new design... but there is also some styles and > structures that are necessary to have something that works halfway

Re:

2008-10-08 Thread Georg Brandl
Roth, Pierre schrieb: > Hi, > > As said in your script output, I send you back the report issue. > (attached) > > HTH > > Pierre > > > > > WARNING: D:\work\SVN\PYTHON\scmRelease\trunk\contents.rst:: document > isn't inclu > ded in any toctree > writing output... contents index

Re: Support for classmethod and fixed staticmethod arguments in autodoc

2008-10-08 Thread Georg Brandl
Gustavo Picón schrieb: > I was having problems with sphinx recognizing @classmethod as > @staticmethod, and also, in portions of the autodoc extension, static > methods were treated as attributes, so their arguments were missing. > This patch for trunk solves both problems: > > http://groups.goog

Re: Python web frameworks luuuuuv Sphinx!

2008-10-08 Thread Georg Brandl
Sebastien Douche schrieb: > On Mon, Oct 6, 2008 at 04:01, Kevin Teague <[EMAIL PROTECTED]> wrote: >> >> Wow, Sphinx is doing a pretty good job at being adopted as a docs tool >> for Python web frameworks - Grok, Django, Pylons, and repoze.bfg have >> all adopted Sphinx usage in the last few months

Re: accessing bibliographic fields in the template layout.html

2008-10-08 Thread Georg Brandl
Peter Hoffmann schrieb: > Hi, > > I'd like to add meta information from bibliographic fields[1] to the > html head in the template layout.html. Is it possible to access those > fields from inside the template? Or is there an other way to include > this information like rst2html does? They should

0.4.3 released (was Re: UnboundLocalError using .. autoclass::)

2008-10-08 Thread Georg Brandl
Okay... I fixed this in the trunk at one time, but apparently not in the 0.4 branch. I've taken this as the cause to do another 0.4 release, since 0.5 may need some more time. 0.4.3 is now on PyPI! Georg boothead schrieb: > OK some more info: > > This doesn't work: > > .. autoclass:: aws.Debu

Re: Problem with latex and section names starting with accented characters

2008-10-14 Thread Georg Brandl
Roger Demetrescu schrieb: > On Fri, Oct 3, 2008 at 12:56, Roger Demetrescu > <[EMAIL PROTECTED]> wrote: >> Hi all, >> >> I am having some problem with section names like this: >> >> >> Álbuns >> >> >> When I try to build the PDF file, I get this error: >> >> -

Re: best place to report a bug (with patch)?

2008-10-14 Thread Georg Brandl
Trent Mick schrieb: >> There is an issue tracker at Google code (http://code.google.com/p/sphinx), > > Okay, thanks. I'll log a bug there. > > Is Google Code the authoritative repo for sphinx? Or is Python's repo > the one -- as indicated by http://sphinx.pocoo.org/ > > The code can be foun

Re: rst preprocessing?

2008-10-16 Thread Georg Brandl
Ken schrieb: > Is there a simple way to add a hook to pre-process/filter input .rst > files? > > I'm playing around with sphnix/rst to potentially replace writing some > stuff in Latex, but I can't bring myself to write "::math:`N`" each > time for "$N$"; and few other things like this... > > Fo

<    1   2   3   4   5   6   7   8   9   10   >