r-devel / outreachy

Manage the R Project participation in Outreachy
0 stars 1 forks source link

Convert tex to HTML with htlatex #1

Open hturner opened 2 years ago

hturner commented 2 years ago

The commands for this task should be run at the system command line. You can use the Command Prompt on Windows, or a terminal on Linux/MacOS. Alternatively, you can use the shell/terminal in an IDE such as RStudio across platforms.

Ensure you have a LaTeX distribution installed on your computer (https://www.latex-project.org/get/). Check if you have the tex4ht package installed, e.g. by running where tex4ht on Windows or which tex4ht on Linux/MacOS. If no path is returned, you will need to install this package - follow the documentation for your LaTeX distribution and search for help online if necessary.

Pick one of the example articles and add a comment on this issue that you are working on that article. The RJwrapper.pdf file is the PDF we want to reproduce as HTML. Rename it as RJwrapper_orig.pdf to save a copy of the original. Run pdflatex and bibtex on the RJwrapper.tex file to reproduce the PDF, ensuring all citations and cross-references are present. Then run htlatex on the RJwrapper.tex file to convert this PDF to HTML. Type q to ignore errors/warnings and continue compiling when the compilation pauses with a ? prompt.

Compare the output to the original PDF file and write a list of any issues that need fixing in the converted HTML file, e.g. content that has not been converted correctly, problems with the typesetting or formatting. Create a public GitHub repository containing a copy of the source files for the article you selected, your HTML version with all auxiliary files (RJWrapper.4ct, RJWrapper.4tc, etc), and your list of issues. Add a link to this repository as a comment on this issue.

Athene-ai commented 1 year ago

I am interested