Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Convert mathematical model definition manual from latex to html pages #64

Open
FilippoOggionni opened this issue Mar 21, 2022 · 0 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@FilippoOggionni
Copy link
Member

Conversion of mathematical model definition document to online environment

I made some research into this, here are my findings:

  • It is not possible to include directly latex source code into rst files (it is possible, but only in math mode), so that is off the table
  • I tried converting .tex files into .rst files through pandoc. The output is generally quite decent (see screenshot attached), but the main problems arise with references (both citations of the bibliography and in-text references to sections, tables, equations, etc…). Since references are quite important in such a document, it seems that this solution is not what we are looking for. Possible fixes (but in my opinion they would both require too much time):
  1. Parsing the converted document and replacing labels/citations
  2. Build a filter for pandoc through panflute, as suggested by this post, to do the same
  • Alternatively, I found a latex2html tool that allows to convert latex files directly to html pages. From what they claim, it sounds quite advanced, but I have to do some more research into it. I ran it but it is not working, I am checking if I have all the required packages installed. Another option is LaTeXML, as suggested by @transferorbit.
@FilippoOggionni FilippoOggionni added the documentation Improvements or additions to documentation label Mar 21, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants