Re: [sphinx-dev] sphinxcontrib settings file

2011-12-28 Thread Max Battcher
and pure python flexibility they might need. Does that make sense? -- --Max Battcher-- http://www.worldmaker.net/ -- 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

Re: [sphinx-dev] sphinxcontrib settings file

2011-12-25 Thread Max Battcher
than a home directory folder. -- --Max Battcher-- http://www.worldmaker.net/ -- 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] Follow up: How to manage many versions?

2011-12-18 Thread Max Battcher
follow their progress) including SCS-based multi-version documentation. Hope that helps, --Max Battcher -- 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

Re: [sphinx-dev] Problem in highlight color of source code

2011-12-18 Thread Max Battcher
On Wednesday, November 9, 2011, Manuel Bastioni mbasti...@gmail.com wrote: Hi, I'm the admin of the open source project makehuman ( http://www.makehuman.org). We are going to use Sphinx (thanks for it guys!) to document our software. It works fine in linux, but our windows developers have a

Re: [sphinx-dev] Re: secondary windows or hidden sections in html output

2010-09-16 Thread Max Battcher
, that is my opinion. -- --Max Battcher-- http://worldmaker.net -- 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] a shortcut for :doc:`script_1` and .. literalinclude:: script_1.rst

2010-07-24 Thread Max Battcher
-highlighted source files: http://sphinx.pocoo.org/ext/viewcode.html -- --Max Battcher-- http://worldmaker.net -- 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] Namespace packages

2010-06-25 Thread Max Battcher
global one on python path using ``python setup.py develop`` or ``pip install -e``. Hope that helps, -- --Max Battcher-- http://worldmaker.net -- 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] A way to reuse hyperlinks?

2010-06-25 Thread Max Battcher
links you may also want to consider a custom role (such as :rfc:`822` might be used for RFC documents) or even a missing reference fallback. If the external links lead to other Sphinx documentation sites, you should look into the intersphinx extension. -- --Max Battcher-- http://worldmaker.net

Re: [sphinx-dev] Context sensitive help

2010-06-04 Thread Max Battcher
in your application. You can look at the documentation/source for the Inter-Sphinx extension if you want a bit of help (objects.inv was added primarily for Inter-Sphinx, but should work just as well for your project). -- --Max Battcher-- http://worldmaker.net -- You received this message

Re: [sphinx-dev] Crossrefs...

2010-06-04 Thread Max Battcher
readability, too. -- --Max Battcher-- http://worldmaker.net -- 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] Sphinx 1.0 beta 1 and 0.6.6 released

2010-05-28 Thread Max Battcher
it with pip (``pip install sphinx==0.6.6``). (Pip is just generally better than easy-install and I recommend using it more.) -- --Max Battcher-- http://worldmaker.net -- 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: Unexpected indentation. with no explainable cause

2010-04-19 Thread Max Battcher
/cleaner as well, but I realize that some people prefer the jagged original.) -- --Max Battcher-- http://worldmaker.net -- 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

Re: [sphinx-dev] citation with abbreviated first name interpreted as enumeration

2010-04-05 Thread Max Battcher
backlash on the space... ie: F.\ Alonso -- --Max Battcher-- http://worldmaker.net -- 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] Included non-rst files not copied to _source directory

2010-03-29 Thread Max Battcher
to your toctree? reminder than a Whoops, things are broken because you have a document that you haven't put into a toctree. I think that maybe the documentation you cited should be rewritten as well. -- --Max Battcher-- http://worldmaker.net -- You received this message because you

Re: [sphinx-dev] Split table of contents

2010-03-23 Thread Max Battcher
--- Description of a bar. .. toctree:: ... -- --Max Battcher-- http://worldmaker.net -- 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

Re: [sphinx-dev] Double Hyphen Rendering

2010-03-16 Thread Max Battcher
of smartypants out there that mistakenly do, and if that was your problem it is a simple matter of upgrading.) The best way to deal with this particular instance is to use an inline reST literal, which would be to quote the command line option in double-backquotes as in ``--version``. -- --Max

Re: [sphinx-dev] List Creation in Sphinx

2010-03-03 Thread Max Battcher
classes for non-numeric ordered lists into the standard theme. You can copy them yourself if you find it important. -- --Max Battcher-- http://worldmaker.net -- 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] Creating documents other than technical documentation -- is there no interest in this regard?

2010-01-12 Thread Max Battcher
of this evolution: http://pythonic.pocoo.org/2009/9/12/new-in-sphinx-1-0-domains -- --Max Battcher-- http://worldmaker.net -- 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] Fwd: repetitive url pattern

2009-12-07 Thread Max Battcher
more repetitive than that and follows a deeper pattern (or could be auto-generated from your source control system), you may also, or instead, consider writing Docutils directive to further simplify things. -- --Max Battcher-- http://worldmaker.net -- You received this message because you

[sphinx-dev] Re: Section headings in docstrings

2009-10-08 Thread Max Battcher
(or epydoc for that matter). -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ 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

[sphinx-dev] Re: forcing page breaks

