[sphinx-dev] Re: Section titles not available as links targets?

2009-11-10 Thread Kevin Horn
in order to do this, you have to use Sphinx-specific markup (which are just extensions to ReST...roles, directives, etc.). Here's the link I think you're looking for: http://sphinx.pocoo.org/markup/inline.html#ref-role Kevin Horn --~--~-~--~~~---~--~~ You received

[sphinx-dev] Re: Annotated source code

2009-11-16 Thread Kevin Horn
at for an example of how to do something like this: http://git.savannah.gnu.org/cgit/kenozooid.git/tree/doc/extapi.py Kevin Horn --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group

Re: [sphinx-dev] Floating sidebar, self toctree

2009-12-03 Thread Kevin Horn
directive is behaving correctly. I don't really understand what you want to do here. Thanks in advance, Adam Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com

Re: [sphinx-dev] Evaluation of documentation tools

2009-12-23 Thread Kevin Horn
it's done, it's very nice! Good luck! Kevin Horn I think the best you are likely to do is a partial conversion -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from

Re: [sphinx-dev] Copying Static Files Exception - Access Denied

2010-01-07 Thread Kevin Horn
the svn ones? Or tell it to continue after an error? At the moment it gets the error and stops copying files, which is annoying. Check out the documentation here: http://sphinx.pocoo.org/config.html especially the exclude_dirnames option. Hope this helps... Kevin Horn -- You received

Re: [sphinx-dev] sphinx-build-script.py hangs

2010-01-08 Thread Kevin Horn
, but have turned it on for some reason, just disable it, of course. Kevin Horn -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email

Re: [sphinx-dev] automodule problem

2010-01-15 Thread Kevin Horn
there be an error in your docstrings that is causing the problem? 4. Have you tried just a vanilla .. automodule:: broadwick without the options? Kevin Horn -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email

Re: [sphinx-dev] Re: single column table vs. section header?

2010-02-03 Thread Kevin Horn
-tables-and-doctests/ and a modified version which handles multiline cells here: http://bitbucket.org/khorn/lore2sphinx/src/tip/table.py Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx

Re: [sphinx-dev] FYI: different layout example

2010-02-06 Thread Kevin Horn
files and settings available if there is interest. Cheers, Oliver This is very nice! Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group

Re: [sphinx-dev] Re: autodoc for Java source?

2010-02-24 Thread Kevin Horn
The new domains feature in the upcoming 1.0 should be a good way forward, assuming you can wait that long... see: http://pythonic.pocoo.org/2009/9/12/new-in-sphinx-1-0-domains and: http://pythonic.pocoo.org/2010/1/7/new-year-s-python-meme-and-status Good luck! Kevin Horn On Tue, Feb 23, 2010

Re: [sphinx-dev] Suggestion: absolute paths vs relative paths

2010-03-02 Thread Kevin Horn
+1 2010/3/2 Fernando Gómez fjgo...@gmail.com Hi, Sphinx's docs mention explicitly the difference between relative and absolute paths for the image directive [1]: When used within Sphinx, the file name given (here gnu.png) must either be relative to the source file, or absolute which means

[sphinx-dev] Creating roles in Sphinx extensions

2010-03-04 Thread Kevin Horn
a Sphinx config variable in my role function/class? Pass the Sphinx app object into the function/class in my extensions setup function? Or is there a better way? Thanks, Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group

Re: [sphinx-dev] How to link to internal documents, not to marks within a document

2010-03-15 Thread Kevin Horn
://sphinx.pocoo.org/markup/inline.html#cross-referencing-documents Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr

Re: [sphinx-dev] how to use sphinx extensions

2010-03-15 Thread Kevin Horn
can use autodoc extension but I cant figure out how. Is there any examples to help me ? First thing: look in you conf.py file and make sure that 'sphinx.ext.autodoc' appears in the extensions list then follow the docs here: http://sphinx.pocoo.org/ext/autodoc.html Kevin Horn -- You received

Re: [sphinx-dev] Re: prevent TOCTREE from being displayed

2010-03-15 Thread Kevin Horn
child.parent = self AttributeError: 'NoneType' object has no attribute 'parent' Any idea what might be happening? Thanks for your insight, Andreas. Try taking out the :maxdepth: option Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group

Re: [sphinx-dev] Creating roles in Sphinx extensions

2010-04-05 Thread Kevin Horn
On Mon, Apr 5, 2010 at 3:22 AM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 05.03.2010 00:59, schrieb Kevin Horn: I'm creating a Sphinx extension which just adds a custom docutils role. A couple of questions: 1) What's the opinion of the list

