search

sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.42k stars 2.09k forks source link

Math using LaTex #12800

Open mehta-pavan opened 4 weeks ago

mehta-pavan commented 4 weeks ago

Is your feature request related to a problem? Please describe. Some of my work is very mathematical / therotical, with pages long proof. As you see, rewriting in ".rst" or similar; not only is prone to many errors but also time consuming for doing the same thing!

Describe the solution you'd like I would like to render directly my LaTex files ".tex" to reproduce some theory using sphinx.

Describe alternatives you've considered Unfortutely, I only see the other way; where you are able to generate PDF or ".tex" file via sphinx - but, I would like the other way around.

Additional context None

Thanks in advance

mehta-pavan commented 1 week ago

Pandocs does the trick of .tex to .rst - math is surprisingly fine.

The only issues are

(1) equations numbers are not printed and no cross reference.

(2) citations via .bib file is a problem. Bibitem may work, but doesn't cross references.