On Jan 30, 2013, at 10:10 AM, Vraj Mohan wrote: > Is there any interest in having this fixed?
I'd love someone to take it on and fix it, sure. I've been asking around for help for years, as I still see people publishing entire books with LaTeX. To proceed here, just learn how to do the Sphinx build and then figure out how to get "make pdf" to proceed without warnings. There's this very strange aspect of LaTex which is that it has to be run *twice* (or more?) in order to generate the PDF file with the table of contents included - the first run, you get a PDF without a TOC. The Sphinx Makefile attempts to do this but because our build spits out so many warnings, it has to be fought with in order to proceed. The readthedocs environment doesn't seem to be able to get through this (though it has in the past, I've no idea why). I've asked people before about this seemingly ridiculous "generate twice" requirement of LaTeX and I get these incredulous answers like "why? what's wrong with running it twice?", as though I'm being unreasonable. As I continue to see people swearing by LaTeX, the entire field is just very disturbing to me. > I am new to SQLAlchemy and > am keen to learn both SQLAlchemy and Sphinx, and have some time to > spare. If there's not much interest in the PDFs, I am open to help in > other areas. > > --Vraj > > On Wed, Jan 30, 2013 at 9:41 AM, Michael Bayer <[email protected]> > wrote: >> the PDFS have generated very poorly for quite some time and readthedocs >> environment is not able to adapt to the many warnings it generates for >> SQLAlchemy's documentation. I've was n the Sphinx list a few years ago at >> this point asking for solutions regarding some of these warnings and was not >> able to get help on them - some of the constructs that Sphinx allows (and >> which we really need, namely code examples underneath a :param:) aren't >> compatible with their LaTeX model. I don't have the resources personally >> to keep banging my head against the immensely antiquated LaTeX tools, not to >> mention readthedocs not getting around to fixing things either, so I've >> taken the PDF links off the site. >> >> >> >> >> On Jan 30, 2013, at 2:50 AM, Vraj Mohan wrote: >> >> Hi, >> >> I noticed that documents in PDF for 0.8 and development are not being >> generated in readthedocs.org. >> >> I tried to build these myself with a development snapshot and had the same >> failures. >> >> I then noticed that if a pickled environment was already created, the PDF >> would be generated fine. In other words, "make pickle", "make html", etc >> would create a pickled environment which would then cause "make latexpdf" to >> succeed. >> >> I am not an expert on Sphinx - I thought this would be useful information >> for someone more knowledgeable than me. >> >> --Vraj Mohan >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sqlalchemy" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> Visit this group at http://groups.google.com/group/sqlalchemy?hl=en. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sqlalchemy" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> Visit this group at http://groups.google.com/group/sqlalchemy?hl=en. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> > > -- > You received this message because you are subscribed to the Google Groups > "sqlalchemy" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/sqlalchemy?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > -- You received this message because you are subscribed to the Google Groups "sqlalchemy" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sqlalchemy?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
