We can probably ship the documentation as is. It would be nice to be in Sphinx but it isn't a requirement. If we commit the LaTeX source to the SymPy docs folder we can setup a small LaTeX compilation. We already have LaTeX as a dep for generating the pdf version of SymPy docs. I wrote my dissertation with Sphinx and there were definitely some issues, but everything (even the pdf version) ended up coming out nicely. Maybe we can get someone at the sprint to take a look at this doc inclusion issue.
Jason moorepants.info +01 530-601-9791 On Sat, Jul 11, 2015 at 8:11 AM, Alan Bromborsky <[email protected]> wrote: > I think it would be much faster and uglier with pngmath. I also think the > table capabilities of Sphinx are also much inferior to LaTeX. Another > problem with Sphinx and equations is if you use LaTeX macros it will work > for the html rendering but not when you ask Sphinx to generate a pdf > versions of the documentation. > > On Sat, Jul 11, 2015 at 8:00 AM, Matthew Brett <[email protected]> > wrote: > >> Hi, >> >> On Sat, Jul 11, 2015 at 12:48 PM, Alan Bromborsky <[email protected]> >> wrote: >> > The problem with merging is not so much the code as the documentation. >> The >> > current documentation is 77 page pdf document (attached) generated by >> latex >> > and heavy with equations. I felt since most people are unfamiliar with >> > geometric algebra/calculus a primer was needed in the documentation. >> The >> > normal documentation system used with sympy was too unwieldly to do >> this and >> > even with MathJax installed locally it was taking too long to render the >> > equations in the original documentation I wrote with the old galgebra >> > package in sympy. >> >> Is this a limitation of MathJax? Did you try with pngmath? >> >> I ask, because I have also run into trouble with a lot of math that >> was getting very slow to render with MathJax. >> >> Cheers, >> >> Matthew >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sympy" 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/sympy. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/sympy/CAH6Pt5pqZog5LD_GonF9mPz_iY99uqSCUw5rTU9BbV8wp6WfOQ%40mail.gmail.com >> . >> For more options, visit https://groups.google.com/d/optout. >> > > -- > You received this message because you are subscribed to the Google Groups > "sympy" 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/sympy. > To view this discussion on the web visit > https://groups.google.com/d/msgid/sympy/CALOxT-n5%3D1odyOQx9_Q-YUX_jvhi2u-n9ewDvowtcvHZ_tMRJA%40mail.gmail.com > <https://groups.google.com/d/msgid/sympy/CALOxT-n5%3D1odyOQx9_Q-YUX_jvhi2u-n9ewDvowtcvHZ_tMRJA%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "sympy" 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/sympy. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/CAP7f1AgftmTfMT%3DZF89LQ3%3DWtm2vxc2gJv99crdqbRW-7b_-ng%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