Re: [sphinx-dev] Displaying Docinfo (File-wide metadata)

2010-06-12 Thread Kevin Horn
Thanks, Georg! Perhaps this should be added to the documentation here: http://sphinx.pocoo.org/markup/misc.html#file-wide-metadata ? Kevin Horn On Sat, Jun 12, 2010 at 11:19 AM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 08.06.2010 23:16, schrieb

Re: [sphinx-dev] How to use intersphinx to link to sphinx or python documentation

2010-07-28 Thread Kevin Horn
to actually _work_ first ;) ) Thanks for your help, Chris Good luck! Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev

Re: [sphinx-dev] linking to specific sections of an RFC

2010-08-05 Thread Kevin Horn
urlinclude? Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit

Re: [sphinx-dev] linking to specific sections of an RFC

2010-08-05 Thread Kevin Horn
On Thu, Aug 5, 2010 at 3:45 PM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 05.08.2010 22:12, schrieb Kevin Horn: On Thu, Aug 5, 2010 at 8:42 AM, Georg Brandl ge...@python.org mailto:ge...@python.org wrote: Am 23.07.2010 17:50, schrieb

Re: [sphinx-dev] Programmatic use of sphinx

2010-08-12 Thread Kevin Horn
(...) sphinxApp.builder.build_rst( .. todo :\n\ntest, sphinx.builders.html.StandaloneHTMLBuilder, sphinx.writers.html.HTMLWriter, ) Have you looked at the JSONHTMLBuilder? Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group

Re: [sphinx-dev] Tagging

2010-08-13 Thread Kevin Horn
, by creating a custom directive, and then writing hooks into the sphinx build system to compile the tags from various documents into a coherent whole. I've pondered doing this, but haven't managed to come up with the time yet. Kevin Horn -- You received this message because you are subscribed

Re: [sphinx-dev] ReST Formatting Problem.

2010-08-17 Thread Kevin Horn
/groups specifically set up for ReST questions? Many Thanks Simon try one of the docutils mailing lists: http://docutils.sourceforge.net/docs/user/mailing-lists.html Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post

Re: [sphinx-dev] [SOLVED] Re: ReST Formatting Problem.

2010-08-18 Thread Kevin Horn
you might also be able to use escaped spaces, ie '\ ' (backslash followed by a space), though I haven't tried it It's possible that docutils uses char 160 under the covers when it sees this in the markup, I'm not sure Kevin Horn On Wed, Aug 18, 2010 at 4:06 AM, sffjunkie sffjun...@gmail.com

Re: [sphinx-dev] Figure captions

2010-08-18 Thread Kevin Horn
The ability to have Sphinx auto-generate an index/list of figures or an index/list of tables would be really nice. I haven't found a way to do it so far (though admittedly it's not high on my priority list). Kevin Horn On Wed, Aug 18, 2010 at 4:31 PM, David dwarnol...@suddenlink.net wrote

Re: [sphinx-dev] Indexing

2010-08-18 Thread Kevin Horn
an index role (as opposed to a directive), which I presume (guessing) would allow you to do something like: This :index:`term` is in the index. I don't think this has been implemented yet, though. Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev

Re: [sphinx-dev] :download: versus :doc:

2010-08-18 Thread Kevin Horn
source files, etc. using :download: will also cause sphinx to put the referenced file in the built sphinx project (at least when building html) so that viewers of the html can download the file see also: http://sphinx.pocoo.org/markup/inline.html#cross-referencing-documents Kevin Horn -- You

Re: [sphinx-dev] Caption option for literalinclude

2010-10-15 Thread Kevin Horn
stuff/pre /div /div Regards, Vinay Sajip I haven't found a way to do this yet, but it's certainly a feature I'd like to see. Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx

Re: [sphinx-dev] An index of methods, and a page per method instead of having all of them in a web page

2010-12-10 Thread Kevin Horn
the stub pages for you as well. Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more

[sphinx-dev] Why won't this code highlight?

2011-01-11 Thread Kevin Horn
with pygments. ??? Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit

Re: [sphinx-dev] Re: Why won't this code highlight?

2011-01-12 Thread Kevin Horn
On Wed, Jan 12, 2011 at 2:30 AM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Am 12.01.2011 07:43, schrieb Kevin H: On Jan 12, 12:37 am, Kevin Horn kevin.h...@gmail.com wrote: here is a page of output from a sphinx project: http

Re: [sphinx-dev] Project-wide includes

