Hacker News Reader

Comment by cmccabe | Hacker News Reader

If the tex2html tool is poor, why not improve that tool? Re-inventing TeX seems like quite a waste of time.

Every time someone invents a new markup format for absolutely no reason, I die a little bit inside.

TeX and restructuredtext have very different goals. The first lets you specify every little typographical detail for a fixed page-oriented output. The latter focuses on a minimal set of semantic markup which can be used for different presentation media.

What you said is just the difference between TeX and LaTeX. If you want just semantic meaning, use LaTeX without lower level TeX commands, then use an automated tool to convert it to html or other formats.

No it's not. LaTeX is still page-oriented. You can convert it to HTML and other formats but not as well as multi-format markup specifically designed for that purpose.

There is nothing page oriented about LaTeX. All commands assume only content, the exact formatting is left to the combination of class/packages used. In fact, this is one of the weaknesses of LaTeX, because people like so much to be able to position pictures, tweak with title formatting, etc.

The whole point of LaTeX and TeX is not to worry about the exact format, but to worry about the semantics of the content instead, and let the layout engine decide for you. Like all automation, this generally works very well, except when it doesn't. When it doesn't, the solution is to give it a little manual shove in the right direction, not to rewrite everything in the markup language flavor of the week.

Incidentially, semantics, not presention, was originally the point behind HTML, but it got warped and twisted over time into a kinda-sort presentation-oriented language.

restructuredtext, on the other hand, was originally developed to create documentation for Python programs. It might be good for that purpose (wouldn't know; haven't used it.) But it's certainly not good for typesetting mathematics, research papers, academic quotations and so forth. Hence the large amount of wheel reinvention going on here. It's a little bit like writing your research paper using JavaDoc comments. Sphincter indeed.

You've never used ReST but you somehow know it's not good for typesetting research papers?

I used it a little bit back when I still wrote Python. It seemed a lot like HTML, but much terser, and whitespace-sensitive. ReST could do the same kind of stuff as HTML: build bullet lists, create tables, italic text, and so forth. However, since I had already learned HTML, learning another language that did the same thing felt like a waste of time. I fully believe that Restructured Text is a better markup language than HTML in some ways; however, I simply don't care because the differences are minor, and HTML is so much more powerful.

On the other hand, TeX was developed by Donald Knuth, a guy who spent his entire life doing research and writing papers about it. It has excellent math support, and is a true semantic language. I've written a few papers in TeX and been very happy with it.

Anyway, if RestructuredText were good at typesetting research papers, there would be no need for this project, would there?

You're confusing the language with the build system. LaTeX wouldn't be very useful without the awesome build system. This project is a build system for producing both high-quality HTML and high-quality PDF (through latex) with a single, high-level ReST markup language. It also uses latex formulas for math.

This uses an existing format, restructuredtext, not a new markup format.

Reply on news.ycombinator.com