[sphinx-dev] Creating 3 sets of documentation from shared files

2011-12-16 Thread Kathy Tolbert
Non-developer here new to Sphinx, but surviving (with simple toc trees rst markup) for our main software documentation. I now need to create 3 sets of documentation for a different product with multiple levels that build from the same files (beginner, intermediate advanced) where each

[sphinx-dev] Sphinx docs license-agreement.rst file .. todo:: item

2012-02-15 Thread Kathy Tolbert
While reading the license-agreement.rst file (created by Sphinx quickstart), I noticed there is a question in a todo: .. todo:: why isn't the numbering working here and below? text breaking up the numbering... I ran into this same question recently (I just started using Sphinx this last

Re: [sphinx-dev] Re: Creating 3 sets of documentation from shared files

2012-03-23 Thread Kathy Tolbert
Hi Ramon, Yes, I did get it working on a prototype. But we didn't implement that solution since each set of docs did not use any shared information after all. I believe we used the include directive for the solution in the test docs. I'm traveling today, so I won't be able to access my test

RE: [sphinx-dev] Re: Creating 3 sets of documentation from shared files

2012-03-28 Thread Kathy Tolbert
-- .. include:: ../03_files_cast_advanced/content_advanced.rst Kathy *From:* sphinx-dev@googlegroups.com [mailto:sphinx-dev@googlegroups.com] *On Behalf Of *Kathy Tolbert *Sent:* Friday, March 23, 2012 7:15 AM *To:* sphinx-dev@googlegroups.com

RE: [sphinx-dev] restructred text substitutions available in all files from one include?

2012-05-15 Thread Kathy Tolbert
I'd like to use some of the common symbol entity substitutions afforded by restructured text in my Sphinx docs, using .. include:: isonnums.txt and so forth. Is there a way to include this file once for my whole project, so that I can use the |copy| and similar substitutions in all documents

RE: [sphinx-dev] Problem rendering latex matrices

2012-06-26 Thread Kathy Tolbert
The .. math:: provided builds fine for me for HTML latexpdf with no warnings. I noticed that your warning shows a beginning and ending $ that are not showing in your math example. I always remove the beginning ending $ or \[ markup before adding it to a math directive or role. Does your

Re: [sphinx-dev] Figure caption?

2012-08-30 Thread Kathy Tolbert
Is it somehow possible to have a figure caption different form the text of the link to that figure? This may also help. It is a sphinx extension. We use this to have 'Figure #' display in our HTML output: (numfig extension with the role, :num: )

RE: [sphinx-dev] Minimum toolset need to run latex makefile and generate Sphinx PDF on Windows?

2012-09-18 Thread Kathy Tolbert
Hi all -- How are folks generating PDF via LaTeX on Windows? I have Sphinx and MikTex installed but that still leaves me stuck with how to execute the Makefile that is generated as part of the latex build. Is there a straightforward way to do this without installing cygwin? Is there a minimum

RE: [sphinx-dev] Minimum toolset need to run latex makefile and generate Sphinx PDF on Windows?

2012-09-18 Thread Kathy Tolbert
Another note in my instructions (sent in previously sent email)... ... see below ... Hi all -- How are folks generating PDF via LaTeX on Windows? I have Sphinx and MikTex installed but that still leaves me stuck with how to execute the Makefile that is generated as part of the latex build. Is

Re: [sphinx-dev] Minimum toolset need to run latex makefile and generate Sphinx PDF on Windows?

2012-09-18 Thread Kathy Tolbert
Yes, from a GNU download. Though, I got mine from someone sharing the file. Let me know if you further assistance. ** ** You can can get “make.exe” from the MSYS/Mingw tools at: http://www.mingw.org/wiki/MSYS Kathy On Tue, Sep 18, 2012 at 3:38 PM, Ramon felci...@gmail.com wrote: Thanks

Re: [sphinx-dev] Minimum toolset need to run latex makefile and generate Sphinx PDF on Windows?

2012-09-18 Thread Kathy Tolbert
I can also just send my make file to you directly' just email me at ka...@tolbert.org I'll attach it (with a '.txt' suffix). On Sep 18, 2012, at 3:38 PM, Ramon felci...@gmail.com wrote: Thanks Kathy -- very helpful. Is that make.exe part of MikTex or do you install it separately, e.g.

RE: [sphinx-dev] dvipng -bg Transparent not working(?)

2012-09-20 Thread Kathy Tolbert
Ours work. Here is our line (note the separation of each of the values). # Adding Transparency for math images pngmath_dvipng_args = ['gamma', '1.5', '-D', '110', '-bg', 'Transparent'] Kathy ** I want to get math png-s with transparent background. From sphinx