I really hate laTex, I never liked it, how about adobe? I can help if it is needed.
__________________________________________________________________________________________ Piensa en el medio ambiente - mantenlo en la pantalla. NO lo imprimas si NO es necesario. Think green - keep it on the screen. Do NOT print if it is NOT necessary. Denken Sie an die Umwelt - bewahren Sie es auf dem Bildschirm. Drucken Sie es NICHT, wenn es NICHT notwendig ist. > Subject: Re: [sqlalchemy] Docs in PDF are not being generated > From: mike...@zzzcomputing.com > Date: Wed, 30 Jan 2013 11:53:27 -0500 > To: sqlalchemy@googlegroups.com > > > 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 <mike...@zzzcomputing.com> > > 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 sqlalchemy+unsubscr...@googlegroups.com. > >> To post to this group, send email to sqlalchemy@googlegroups.com. > >> 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 sqlalchemy+unsubscr...@googlegroups.com. > >> To post to this group, send email to sqlalchemy@googlegroups.com. > >> 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 sqlalchemy+unsubscr...@googlegroups.com. > > To post to this group, send email to sqlalchemy@googlegroups.com. > > 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 sqlalchemy+unsubscr...@googlegroups.com. > To post to this group, send email to sqlalchemy@googlegroups.com. > 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 sqlalchemy+unsubscr...@googlegroups.com. To post to this group, send email to sqlalchemy@googlegroups.com. Visit this group at http://groups.google.com/group/sqlalchemy?hl=en. For more options, visit https://groups.google.com/groups/opt_out.