[sphinx-dev] Search function does not work on terms including a hyphen/minus sign

2012-08-14 Thread daspostloch
Hi, when searching for something like "in-class" or "sub-system", or also just "in-" or "sub-", the search does not find the corresponding words. No idea if you want to support this, but I thought I'd report that it doesn't work :) To make sure that this is not an issue of different "hyphen" enc

[sphinx-dev] Re: Exception in png.py / write_png_depth : Bug or Document problem?

2012-01-16 Thread daspostloch
Found it: this was a problem with pngmath_use_preview . Not sure why it suddenly stopped working, but disabling it solved my problem. On Jan 13, 10:35 am, daspostloch wrote: > Hi, > > when compiling my project documentation I get the following error: > > preparing documents...

[sphinx-dev] Exception in png.py / write_png_depth : Bug or Document problem?

2012-01-13 Thread daspostloch
Hi, when compiling my project documentation I get the following error: preparing documents... done writing output... [ 27%] my_project/pageA Exception occurred: File "/home/.../build/lib/python/Sphinx-1.1.2-py3.2.egg/sphinx/util/ png.py", line 54, in write_png_depth f.write(struct.pack('!i'

Re: [sphinx-dev] exclude_patterns not working

2011-07-20 Thread daspostloch
rom: sphinx-dev@googlegroups.com [mailto:sphinx-dev@googlegroups.com] On Behalf Of daspostloch Sent: 20 July 2011 15:39 To: sphinx-dev@googlegroups.com Subject: Re: [sphinx-dev] exclude_patterns not working are they also *linked/produced* in the html output pages in addition to being copied? (they shoul

Re: [sphinx-dev] exclude_patterns not working

2011-07-20 Thread daspostloch
are they also *linked/produced* in the html output pages in addition to being copied? (they shouldn't be) there has been another thread like this in the archives. imo it's a bug of sphinx to copy files that are ignored and not used to produce html output. On 07/20/2011 04:28 PM, Alastair Dent w

Re: [sphinx-dev] Unusual error when updating conf.py

2011-06-19 Thread daspostloch
i usually build via 'make clean html' -paul On 06/15/2011 04:01 AM, Andrew Tipton wrote: Hello all, I've encountered a fairly bizarre Sphinx error (now solved) which I wanted to share with the list. I'm a new user of Sphinx, and this was my first try at using it to document something. I star

Re: [sphinx-dev] Linking to external sphinx projects to create multilanguage docs

2011-05-26 Thread daspostloch
hm, not enough time to ensure an exactly matching answer -- but as answers are a bit rare here, i'll give it a quick shot: take a look at intersphinx, at the pagename global variable: http://sphinx.pocoo.org/templating.html#pagename or/and at construcs like this for getting "out" of root sphinx d

[sphinx-dev] placing the toctree where and in how many parts i want

2011-05-17 Thread daspostloch
Hi all, is there a way to put the toctree in a sub-section of a page rather than on the top of it? If I do that, links and pages will be produced correctly, but I get warnings that the documents are not included, and indeed the sidebar navigation does not consider the pages included by that toctr

Re: [sphinx-dev] Re: Is it possible to customise the mapping from ReST headings to HTML headings?

2011-04-11 Thread daspostloch
That's a possible workaround. I didn't want to go that route as I'll then have to maintain two stylesheets. I was hoping to be able to demonstrate that Sphinx would lower our maintenance overhead for documentation, and complicating the stylesheet situation undermines this, but it's not a deal-brea

Re: [sphinx-dev] Is it possible to customise the mapping from ReST headings to HTML headings?

2011-04-11 Thread daspostloch
On 04/10/2011 03:30 AM, Tim Martin wrote: I can't see a way to generate the h1 and h2 headings from ReST but insert the standard generated text into it (without having that text repeated in every ReST file). not sure if you want or dont want it, but have you looked at rst_prolog in conf.py? T

[sphinx-dev] self-coloring admonitions?

2011-04-03 Thread daspostloch
Hi all, almost always i use self-defined admonitions, i.e., rather than .. tip:: Linux users can , i find myself using .. admonition:: Linux users You can... Still, I don't want my admonitions to all have the same color. And I revolt at the thought of labeling a hint as a danger jus

Re: [sphinx-dev] Problem with ToC

2011-03-04 Thread daspostloch
Hm, just a guess, but have you tried the toctree directive before your > Contents > headline? Best, Paul On 03/03/2011 05:10 PM, Jeffrey Barish wrote: My contents.rst looks something like Contents .. toctree:: :maxdepth: 3 page1 page2 When I am at the ToC,

Re: [sphinx-dev] How to create Sphinx documentation with accents (french, portuguese...)

2011-02-25 Thread daspostloch
Do these links help? http://sphinx.pocoo.org/rest.html#source-encoding http://sphinx.pocoo.org/tutorial.html#basic-configuration For me, I have no problems with the raw line Exposé üß in my .rst file. Maybe check if your editor encoding matches what Sphinx assumes (UTF8)? Good luck -Paul

[sphinx-dev] Messing with the 'toc' global variable

2011-02-24 Thread daspostloch
Hi, about the global 'toc' variable ( http://sphinx.pocoo.org/templating.html#toc ): How would one modify what lives inside that variable, or how can I modify how the contents are shown? Can one templatify it via some Jinja magic? There are several modifications I have in mind, but let's star

Re: [sphinx-dev] GSoC and Breathe

2011-02-18 Thread daspostloch
I am actually still eligible for GSoC this year and personally also would like to have this feature, but I'm not sure whether I should apply. I was bound to an internship for 1.5 months that overlaps with GSoC... Under these circumstances it would be a bad idea :) -- You received this message b

Re: [sphinx-dev] GSoC and Breathe

2011-02-18 Thread daspostloch
On 02/18/2011 01:58 PM, Leontius Adhika Pradhana wrote: > Sorry for the double post, but I wrote my last post thinking that Paul is a > student that wanted to apply for GSoC. I just realized that that might not > be the case, so if the above sounds condescending in any way, I truly > apologize.

Re: [sphinx-dev] GSoC and Breathe

2011-02-17 Thread daspostloch
Leon, thanks for your answer and all the information. Your proposals sounds very interesting, although quite heavy for 3 months. I guess we have to acknowledge that there are cascading scenarios, starting from linking to doxygen, replacing doxygen's html output, and replacing doxygen. While the

[sphinx-dev] GSoC and Breathe

2011-02-17 Thread daspostloch
Hi all, Having installed Sphinx only some days ago, I quickly had a look into the Doxygen/XML bridge Breathe [1] written by Micheal Jones. I found the idea very neat. Sphinx has become one of the de-facto standards for python documentation, and it seems plausible that it would have major impact

[sphinx-dev] stickysidebar with header block in layout.html

2011-02-13 Thread daspostloch
Hi, first of all thanks for Sphinx, I find it amazing. Now: in the default theme, if I set "stickysidebar": "true" and also specify a header image in _templates/layout.html via {% extends "!layout.html" %} {% block header %} {% endblock %} Then the sticky sidebar does not honor the logo, i.