2011-01-14 Thread Kevin Horn
RestructuredText at teh beginning or end of every file using the rst_prolog and rst_epilog config values in your build config file, as described here: http://sphinx.pocoo.org/config.html#confval-rst_epilog Is that what you were looking for? Kevin Horn -- You received this message because you

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

2011-01-24 Thread Kevin Horn
-integration I usually use a fabric task myself (run manually). Kevin Horn -- 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 from this group, send email to sphinx-dev

Re: [sphinx-dev] :wikipedia: extenstion?

2011-03-18 Thread Kevin Horn
Not that I know of, though it should be fairly trivial to do. A better solution is probably to use the extlinks extension, though, unless your proposed wikipedia extension would do something that extlinks wouldn't. Kevin Horn On Fri, Mar 18, 2011 at 7:52 PM, cool-RR ram.rac...@gmail.com wrote

Re: [sphinx-dev] :wikipedia: extenstion?

2011-03-18 Thread Kevin Horn
out the sphinx-contrib repo for examples: https://bitbucket.org/birkenfeld/sphinx-contrib Kevin Horn On Fri, Mar 18, 2011 at 8:03 PM, cool-RR cool...@cool-rr.com wrote: Can the extlinks extension replace with _, and possibly other transformations that Wikipedia requires? On Fri, Mar 18, 2011

Re: [sphinx-dev] Convert latex to rst/sphinx

2011-04-12 Thread Kevin Horn
because it converts it to general rst, and sphinx uses rst with some extensions?) kind regards, Joris Somewhere in the Python source tree is a script that was used to convert the Python documentation from Latex to Sphinx/rst. Maybe that would help? Kevin Horn -- You received this message

Re: [sphinx-dev] How would you include huge tables?

2011-05-25 Thread Kevin Horn
and https://bitbucket.org/khorn/lore2sphinx/src/7b0939832687/lore2sphinx/table.py Kevin Horn -- 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 from this group, send email

Re: [sphinx-dev] New Theme Feedback Request

2011-06-30 Thread Kevin Horn
...they just don't seem to fit quite right with the rest of the design I hope you continue working on this. It looks really neat, and the Sphinx world can always use more themes! Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post

Re: [sphinx-dev] Re: conditional exclusion of rst files

2011-08-01 Thread Kevin Horn
The only directive might be useful too, depending on your use case. Kevin Horn On Mon, Aug 1, 2011 at 4:03 AM, Alastair Dent alastair.d...@imgtec.comwrote: Hi, I found I could do this using ifconfig extension and the exclusion list in config.py. The ifconfig extension allows you

Re: [sphinx-dev] how to specify the default for a function parameter

2011-08-03 Thread Kevin Horn
this isn't exactly what you are asking, but between putting the default in the description, and potentially having it shown in the function signature, this seems like it would be good enough for many use cases. YMMV Kevin Horn -- You received this message because you are subscribed to the Google

Re: [sphinx-dev] Blogging with Sphinx

2011-12-15 Thread Kevin Horn
request to the tracker. Thanks for this! Kevin Horn On Thu, Dec 15, 2011 at 11:34 AM, Vlad Riscutia riscutiav...@gmail.comwrote: tinker --build removes the blog subdirectory under the current directory (which should be build output) then invokes Sphinx. Indeed it looks like if your blog root

Re: [sphinx-dev] Re: mixing fonts or reST/Sphinx vs. AsciiDoc

2012-03-28 Thread Kevin Horn
directly from the Rst source, bypassing the LaTeX step. YMMV. Either way, I'd choose Sphinx over AsciiDoc, though that may be personal preference. Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email to sphinx

Re: [sphinx-dev] indentation issues with flushed left text

2012-04-24 Thread Kevin Horn
of items 2 and 3 (so they have more than one line each) Kevin Horn -- 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 from this group, send email to sphinx-dev+unsubscr

Re: [sphinx-dev] Re: howto create autodoc support for a custom domain?

2012-06-22 Thread Kevin Horn
and let us know how it goes! Kevin Horn -- 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 from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more

Re: [sphinx-dev] Contributions in TODO, autodoc and general

2012-07-25 Thread Kevin Horn
://bitbucket.org/birkenfeld/sphinx Cheers, Kevin That would be my suggestion as well. Kevin Horn -- 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 from this group, send

Re: [sphinx-dev] Sphinx doesn't highlight my code block :-(

2012-09-17 Thread Kevin Horn
to put .. code-block:: actionscript. All that with no success. TIA Vitalije It will be easier to help you if you can show us the block you are trying to highlight. Kevin Horn -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group