Re: How do I convert a word document to reStructured text?
Another hurried answer : I would try to convert to open document first using open office, then use sxw2rest that is mentioned here : http://docutils.sourceforge.net/docs/user/links.html#import My 2 cents, Christophe 2008/10/28 Martin Hans [EMAIL PROTECTED] Hi, Currently our product's user manual is written in Word, but we'd like to move all our documentation into Sphinx. Does anybody have an idea how I can do this at least partially automatically? Thanks. Martin --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Single-File HTML Builder, Sphinx-Build Output, rst2pdf
I've been acting as something of a Sphinx advocate for a project looking to convert documentation to reStructuredText. A few issues have come up from someone that supports just using one giant reST document (split into separate source files with the include directive). I'm curious if anyone else has spent time on these issues and has suggestions or solutions. 1) I think a split-HTML approach is better, but the person I'm debating with has a preference for a giant single-file HTML build. Does anyone have a working single-file HTML builder or interest in writing one? 2) The person I'm debating with has said that on dumb terminals sphinx-build outputs ANSI where it is not appropriate and thus produces unreadable output. Should I ask him to clarify how he tested this or should I make the suggestion that sphinx-build test its environment before outputting color sequences? (Personally, I like the colors, but this person says that dumb terminals and colorless-ttys are common in his build environment.) 3) What is the status on integrating rst2pdf with Sphinx? Does anyone have any quick instructions or work in progress code for doing rst2pdf builds that I can look 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, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
As for PDF generation, just generate LaTeX and generate PDF from that (I do it on a PC w/ MikTeX driven by WinEdt - I know nothing about LaTeX, and it works great). On Tue, Oct 28, 2008 at 6:44 PM, chris [EMAIL PROTECTED] wrote: Try from sphinx.util.console import nocolor nocolor() I'm pretty sure this is how the Sphinx setuptools extension works so that garbage isn't printed out when running on Windows. -Chris (C) On Tue, Oct 28, 2008 at 6:25 PM, Mark Eichin [EMAIL PROTECTED] wrote: On Tue, Oct 28, 2008 at 6:50 PM, Max Battcher [EMAIL PROTECTED] wrote: 2) The person I'm debating with has said that on dumb terminals sphinx-build outputs ANSI where it is not appropriate and thus produces unreadable output. Should I ask him to clarify how he tested this or should I make the suggestion that sphinx-build test its environment before outputting color sequences? (Personally, I like the colors, but this person says that dumb terminals and colorless-ttys are common in his build environment.) I filed that as a debian bug (#501629 but it looks like #503053 is also similar) and it was marked forwarded (here?) already. it's easy enough to test - just use m-x compile in emacs to run any of the sphinx commandline tools, and notice that they're full of garbage :-) I suggested a few possible fixes. It's definitely a bug (fortunately there's the -N workaround.) It's not a matter of liking color or not, it's a matter of what you get when you don't have it -- _Mark_ [EMAIL PROTECTED] [EMAIL PROTECTED] --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
Yarko T wrote: As for PDF generation, just generate LaTeX and generate PDF from that (I do it on a PC w/ MikTeX driven by WinEdt - I know nothing about LaTeX, and it works great). The problem is not that the latex doesn't work, it's that rst2pdf and reportlab is a *lot* easier to setup (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, send email to sphinx-dev@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
On Tuesday 28 October 2008 20:50:06 Max Battcher wrote: 3) What is the status on integrating rst2pdf with Sphinx? Does anyone have any quick instructions or work in progress code for doing rst2pdf builds that I can look at? I had something working and deleted it when reinstalling my notebook. Since I am leaving for Latinoware today I won't be able to try again for a week or so. However, what I got in my previous attempt was a bazillion PDFs, which is not exactly the nicest result. So, this single-file HTML builder should be a good starting point for rst2pdf integration (perhaps just changing calls to the HTML writer to the rst2pdf- provided writer). I would appreciate any pointers in that direction, too. -- (\''/).__..-''`-. . Roberto Alsina `9_ 9 ) `-. ().`-._.`) KDE Developer (MFCH) (_Y_.)' ._ ) `._`. -.-' http://lateral.netmanagers.com.ar _..`-'_..-_/ /-'_.' The 6,855th most popular site of Slovenia (l)-'' ((i).' ((!.' according to alexa.com (27/5/2007) Debugging is twice as hard as writing the code in the first place. Therefore, if you write the code as cleverly as possible, you are, by definition, not smart enough to debug it. --Brian W. Kernighan --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
On Oct 28, 2008, at 10:36 PM, Max Battcher wrote: Yarko T wrote: As for PDF generation, just generate LaTeX and generate PDF from that (I do it on a PC w/ MikTeX driven by WinEdt - I know nothing about LaTeX, and it works great). The problem is not that the latex doesn't work, it's that rst2pdf and reportlab is a *lot* easier to setup (and make sure is correctly setup) than a latex environment and all of its dependencies. Once Georg pointed me to it, I found the TeX Live package to be *incredibly* easy to install: http://www.tug.org/texlive/acquire.html It includes all of the pieces you need to make PDFs using the LaTeX output created by sphinx. Doug --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
I had a similar experience w/ MiKTeX on my PC I tried getting reportlab setup (didn't try too hard) , but something was missing / had trouble / didn't work. I installed MiKTeX and had NO idea what packages I needed, fonts to make, etc. etc. So I tried LyX. It seemed to work w/ MiKTeX, but I was helping edit a book written in LaTeX for AW, and LyX had trouble with that (actually, I couldn't send back changes easily)... Which lead me to WinEdt - It fired MiKTeX, and loaded all the missing pieces, builds all the needed fonts - I just watch... It Works for me; I like it. YMMV Yarko. But there's the ticket - whatever works for you. On Tue, Oct 28, 2008 at 10:12 PM, Doug Hellmann [EMAIL PROTECTED]wrote: On Oct 28, 2008, at 10:36 PM, Max Battcher wrote: Yarko T wrote: As for PDF generation, just generate LaTeX and generate PDF from that (I do it on a PC w/ MikTeX driven by WinEdt - I know nothing about LaTeX, and it works great). The problem is not that the latex doesn't work, it's that rst2pdf and reportlab is a *lot* easier to setup (and make sure is correctly setup) than a latex environment and all of its dependencies. Once Georg pointed me to it, I found the TeX Live package to be *incredibly* easy to install: http://www.tug.org/texlive/acquire.html It includes all of the pieces you need to make PDFs using the LaTeX output created by sphinx. Doug --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---
Re: Single-File HTML Builder, Sphinx-Build Output, rst2pdf
Just looked at that TeX Live link - will have to check that out (some weekend, or on another PC). Thanks for the link. On Tue, Oct 28, 2008 at 11:28 PM, Yarko T [EMAIL PROTECTED] wrote: I had a similar experience w/ MiKTeX on my PC I tried getting reportlab setup (didn't try too hard) , but something was missing / had trouble / didn't work. I installed MiKTeX and had NO idea what packages I needed, fonts to make, etc. etc. So I tried LyX. It seemed to work w/ MiKTeX, but I was helping edit a book written in LaTeX for AW, and LyX had trouble with that (actually, I couldn't send back changes easily)... Which lead me to WinEdt - It fired MiKTeX, and loaded all the missing pieces, builds all the needed fonts - I just watch... It Works for me; I like it. YMMV Yarko. But there's the ticket - whatever works for you. On Tue, Oct 28, 2008 at 10:12 PM, Doug Hellmann [EMAIL PROTECTED]wrote: On Oct 28, 2008, at 10:36 PM, Max Battcher wrote: Yarko T wrote: As for PDF generation, just generate LaTeX and generate PDF from that (I do it on a PC w/ MikTeX driven by WinEdt - I know nothing about LaTeX, and it works great). The problem is not that the latex doesn't work, it's that rst2pdf and reportlab is a *lot* easier to setup (and make sure is correctly setup) than a latex environment and all of its dependencies. Once Georg pointed me to it, I found the TeX Live package to be *incredibly* easy to install: http://www.tug.org/texlive/acquire.html It includes all of the pieces you need to make PDFs using the LaTeX output created by sphinx. Doug --~--~-~--~~~---~--~~ 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 [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~--~~~~--~~--~--~---