TeX2page
Frequently Asked Questions

1. Do I need to know Scheme in order to be able to use TeX2page?

No. Even for those occasions where you need to modify TeX2page’s behavior, basic TeX macros are usually sufficient. However, if you wish to extend TeX2page in peculiar and/or idiosyncratic ways, familiarity with Scheme will help.

2. But I do need Scheme to run TeX2page?

You need either a Scheme dialect or Common Lisp.

3. This sounds like too much work! Look, I am on Linux or Cygwin. Shouldn’t I be able to install TeX2page like other GNU software and have it “just work”, instead of worrying about Scheme, Common Lisp and their myriad dialects?

Well, you do need to have a Scheme or Common Lisp installed on your system. Type ./configure ‑‑help for guidance.

4. I need a converter for my LaTeX documents. Doesn’t TeX2page convert only plain TeX?

TeX2page converts LaTeX as well as plain TeX documents.

5. Do I need to make changes to my document to make it suitable for TeX2page?

Typically, this isn’t necessary. If TeX2page fails to convert your legacy document, you can put TeX2page-specific information in a .t2p file, without modifying the legacy document. See the manual.

6. Why does my document have broken images?

TeX2page makes images using a combination of TeX, Dvips, Ghostscript and the NetPBM library. Make sure you have running versions of these programs on your system. They are all freely available from the ’Net.

7. Couldn’t the images be a bit larger?

Use the \imgpreamble command to specify a higher magnification for your images.

8. How do I make my HTML file be a little less drab?

You need stylesheets. The TeX2page manual tells you how to incorporate them.

9. Is there a way to avoid having my converted document mention TeX2page?

Read about the \TZPcolophoncredit flag in the TeX2page manual.

10. Do I really have to read the TeX2page manual?

I suppose you could consult it only when you run into problems, but do consider reading it. It is a fine manual.

11. Why can’t I just use LaTeX2HTML [1]?

You certainly can. Converting TeX source to other formats inevitably involves compromises, so different converters will have different strengths, different approaches to extensibility, and appeal to different tastes. You should pick the one that best fits your needs.

12. What are some of the other converters?

HeVeA [5], TeX4ht [3], TtH [4].

13. I like getting both a printable and an online document from the same source. But hasn’t Texinfo [2] already solved that problem?

Actually the problem TeX2page attempts to solve is getting high-quality online texts from arbitrary TeX source (which we already know to produce high-quality printed output). Texinfo requires its source to be in a restricted Texinfo format.

14. But Texinfo gives me Info files, which I can browse comfortably in Emacs or Vim. Is there a way I can read TeX2page output on my text editor?

Yes. The TeX2page distribution includes a Vim script t2p2info for converting TeX2page output into Info files.

15. OK. I am ready to give TeX2page a try. Where do I get it?

The official TeX2page website is http://www.ccs.neu.edu/~dorai/tex2page/index.html. The download link is just below the title. Appendix D contains installation instructions.

Works cited

[1]   Nikos Drakos. LaTeX2html: bringing high-quality documents to the web.

[2]   FSF. Texinfo: The GNU Documentation System.

[3]   Eitan M. Gurari. TeX4ht: LaTeX and TeX for hypertext.

[4]   Ian Hutchinson. TtH.

[5]   Luc Maranget. HeVeA.

Last modified: Fri, Feb 8, 2013, 7:32 pm UTC−5