[sphinx-dev] Images in html and pdf output

2010-12-08 Thread cgTobi
Hi all, I am new to sphinx and reST. I am putting together a documentation with some screenshots. In the html output the embedded screenshots look perfectly fine but when generating the pdf with rst2pdf the images are way too small. Is there a way to correct the images only for the pdf? Thanks

Re: [sphinx-dev] Re: Forewords / Preface

2010-12-08 Thread Reinout van Rees
On 12/07/2010 10:35 AM, Lennart Regebro wrote: So obviously you can't use book, but*must* use report. Or something. I don't know, LaTeX is a mess, and Sphinx on top of it doesn't help. Both the world of LaTeX and Sphinx support for it should be simplified. Maybe I'll work on that if I ever

[sphinx-dev] Referencing a file outside of the document root

2010-12-08 Thread Reinout van Rees
Hi, In my project, I've got a doc/ subdirectory with the index.txt and the rest of the documentation, so something like this: myproject/ myproject/README.txt myproject/setup.py myproject/doc/ myproject/doc/index.txt myproject/doc/conf.py What I want: include the README.txt, CHANGES.txt,

[sphinx-dev] Question about Verbatim redefinition

2010-12-08 Thread Lennart Regebro
In sphinx.sty there is a redefinition of Verbatim. In that there is a line \noindent\hspace*{-\leftsidespace}% What does it do? If I keep that line in sphinx.sty, every single literalinclude will produce the error: Overfull \hbox (36.135pt too wide) in paragraph at lines 4898--4898

Re: [sphinx-dev] Re: Forewords / Preface

2010-12-08 Thread Lennart Regebro
On Tue, Dec 7, 2010 at 11:50, Reinout van Rees rein...@vanrees.org wrote: Alternative (what I did for my PhD thesis): use restructured text for as long as possible and, near the end, generate the latex stuff and continue working and tweaking with that. I'm already disappointed with the amount

Re: [sphinx-dev] Referencing a file outside of the document root

2010-12-08 Thread Michael P. Soulier
On 06/12/10 Reinout van Rees said: Hi, In my project, I've got a doc/ subdirectory with the index.txt and the rest of the documentation, so something like this: myproject/ myproject/README.txt myproject/setup.py myproject/doc/ myproject/doc/index.txt myproject/doc/conf.py What I

Re: [sphinx-dev] Re: Forewords / Preface

2010-12-08 Thread Michael P. Soulier
On 07/12/10 Reinout van Rees said: Alternative (what I did for my PhD thesis): use restructured text for as long as possible and, near the end, generate the latex stuff and continue working and tweaking with that. rst2pdf is also a nice alternative... But, the LaTeX output must be solid.

Re: [sphinx-dev] Re: Forewords / Preface

2010-12-08 Thread Lennart Regebro
On Wed, Dec 8, 2010 at 19:20, Michael P. Soulier msoul...@digitaltorque.ca wrote: On 07/12/10 Reinout van Rees said: Alternative (what I did for my PhD thesis): use restructured text for as long as possible and, near the end, generate the latex stuff and continue working and tweaking with

Re: [sphinx-dev] Re: Forewords / Preface

2010-12-08 Thread Michael P. Soulier
On 08/12/10 Lennart Regebro said: Well, for that we'd need a rst builder in Sphinx, as Sphinx has several custom commands rst2pdf doesn't understand. :-) You mean like this? extensions = ['rst2pdf.pdfbuilder'] Mike -- Michael P. Soulier msoul...@digitaltorque.ca Any intelligent fool can

[sphinx-dev] Re: Question about Verbatim redefinition

2010-12-08 Thread Guenter Milde
On 2010-12-08, Lennart Regebro wrote: In sphinx.sty there is a redefinition of Verbatim. In that there is a line \noindent\hspace*{-\leftsidespace}% What does it do? It sets the left margin/indentation. If I keep that line in sphinx.sty, every single literalinclude will produce the

[sphinx-dev] Re: Images in html and pdf output

2010-12-08 Thread Guenter Milde
On 2010-12-07, cgTobi wrote: Hi all, I am new to sphinx and reST. I am putting together a documentation with some screenshots. In the html output the embedded screenshots look perfectly fine but when generating the pdf with rst2pdf the images are way too small. Is there a way to correct the