2009-09-22 Thread Max Battcher
On 9/21/2009 19:35, Max Battcher wrote: .. cssclass:: pagebreak Or just .. class:: once the code directive renaming takes place, of course. Paragraph or section or whatever... Then add to the stylesheet: .pagebreak { page-break-before: always } Following this approach to its logical

[sphinx-dev] Re: forcing page breaks

2009-09-21 Thread Max Battcher
example: .. raw:: html br style=page-break-after: always / Another approach might be: .. cssclass:: pagebreak Paragraph or section or whatever... Then add to the stylesheet: .pagebreak { page-break-before: always } -- --Max Battcher-- http://worldmaker.net

[sphinx-dev] Re: Possible new directive for Sphinx-Crunchy bridge

2009-09-15 Thread Max Battcher
general usage of it that there is interest/demand in making it more accessible in Sphinx. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group

[sphinx-dev] Re: Inlining images and putting images into section titles

2009-09-12 Thread Max Battcher
Sphinx hides docutils' class directive, because of its code markup directives. In current versions of Sphinx the docutils class directive is named cssclass... .. cssclass:: incompatible This will change in a future of Sphinx and I thought it had already happened. -- --Max Battcher-- http

[sphinx-dev] Re: Slideshow with Sphinx

2009-08-24 Thread Max Battcher
the existing docutils backend). It also might be neat to see a Sphinx-inspired S5 CSS. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send

[sphinx-dev] Re: Sphinx for SQL?

2009-08-23 Thread Max Battcher
that helps, -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ 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

[sphinx-dev] Re: Question Regarding Sphinx for Document Creation

2009-07-13 Thread Max Battcher
can chime in. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ 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

[sphinx-dev] Re: Question Regarding Sphinx for Document Creation

2009-07-12 Thread Max Battcher
Kevin F. Benz wrote: I had tried that but all I see is a question mark in the final output. You may want to try double checking your source_encoding in conf.py: http://sphinx.pocoo.org/config.html#confval-source_encoding -- --Max Battcher-- http://worldmaker.net

[sphinx-dev] Re: Question Regarding Sphinx for Document Creation

2009-07-11 Thread Max Battcher
requirements to escape the unicode for the HTML and LaTeX environments as necessary. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send

[sphinx-dev] Re: embed html tags

2009-06-24 Thread Max Battcher
you need: http://docutils.sourceforge.net/docs/ref/rst/directives.html#raw-data-pass-through Example: .. raw:: html !-- Your video embed code. -- -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you

Re: class renaming - feedback needed!

2009-05-13 Thread Max Battcher
suggestions have been concrete-class (together with a new abstract-class), sclass, pclass, and cls. apiclass, perhaps? -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev

Re: Status update

2009-05-03 Thread Max Battcher
, codeattribute, etc. I think that I'm leaning towards the suggestion later in this thread of namespacing all of the directives with code.. It may even be useful to do the same with the auto- directives, such that you get code.module and code.automodule or possibly auto.module. -- --Max Battcher-- http

Re: Lists enumerated by letters or roman numerals

2009-04-21 Thread Max Battcher
in reST/Sphinx are handled by adding an appropriate class to the list class (for example, ol class=roman) and if for whatever reason your current CSS file is missing the appropriate classes, then you'll just get numbers rather than letters/roman numbers. -- --Max Battcher-- http

Re: [GSoC] Some web app idea questions

2009-03-21 Thread Max Battcher
the many different ways projects host their documentation (static pages, wikis, forums, FAQ tools) and question what and how things apply to Sphinx. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you

Re: Summer of Code

2009-03-19 Thread Max Battcher
/ Supposedly you could use Wikir to bootstrap Sphinx MediaWiki output. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email

Re: Another website uses Sphinx

2009-02-15 Thread Max Battcher
see there being at least one or two generally useful recipes from what you cooked up. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group

Re: memcache error

2009-01-12 Thread Max Battcher
(an attempt to do a docstring import on a module that needs some sort of settings/pre-setup dependency and is lacking good fail-over for the documentation build) and not a problem of Sphinx itself. You probably need to ask about this issue in the appropriate TurboGears forum... -- --Max Battcher-- http

Re: Bug Report: new line for lists

2009-01-01 Thread Max Battcher
blocks: http://docutils.sourceforge.net/docs/user/rst/quickref.html#literal-blocks Hopefully that helps, -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group

RE: How to inter-link Sphinx projects?

2008-11-03 Thread Max Battcher
, just have a new .. toctree in your requirements.rst that has the path to progA. You may also want to take a look at Inter-Sphinx: http://sphinx.pocoo.org/latest/ext/intersphinx.html -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received

Single-File HTML Builder, Sphinx-Build Output, rst2pdf

2008-10-28 Thread Max Battcher
at? Thanks, -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ 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

Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf

2008-10-28 Thread Max Battcher
(and make sure is correctly setup) than a latex environment and all of its dependencies. -- --Max Battcher-- http://worldmaker.net --~--~-~--~~~---~--~~ You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group