View previous topic :: View next topic |
Author |
Message |
robbyjo Guru
Joined: 06 Apr 2003 Posts: 462
|
Posted: Tue Apr 19, 2005 9:50 pm Post subject: [MINI-HOWTO] Convert LaTeX to HTML with MathML |
|
|
If you're a graduate student or professor working in your research papers, you'd most likely use LaTeX. LaTeX is awesome especially in typing mathematical formulas. Most likely, the papers you're making will be put into postscript (PS) or PDF file for publication. Sometimes, you'd prefer to have that convert it directly to HTML for direct viewing through your webpage. There was a program to do this, called latex2html, which could do a decent job. However, latex2html always converts mathematical formulas or symbols into graphics, to either PNG or GIF. This means that if you have tons of mathematical formulas, you'd end up with hundreds or sometimes thousands of tiny PNG/GIF files, which is really bad for user and server. Not only that, the PNG or GIF files are usually of very low quality, full of jagged edges.
Converting mathematical formulas or symbols to graphics were unavoidable in yester years, where we don't have adequate expression to do so. However, in recent year, W3 has developed MathML to address this issue. We certainly would like to incorporate this new standard for our purposes.
Before we do anything, I'd suggest you to do "emerge --sync" to obtain the latest greatest package from the portage repository.
1. Installing LaTeX
If you have already installed LaTeX, you can safely skip this section.
To install LaTeX, invoke the following command:
Code: | your_machine# ACCEPT_KEYWORDS="~x86" emerge -va tetex |
Currently, the latest version of tetex is 3.0-r2. Substitute "~x86" to the appropriate "~arch" if your architecture is not x86.
-------------------
2. Installing TeX4ht
The new TeX to HTML converter is called TeX4ht. Fortunately, we already have that in the portage tree. To install it, invoke:
Code: | your_machine# ACCEPT_KEYWORDS="~x86" emerge -va tex4ht |
And you're good to go.
-------------------
3. Converting TeX to HTML
The last step is of course to convert your TeX paper into an HTML file. To do that, type:
Code: | your_machine$ mzlatex my_tex_file "xhtml,mathml-" |
You can omit the .tex extension if you like. The newly created file is called my_tex_file.xml. You can copy that along with its css file (my_tex_file.css). The result is amazing.
-------------------
4. GUI-based Editor for LaTeX (Optional)
If you want to have GUI-based LaTeX editor, you can emerge kile, a KDE-based program:
Code: | your_machine# ACCEPT_KEYWORDS="~x86" emerge -va kile |
Certainly, you can configure tex4ht inside kile so that you have all-integrated editing environment for your disposal. To do this:
1. Start kile (usually it's at /usr/bin/kile; you may want to put it into a shortcut).
2. Then, choose: Settings>Configure Kile>Build>New Tool. Type in "TeX4ht". Click Next button, then Finish button.
3. At the command text field, type in: mzlatex
4. At the Options text field, type in: '%source' 'xhtml,mathml-' (with all quotes intact and there is a space between the quoted options)
5. Click the OK button.
Now, you're ready to use TeX4ht inside Kile. Click Build menu, then Other, then you'll find TeX4ht. If you want to just compile to PS or PDF, you can choose other tools like DVItoPS or DVItoPS in Build menu.
Have fun.
------------------- |
|
Back to top |
|
|
jdgill0 Veteran
Joined: 25 Mar 2003 Posts: 1366 Location: Lexington, Ky -- USA
|
Posted: Wed Apr 20, 2005 8:59 pm Post subject: |
|
|
This looks great. Not so long ago, I needed/wanted to do just what you are talking about here. I found latex2html not so good.
Thanks for the tips/howto.
[EDIT]
I meant to also ask, is it necessary to use ~x86 version of tetex, i.e. 3.x? _________________ Vim has excellent syntax highlighting for configuration files: emerge gentoo-syntax
Learn how to use Vim: vimtutor |
|
Back to top |
|
|
robbyjo Guru
Joined: 06 Apr 2003 Posts: 462
|
Posted: Wed Apr 20, 2005 10:28 pm Post subject: |
|
|
No problem. I'm glad to be of help.
jdgill0 wrote: | I meant to also ask, is it necessary to use ~x86 version of tetex, i.e. 3.x? |
I'm not sure. If you don't use ~x86, you'll end up with tetex 2.x. I think it still would work, though. |
|
Back to top |
|
|
jdgill0 Veteran
Joined: 25 Mar 2003 Posts: 1366 Location: Lexington, Ky -- USA
|
Posted: Wed Apr 20, 2005 11:04 pm Post subject: |
|
|
Guess I'll have to try and see huh ... btw, is there some new benifits or new features with tetex 3.x that would make you want to use it instead of the stable 2.x branch? _________________ Vim has excellent syntax highlighting for configuration files: emerge gentoo-syntax
Learn how to use Vim: vimtutor |
|
Back to top |
|
|
robbyjo Guru
Joined: 06 Apr 2003 Posts: 462
|
Posted: Thu Apr 21, 2005 6:07 am Post subject: |
|
|
Unsure about that either. I think TeX 3.0 has huge bugfixes from 2.0. That's the impression that I got from the changelog. |
|
Back to top |
|
|
gustafson Guru
Joined: 12 Aug 2004 Posts: 430
|
Posted: Fri Oct 28, 2005 8:16 pm Post subject: |
|
|
Hey, this looks great..
For most people, this will create a MathML font issue for firefox or mozilla.
the solution is to emerge the following:
Code: | media-fonts/texcm-ttf
media-fonts/mathematica-fonts |
Then browse to about:config and follow the instructions from the ebuild.
Code: | * To make Mozilla happy, you should change font.mathfont-family:
* 1. Enter the URL about:config
* 2. First, check to see if the pref exists
* If not, right-click and select New > String
* The name of the preference is font.mathfont-family
* 3. You should set the value to (right-click to modify):
* CMSY10, CMEX10, Mathematica1, Mathematica2, Mathematica4, MT Extra, Standard Symbols L
|
|
|
Back to top |
|
|
flieslikeabeagle n00b
Joined: 05 Dec 2003 Posts: 28 Location: Los Angeles
|
Posted: Tue Apr 17, 2007 11:08 pm Post subject: Bugs - Latex fractions not correctly converted to MathML |
|
|
I just found this thread via a Google search, as I have a Latex document I wish to convert to a web page. It looks as though Tex4ht has a massive bug - it fails to correctly render any fractions generated using \frac{}{} in the Latex document. After running mzlatex, the generated MathML displays as a single line of math symbols with the fraction line completely gone - the denominator simply follows the numerator as though it were multiplied by it!
For instance, the Latex code Code: | \frac{R_m R_2}{R_m + R_2} | is rendered by mzlatex as , instead of the correct Code: | Rm′ = RmR2/(Rm + R2) |
Considering that it is now April 2007, four years after this thread was started, and the bug is still present, I am hesitant to endorse the use of Tex4ht to anyone.
Meantime Latex2HTML is ugly, but at least it does work.
-Flieslikeabeagle |
|
Back to top |
|
|
drwholton n00b
Joined: 11 Jul 2003 Posts: 12 Location: U.K.
|
Posted: Thu Sep 27, 2007 7:34 am Post subject: Re: Bugs - Latex fractions not correctly converted to MathML |
|
|
flieslikeabeagle wrote: |
Meantime Latex2HTML is ugly, but at least it does work.
|
Just done a test and comparison - been a long-time user of Latex2HTML and just tried out tex4ht
A fragment of a module I'm teaching on Cryptography (it's part of a single week's lectures, nowhere near complete yet!)
Translated using tex4ht
Translated using Latex2HTML
Navigational issues aside, both "work" to some extent with individual strengths and weaknesses, but for now I'm sticking with Latex2HTML (and also posting PDFs!!) |
|
Back to top |
|
|
|
|
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
|
|