On Mon, 26 Mar 2012 21:40:29 +1100 Lex Trotman <[email protected]> wrote:
> Note that Sphinx says nothing (that I could find, I might be wrong) > about how to turn your Latex into PDF or anything else and refers to > the rst2pdf docs or users writeups on how they set it up. Hmm...here is some info: make latexpdf runs the LaTeX builder and readily invokes the pdfTeX toolchain for you. (http://sphinx.pocoo.org/tutorial.html#running-the-build) > Then if you like it add to it, if you think the documentation can be > improved do it, or whatever help you can give. Well, in this case, I'd like to have some examples available...but, I'll try to play with it and if something comes up, we'll document it somewhere. > Given that it is a mature tool, (version 8.6.7) Asciidoc is not > evolving as rapidly as new tools like sphinx. So it is not surprising > that Stuart does all fixes/adaptations from a number of sources. He > is the main developer, like George Brandl is for Sphinx. Well, Georg is main force behind it, but if you see the list of the projects using Sphinx (http://sphinx.pocoo.org/examples.html) it's impressive and I'm sure that when the names like Python/Django/Blender/Zope are listed, they won't allow the project to disappear. > > Sure, but from the tool using utf-8 by default one expects to have > > decent support for non-English languages. > > Maybe I have misunderstood, what doesn't work? Well, it's not documented how to e.g. mix two languages, as Chris pointed out. > Of course you should explore all avenues, but if you prefer one format > then contribute to that project. That's a good point. ;) > A lot of the code changes in Sphinx seem to be done by George with > others doing translations etc. But as I said above, Asciidoc is more > mature and isn't going through the big evolutions that Sphinx is still > having. That might be true, although Sphinx looks as safer option if we consider that bus-factor is 1 in both cases. > Note that for PDF Sphinx generates either Latex, after which you need > a Latex toolchain and its attendent customisation, LaTeX/TexLive is something which is always present on my machine. :-) > or rst2pdf which seems to configure with a mixture of Python and Json. > So you still have a learning curve there, although your latex > experience might help you with that method. I cannot say I'm LaTeX expert, but in any case, tweaking it seems to be more human-friendly that writing XSL stylesheets. However, I'll try your suggestion to use Quoted text attributes and see how far I can come. Sincerely, Gour -- Those persons who execute their duties according to My injunctions and who follow this teaching faithfully, without envy, become free from the bondage of fruitive actions. http://atmarama.net | Hlapicina (Croatia) | GPG: 52B5C810
signature.asc
Description: PGP signature
