diff options
author | Karl Berry <karl@freefriends.org> | 2009-05-23 00:23:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-05-23 00:23:51 +0000 |
commit | a683c3d7e9fac38ec713f23fb6b9d2c7143aea82 (patch) | |
tree | 424ab223921f85fd3f167a4ccd0e2d37d05c2927 /Master/texmf-dist/doc/latex/webguide | |
parent | 5beb5368a684995153c8566797ba054f21c666af (diff) |
move english latex doc out of texmf-doc
git-svn-id: svn://tug.org/texlive/trunk@13412 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/webguide')
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/README | 23 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/expeg.6 | 228 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/expeg6.mps | 228 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide.css | 60 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide.html | 874 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide.pdf | bin | 0 -> 170365 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide.ps.gz | bin | 0 -> 133652 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide.tex | 615 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/webguide/webguide0x.gif | bin | 0 -> 4993 bytes |
9 files changed, 2028 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/webguide/README b/Master/texmf-dist/doc/latex/webguide/README new file mode 100644 index 00000000000..f4ac6757e65 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/README @@ -0,0 +1,23 @@ + webguide is a "Brief Guide to LaTeX Tools for Web Publishing". +For a much more detailed guide see: Michel Goossens and Sebastian Rahtz +(with Eitan Gurari, Ross Moore, and Robert Sutor), "The LaTeX Web +Companion --- Integrating TeX, HTML, and XML", Addison Wesley, 1999, +(ISBN 0-201-43311-7). As an example of capabilities webguide includes a +LaTeX source file together with PostScript, PDF, and HTML versions all +generated automatically from the single source. + + You should find the following files: +o README (this file) +o webguide.tex --- Source file +o expeg.6 --- MetaPost generated EPS file +o expeg6.mps --- copy of expeg.6 +o webguide.ps --- PostScript version of webguide.tex generated by latex + and dvips +o webguide.pdf --- PDF version of webguide.tex generated by pdflatex +o webguide.html --- HTML version of webguide.tex generated by TeX4ht +o webguide.css --- file generated by TeX4ht +o webguide0x.gif --- file generated by TeX4ht + +Peter Wilson +February 2000 +peter.r.wilson@boeing.com diff --git a/Master/texmf-dist/doc/latex/webguide/expeg.6 b/Master/texmf-dist/doc/latex/webguide/expeg.6 new file mode 100644 index 00000000000..52439977599 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/expeg.6 @@ -0,0 +1,228 @@ +%!PS +%%BoundingBox: -1 -1 274 159 +%%Creator: MetaPost +%%CreationDate: 1999.12.08:1516 +%%Pages: 1 +%*Font: cmr10 9.96265 9.96265 28:e000000d4238007e4fbc4 +%%EndProlog +%%Page: 1 1 + 0 0.5 dtransform truncate idtransform setlinewidth pop [] 0 setdash + 1 setlinejoin 10 setmiterlimit +newpath 0 106.29904 moveto +63.84018 106.29904 lineto +63.84018 120.47224 lineto +0 120.47224 lineto + closepath stroke +2.83464 109.92639 moveto +(man) cmr10 9.96265 fshow +21.37624 109.92639 moveto +(ufacturer) cmr10 9.96265 fshow +newpath 95.76027 141.73206 moveto +158.12236 141.73206 lineto +158.12236 155.90526 lineto +95.76027 155.90526 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 152.45308 141.73206 moveto +152.45308 155.90526 lineto stroke +104.63104 145.41476 moveto +(STRING) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 190.04245 106.29904 moveto +253.88263 106.29904 lineto +253.88263 120.47224 lineto +190.04245 120.47224 lineto + closepath stroke +200.36848 109.92639 moveto +(car) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 214.27739 110.1256 moveto +217.26628 110.1256 lineto stroke +217.26628 109.92639 moveto +(mo) cmr10 9.96265 fshow +230.82658 109.92639 moveto +(del) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 190.04245 70.86603 moveto +253.88263 70.86603 lineto +253.88263 85.03923 lineto +190.04245 85.03923 lineto + closepath stroke +215.30693 75.80788 moveto +(car) cmr10 9.96265 fshow +newpath 95.76027 35.43301 moveto +158.12236 35.43301 lineto +158.12236 49.60622 lineto +95.76027 49.60622 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 152.45308 35.43301 moveto +152.45308 49.60622 lineto stroke +100.6183 39.11572 moveto +(INTEGER) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 95.76027 0 moveto +158.12236 0 lineto +158.12236 14.1732 lineto +95.76027 14.1732 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 152.45308 0 moveto +152.45308 14.1732 lineto stroke +104.63104 3.68271 moveto +(STRING) cmr10 9.96265 fshow +newpath 31.92009 120.47224 moveto +31.92009 148.81866 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 31.92009 148.81866 moveto +90.09087 148.81866 lineto stroke +newpath 95.76021 148.81866 moveto +95.76021 149.5705 95.4615 150.29144 94.92992 150.82301 curveto +94.39835 151.3546 93.6774 151.6533 92.92557 151.6533 curveto +92.17374 151.6533 91.45279 151.3546 90.92122 150.82301 curveto +90.38963 150.29144 90.09093 149.5705 90.09093 148.81866 curveto +90.09093 148.06683 90.38963 147.34589 90.92122 146.81432 curveto +91.45279 146.28273 92.17374 145.98402 92.92557 145.98402 curveto +93.6774 145.98402 94.39835 146.28273 94.92992 146.81432 curveto +95.4615 147.34589 95.76021 148.06683 95.76021 148.81866 curveto closepath + stroke +34.02008 150.91866 moveto +(*name) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 221.96254 120.47224 moveto +221.96254 148.81866 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 221.96254 148.81866 moveto +163.79176 148.81866 lineto stroke +newpath 163.7917 148.81866 moveto +163.7917 149.5705 163.493 150.29144 162.96141 150.82301 curveto +162.42984 151.3546 161.7089 151.6533 160.95706 151.6533 curveto +160.20523 151.6533 159.48428 151.3546 158.95271 150.82301 curveto +158.42113 150.29144 158.12242 149.5705 158.12242 148.81866 curveto +158.12242 148.06683 158.42113 147.34589 158.95271 146.81432 curveto +159.48428 146.28273 160.20523 145.98402 160.95706 145.98402 curveto +161.7089 145.98402 162.42984 146.28273 162.96141 146.81432 curveto +163.493 147.34589 163.7917 148.06683 163.7917 148.81866 curveto closepath + stroke +191.63495 150.91866 moveto +(*name) cmr10 9.96265 fshow +newpath 190.04245 113.38565 moveto +69.50941 113.38565 lineto stroke +newpath 69.50945 113.38565 moveto +69.50945 114.13748 69.21074 114.85843 68.67915 115.39 curveto +68.14758 115.92159 67.42664 116.22029 66.6748 116.22029 curveto +65.92297 116.22029 65.20203 115.92159 64.67046 115.39 curveto +64.13887 114.85843 63.84016 114.13748 63.84016 113.38565 curveto +63.84016 112.63382 64.13887 111.91287 64.67046 111.3813 curveto +65.20203 110.84972 65.92297 110.55101 66.6748 110.55101 curveto +67.42664 110.55101 68.14758 110.84972 68.67915 111.3813 curveto +69.21074 111.91287 69.50945 112.63382 69.50945 113.38565 curveto closepath + stroke +150.59355 117.42284 moveto +(made) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 174.43755 117.62204 moveto +177.42635 117.62204 lineto stroke +177.42635 117.42284 moveto +(b) cmr10 9.96265 fshow +182.68436 117.42284 moveto +(y) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 221.96254 85.03923 moveto +221.96254 100.62985 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 224.79718 103.46445 moveto +224.79718 104.21628 224.49847 104.93723 223.96689 105.4688 curveto +223.43532 106.00038 222.71437 106.29909 221.96254 106.29909 curveto +221.21071 106.29909 220.48976 106.00038 219.95819 105.4688 curveto +219.4266 104.93723 219.1279 104.21628 219.1279 103.46445 curveto +219.1279 102.71262 219.4266 101.99167 219.95819 101.4601 curveto +220.48976 100.92851 221.21071 100.6298 221.96254 100.6298 curveto +222.71437 100.6298 223.43532 100.92851 223.96689 101.4601 curveto +224.49847 101.99167 224.79718 102.71262 224.79718 103.46445 curveto closepath + stroke +224.06253 89.07642 moveto +(mo) cmr10 9.96265 fshow +237.62283 89.07642 moveto +(del) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 250.95064 89.27562 moveto +253.93944 89.27562 lineto stroke +253.93944 89.07642 moveto +(t) cmr10 9.96265 fshow +257.53712 89.07642 moveto +(yp) cmr10 9.96265 fshow +268.60674 89.07642 moveto +(e) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop 1 setlinecap +newpath 190.04245 77.95264 moveto +31.92009 77.95264 lineto stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 31.92009 77.95264 moveto +31.92009 100.62985 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 34.75473 103.46423 moveto +34.75473 104.21606 34.45602 104.93701 33.92444 105.46858 curveto +33.39287 106.00017 32.67192 106.29887 31.92009 106.29887 curveto +31.16826 106.29887 30.44731 106.00017 29.91574 105.46858 curveto +29.38416 104.93701 29.08545 104.21606 29.08545 103.46423 curveto +29.08545 102.7124 29.38416 101.99146 29.91574 101.45988 curveto +30.44731 100.9283 31.16826 100.6296 31.92009 100.6296 curveto +32.67192 100.6296 33.39287 100.9283 33.92444 101.45988 curveto +34.45602 101.99146 34.75473 102.7124 34.75473 103.46423 curveto closepath + stroke +112.81847 82.54333 moveto +(\(DER\)) cmr10 9.96265 fshow +145.61217 82.54333 moveto +(*made) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 174.43747 82.74254 moveto +177.42627 82.74254 lineto stroke +177.42627 82.54333 moveto +(b) cmr10 9.96265 fshow +182.68437 82.54333 moveto +(y) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 211.32219 70.86603 moveto +211.32219 42.51962 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 211.32219 42.51962 moveto +163.79173 42.51962 lineto stroke +newpath 163.79169 42.51962 moveto +163.79169 43.27145 163.49298 43.9924 162.9614 44.52397 curveto +162.42982 45.05556 161.70888 45.35426 160.95705 45.35426 curveto +160.20522 45.35426 159.48427 45.05556 158.9527 44.52397 curveto +158.42111 43.9924 158.1224 43.27145 158.1224 42.51962 curveto +158.1224 41.76779 158.42111 41.04684 158.9527 40.51527 curveto +159.48427 39.98369 160.20522 39.68498 160.95705 39.68498 curveto +161.70888 39.68498 162.42982 39.98369 162.9614 40.51527 curveto +163.49298 41.04684 163.79169 41.76779 163.79169 42.51962 curveto closepath + stroke +190.9297 46.55681 moveto +(y) cmr10 9.96265 fshow +195.911 46.55681 moveto +(ear) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 232.60289 70.86603 moveto +232.60289 7.08661 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 232.60289 7.08661 moveto +163.79114 7.08661 lineto stroke +newpath 163.79138 7.08661 moveto +163.79138 7.83844 163.49268 8.55939 162.96109 9.09096 curveto +162.42952 9.62254 161.70857 9.92125 160.95674 9.92125 curveto +160.20491 9.92125 159.48396 9.62254 158.9524 9.09096 curveto +158.4208 8.55939 158.1221 7.83844 158.1221 7.08661 curveto +158.1221 6.33478 158.4208 5.61383 158.9524 5.08226 curveto +159.48396 4.55067 160.20491 4.25197 160.95674 4.25197 curveto +161.70857 4.25197 162.42952 4.55067 162.96109 5.08226 curveto +163.49268 5.61383 163.79138 6.33478 163.79138 7.08661 curveto closepath stroke +188.6431 9.1866 moveto +(*serial) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 216.9979 9.3858 moveto +219.9867 9.3858 lineto stroke +219.9867 9.1866 moveto +(no) cmr10 9.96265 fshow +showpage +%%EOF diff --git a/Master/texmf-dist/doc/latex/webguide/expeg6.mps b/Master/texmf-dist/doc/latex/webguide/expeg6.mps new file mode 100644 index 00000000000..52439977599 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/expeg6.mps @@ -0,0 +1,228 @@ +%!PS +%%BoundingBox: -1 -1 274 159 +%%Creator: MetaPost +%%CreationDate: 1999.12.08:1516 +%%Pages: 1 +%*Font: cmr10 9.96265 9.96265 28:e000000d4238007e4fbc4 +%%EndProlog +%%Page: 1 1 + 0 0.5 dtransform truncate idtransform setlinewidth pop [] 0 setdash + 1 setlinejoin 10 setmiterlimit +newpath 0 106.29904 moveto +63.84018 106.29904 lineto +63.84018 120.47224 lineto +0 120.47224 lineto + closepath stroke +2.83464 109.92639 moveto +(man) cmr10 9.96265 fshow +21.37624 109.92639 moveto +(ufacturer) cmr10 9.96265 fshow +newpath 95.76027 141.73206 moveto +158.12236 141.73206 lineto +158.12236 155.90526 lineto +95.76027 155.90526 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 152.45308 141.73206 moveto +152.45308 155.90526 lineto stroke +104.63104 145.41476 moveto +(STRING) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 190.04245 106.29904 moveto +253.88263 106.29904 lineto +253.88263 120.47224 lineto +190.04245 120.47224 lineto + closepath stroke +200.36848 109.92639 moveto +(car) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 214.27739 110.1256 moveto +217.26628 110.1256 lineto stroke +217.26628 109.92639 moveto +(mo) cmr10 9.96265 fshow +230.82658 109.92639 moveto +(del) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 190.04245 70.86603 moveto +253.88263 70.86603 lineto +253.88263 85.03923 lineto +190.04245 85.03923 lineto + closepath stroke +215.30693 75.80788 moveto +(car) cmr10 9.96265 fshow +newpath 95.76027 35.43301 moveto +158.12236 35.43301 lineto +158.12236 49.60622 lineto +95.76027 49.60622 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 152.45308 35.43301 moveto +152.45308 49.60622 lineto stroke +100.6183 39.11572 moveto +(INTEGER) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 95.76027 0 moveto +158.12236 0 lineto +158.12236 14.1732 lineto +95.76027 14.1732 lineto + closepath stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 152.45308 0 moveto +152.45308 14.1732 lineto stroke +104.63104 3.68271 moveto +(STRING) cmr10 9.96265 fshow +newpath 31.92009 120.47224 moveto +31.92009 148.81866 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 31.92009 148.81866 moveto +90.09087 148.81866 lineto stroke +newpath 95.76021 148.81866 moveto +95.76021 149.5705 95.4615 150.29144 94.92992 150.82301 curveto +94.39835 151.3546 93.6774 151.6533 92.92557 151.6533 curveto +92.17374 151.6533 91.45279 151.3546 90.92122 150.82301 curveto +90.38963 150.29144 90.09093 149.5705 90.09093 148.81866 curveto +90.09093 148.06683 90.38963 147.34589 90.92122 146.81432 curveto +91.45279 146.28273 92.17374 145.98402 92.92557 145.98402 curveto +93.6774 145.98402 94.39835 146.28273 94.92992 146.81432 curveto +95.4615 147.34589 95.76021 148.06683 95.76021 148.81866 curveto closepath + stroke +34.02008 150.91866 moveto +(*name) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 221.96254 120.47224 moveto +221.96254 148.81866 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 221.96254 148.81866 moveto +163.79176 148.81866 lineto stroke +newpath 163.7917 148.81866 moveto +163.7917 149.5705 163.493 150.29144 162.96141 150.82301 curveto +162.42984 151.3546 161.7089 151.6533 160.95706 151.6533 curveto +160.20523 151.6533 159.48428 151.3546 158.95271 150.82301 curveto +158.42113 150.29144 158.12242 149.5705 158.12242 148.81866 curveto +158.12242 148.06683 158.42113 147.34589 158.95271 146.81432 curveto +159.48428 146.28273 160.20523 145.98402 160.95706 145.98402 curveto +161.7089 145.98402 162.42984 146.28273 162.96141 146.81432 curveto +163.493 147.34589 163.7917 148.06683 163.7917 148.81866 curveto closepath + stroke +191.63495 150.91866 moveto +(*name) cmr10 9.96265 fshow +newpath 190.04245 113.38565 moveto +69.50941 113.38565 lineto stroke +newpath 69.50945 113.38565 moveto +69.50945 114.13748 69.21074 114.85843 68.67915 115.39 curveto +68.14758 115.92159 67.42664 116.22029 66.6748 116.22029 curveto +65.92297 116.22029 65.20203 115.92159 64.67046 115.39 curveto +64.13887 114.85843 63.84016 114.13748 63.84016 113.38565 curveto +63.84016 112.63382 64.13887 111.91287 64.67046 111.3813 curveto +65.20203 110.84972 65.92297 110.55101 66.6748 110.55101 curveto +67.42664 110.55101 68.14758 110.84972 68.67915 111.3813 curveto +69.21074 111.91287 69.50945 112.63382 69.50945 113.38565 curveto closepath + stroke +150.59355 117.42284 moveto +(made) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 174.43755 117.62204 moveto +177.42635 117.62204 lineto stroke +177.42635 117.42284 moveto +(b) cmr10 9.96265 fshow +182.68436 117.42284 moveto +(y) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 221.96254 85.03923 moveto +221.96254 100.62985 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 224.79718 103.46445 moveto +224.79718 104.21628 224.49847 104.93723 223.96689 105.4688 curveto +223.43532 106.00038 222.71437 106.29909 221.96254 106.29909 curveto +221.21071 106.29909 220.48976 106.00038 219.95819 105.4688 curveto +219.4266 104.93723 219.1279 104.21628 219.1279 103.46445 curveto +219.1279 102.71262 219.4266 101.99167 219.95819 101.4601 curveto +220.48976 100.92851 221.21071 100.6298 221.96254 100.6298 curveto +222.71437 100.6298 223.43532 100.92851 223.96689 101.4601 curveto +224.49847 101.99167 224.79718 102.71262 224.79718 103.46445 curveto closepath + stroke +224.06253 89.07642 moveto +(mo) cmr10 9.96265 fshow +237.62283 89.07642 moveto +(del) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 250.95064 89.27562 moveto +253.93944 89.27562 lineto stroke +253.93944 89.07642 moveto +(t) cmr10 9.96265 fshow +257.53712 89.07642 moveto +(yp) cmr10 9.96265 fshow +268.60674 89.07642 moveto +(e) cmr10 9.96265 fshow + 0 0.5 dtransform truncate idtransform setlinewidth pop 1 setlinecap +newpath 190.04245 77.95264 moveto +31.92009 77.95264 lineto stroke + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 31.92009 77.95264 moveto +31.92009 100.62985 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 34.75473 103.46423 moveto +34.75473 104.21606 34.45602 104.93701 33.92444 105.46858 curveto +33.39287 106.00017 32.67192 106.29887 31.92009 106.29887 curveto +31.16826 106.29887 30.44731 106.00017 29.91574 105.46858 curveto +29.38416 104.93701 29.08545 104.21606 29.08545 103.46423 curveto +29.08545 102.7124 29.38416 101.99146 29.91574 101.45988 curveto +30.44731 100.9283 31.16826 100.6296 31.92009 100.6296 curveto +32.67192 100.6296 33.39287 100.9283 33.92444 101.45988 curveto +34.45602 101.99146 34.75473 102.7124 34.75473 103.46423 curveto closepath + stroke +112.81847 82.54333 moveto +(\(DER\)) cmr10 9.96265 fshow +145.61217 82.54333 moveto +(*made) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 174.43747 82.74254 moveto +177.42627 82.74254 lineto stroke +177.42627 82.54333 moveto +(b) cmr10 9.96265 fshow +182.68437 82.54333 moveto +(y) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth 1 setlinecap +newpath 211.32219 70.86603 moveto +211.32219 42.51962 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 211.32219 42.51962 moveto +163.79173 42.51962 lineto stroke +newpath 163.79169 42.51962 moveto +163.79169 43.27145 163.49298 43.9924 162.9614 44.52397 curveto +162.42982 45.05556 161.70888 45.35426 160.95705 45.35426 curveto +160.20522 45.35426 159.48427 45.05556 158.9527 44.52397 curveto +158.42111 43.9924 158.1224 43.27145 158.1224 42.51962 curveto +158.1224 41.76779 158.42111 41.04684 158.9527 40.51527 curveto +159.48427 39.98369 160.20522 39.68498 160.95705 39.68498 curveto +161.70888 39.68498 162.42982 39.98369 162.9614 40.51527 curveto +163.49298 41.04684 163.79169 41.76779 163.79169 42.51962 curveto closepath + stroke +190.9297 46.55681 moveto +(y) cmr10 9.96265 fshow +195.911 46.55681 moveto +(ear) cmr10 9.96265 fshow + 0.5 0 dtransform exch truncate exch idtransform pop setlinewidth +newpath 232.60289 70.86603 moveto +232.60289 7.08661 lineto stroke + 0 0.5 dtransform truncate idtransform setlinewidth pop +newpath 232.60289 7.08661 moveto +163.79114 7.08661 lineto stroke +newpath 163.79138 7.08661 moveto +163.79138 7.83844 163.49268 8.55939 162.96109 9.09096 curveto +162.42952 9.62254 161.70857 9.92125 160.95674 9.92125 curveto +160.20491 9.92125 159.48396 9.62254 158.9524 9.09096 curveto +158.4208 8.55939 158.1221 7.83844 158.1221 7.08661 curveto +158.1221 6.33478 158.4208 5.61383 158.9524 5.08226 curveto +159.48396 4.55067 160.20491 4.25197 160.95674 4.25197 curveto +161.70857 4.25197 162.42952 4.55067 162.96109 5.08226 curveto +163.49268 5.61383 163.79138 6.33478 163.79138 7.08661 curveto closepath stroke +188.6431 9.1866 moveto +(*serial) cmr10 9.96265 fshow + 0 0.3985 dtransform truncate idtransform setlinewidth pop 0 setlinecap +newpath 216.9979 9.3858 moveto +219.9867 9.3858 lineto stroke +219.9867 9.1866 moveto +(no) cmr10 9.96265 fshow +showpage +%%EOF diff --git a/Master/texmf-dist/doc/latex/webguide/webguide.css b/Master/texmf-dist/doc/latex/webguide/webguide.css new file mode 100644 index 00000000000..a952808a737 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide.css @@ -0,0 +1,60 @@ + +/* start css.sty */ +.cmr-10{font-size:90%;} +.cmr-10--109{font-size:99%;} +.cmr-17{font-size:154%;} +.cmr-12{font-size:109%;} +.cmsy-8{font-size:72%;} +.cmtt-12{font-size:109%;font-family: monospace;} +.cmsy-10--109{font-size:99%;} +.cmtt-10--109{font-size:99%;font-family: monospace;} +.cmbx-10{font-size:90%; font-weight: bold;} +.cmcsc-10--109{font-size:99%;} +.cmss-10--109{font-size:99%; font-family: sans-serif;} +.cmti-10--109{font-size:99%; font-style: italic;} +.small-caps{font-variant: small-caps; } +p.noindent { text-indent: 0em } +p.nopar { text-indent: 0em; } +p.indent{ text-indent: 1.5em } +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +div.displaymath{text-align:center;} +img.mathdisplay, div.displaymath, img.par-mathdisplay, div.par-displaymath { margin-top: 1em; margin-bottom: 1em; } +center img.mathdisplay, td img.mathdisplay, center img.par-mathdisplay, td img.par-mathdisplay { margin-top: 0; margin-bottom:0 ; } +div.displaymath{text-align:center;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +.underline{ text-decoration:underline; } +.overline{ text-decoration:overline; } +span.pmatrix img{vertical-align:middle;} +div.center {text-align: center;} +div.center div {text-align: left;} +div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +div.td00{ margin-left:0; margin-right:0; } +div.td01{ margin-left:0; margin-right:5; } +div.td10{ margin-left:5; margin-right:0; } +div.td11{ margin-left:5; margin-right:5; } +.hline hr, .cline hr{ height : 1px; } +li p.indent, li p.indent{ text-indent: 0em } +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +span.footnotetext{ font-size:75%; font-style:italic; } +span.TEX {letter-spacing: -0.125em; } +span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} +a span.TEX span.E {text-decoration: none; } +span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} +span.LATEX span.TEX{ position:relative; left: -0.4em; } +.marginpar {width:20%; float:right; text-align:left; margin-left:1em; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +p.bibitem { text-indent: -2em; margin-left: 2em; } +h1.partHead{text-align: center} +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } +.caption td.id{font-weight: bold; white-space: nowrap; } +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +/* end css.sty */ diff --git a/Master/texmf-dist/doc/latex/webguide/webguide.html b/Master/texmf-dist/doc/latex/webguide/webguide.html new file mode 100644 index 00000000000..c1fd9f281b0 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide.html @@ -0,0 +1,874 @@ + +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" + "http://www.w3.org/TR/html4/loose.dtd"> +<html +><head><!--webguide.html from webguide.tex (TeX4ht, 2000-03-10 10:44:00)--> +<title>A Brief Guide to LaTeX{} Tools for Web Publishing</title><meta +http-equiv="Content-Type" content="text/html; charset=iso-8859-1" ><link +rel="stylesheet" type="text/css" +href="webguide.css"></head> <body +> <div align="center" class="maketitle"> + +<h2 class="titleHead">A Brief Guide to LaTeX Tools for Web Publishing</h2> + <div class="author" align="center"><span +class="cmr-12">Peter R. Wilson</span><sup ><span +class="cmsy-8">*</span></sup> +<br><span +class="cmtt-12">peter.r.wilson@boeing.com</span></div> +<br> +<div class="date" align="center"><span +class="cmr-12">11 March 2000</span></div> +<span class="thanks"></span> + <br ><span class="footnotetext"><sup><span +class="cmsy-10--109">*</span></sup>With helpful critiques by Eitan Gurari (<span +class="cmtt-10--109">gurari@cis.ohio-state.edu</span>) and David Wilson + (<span +class="cmtt-10--109">davidw@utopiatype.com.au</span>).</span></div><div><table width="100%" +class="abstract"><tr><td +> +<div class="center" +> +<span +class="cmbx-10">Abstract</span></div> + <!--53--><p class="noindent"><span +class="cmr-10">This document provides a brief guide to converting LaTeX documents to forms more</span> + <span +class="cmr-10">suitable for dissemination via the Web.</span> +</td></tr></table></div> + <h3 class="likesectionHead"><a + name="x1-1000"></a><a + name="QQ1-1-1"></a>Contents</h3> + <div class="tableofcontents"> +<br> <span class="sectionToc">1 <a + href="#QQ1-1-3" name="QQ2-1-3">Introduction</a></span> +<br> <span class="subsectionToc">1.1 <a + href="#QQ1-1-4" name="QQ2-1-4">URLs</a></span> +<br> <span class="subsectionToc">1.2 <a + href="#QQ1-1-5" name="QQ2-1-5">Disclaimer</a></span> +<br> <span class="sectionToc">2 <a + href="#QQ1-1-6" name="QQ2-1-6">PDF</a></span> +<br> <span class="subsectionToc">2.1 <a + href="#QQ1-1-7" name="QQ2-1-7">From PostScript to PDF</a></span> +<br> <span class="subsectionToc">2.2 <a + href="#QQ1-1-8" name="QQ2-1-8">From DVI to PDF</a></span> +<br> <span class="subsectionToc">2.3 <a + href="#QQ1-1-9" name="QQ2-1-9">From LaTeX to PDF</a></span> +<br> <span class="subsectionToc">2.4 <a + href="#QQ1-1-10" name="QQ2-1-10">Fonts</a></span> +<br> <span class="subsectionToc">2.5 <a + href="#QQ1-1-11" name="QQ2-1-11">MetaPost</a></span> +<br> <span class="sectionToc">3 <a + href="#QQ1-1-13" name="QQ2-1-13">HTML</a></span> +<br> <span class="subsectionToc">3.1 <a + href="#QQ1-1-14" name="QQ2-1-14">Self-parsing systems</a></span> +<br> <span class="subsectionToc">3.2 <a + href="#QQ1-1-15" name="QQ2-1-15">TeX-based parsing system</a></span> +<br> <span class="sectionToc">4 <a + href="#QQ1-1-16" name="QQ2-1-16">Examples</a></span> + + </div> + <h3 class="likesectionHead"><a + name="x1-2000"></a><a + name="QQ1-1-2"></a>List of Figures</h3> + <div class="tableofcontents"><span class="lofToc">1 <a + href="#x1-110011">Metapost illustration of an <span +class="cmcsc-10--109"><small +class="small-caps">E</small><small +class="small-caps">X</small><small +class="small-caps">P</small><small +class="small-caps">R</small><small +class="small-caps">E</small><small +class="small-caps">S</small><small +class="small-caps">S</small>-<small +class="small-caps">G</small> </span>diagram</a></span><br> + </div> + + <h3 class="sectionHead"> 1 <a + name="x1-30001"></a><a + name="QQ1-1-3"></a>Introduction</h3> +<!--63--><p class="noindent">Publishing on the Web has rapidly achieved significant importance, for example, the International +Organization for Standardization (ISO) is moving towards electronic forms of International +Standard documents that are suitable for publishing on the Web, and in particular, documents +as PDF or HTML files rather than their traditional request for camera-ready paper +copy. +<!--70--><p class="indent"> Documents written using LaTeX [<a + href="#XLAMPORT94">Lam94</a>] tagging can be easily converted to PostScript, PDF +and HTML, all from the single electronic source. This guide briefly notes some of the ways that +this can be accomplished. Most of the programs and systems mentioned here are described in +more detail in [<a + href="#XGOOSSENS99">GR99</a>]. +<!--77--><p class="indent"> I have made no attempt to design this document for Web publication. The typographical rules +for printing on paper are well founded, having been developed over hundreds of years. +Display on computer screens is a very different matter and requires a different set of +rules, most of which, as yet, are either in a state of flux or unavailable. For LaTeXers +who are interested in this topic I suggest a look at D. P. Story's work on AcroTeX ( +<a + href="http://www.math.uakron.edu/~dpstory/acrotex.html" class="url" ><span +class="cmtt-10--109">http://www.math.uakron.edu/~dpstory/acrotex.html</span></a>). Further, for the example conversions I +have used only the minimal tool options necessary. Many of the tools have extensive capabilities +which are well documented in their accompanying user manuals; these should be consulted for +further information. + <h4 class="subsectionHead">1.1 <a + name="x1-40001.1"></a><a + name="QQ1-1-4"></a>URLs</h4> +<!--92--><p class="noindent">I have tried to provide URLs for the programs and systems mentioned here. Most LaTeX-related +software is available from the Comprehensive TeX Archive Network (CTAN). There are three +sites, <a + href="ftp://ctan.tug.org/tex-archive" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive</span></a> in the USA, <a + href="ftp://ftp.tex.ac.uk/tex-archive" class="url" ><span +class="cmtt-10--109">ftp://ftp.tex.ac.uk/tex-archive</span></a> in +the UK, and <a + href="ftp://ftp.dante.de/tex-archive" class="url" ><span +class="cmtt-10--109">ftp://ftp.dante.de/tex-archive</span></a> in Germany, as well as several mirror sites. +Usefully, the CTAN sites (but not necessarily a mirror site) supports on-the-fly zipping of files and +entire directories, which makes downloading a group of files less tedious than having to get them +one-by-one. Below, I have used <a + href="ftp://ctan.tug.org/tex-archive" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive</span></a> to stand for any of the three +CTAN sites. + <h4 class="subsectionHead">1.2 <a + name="x1-50001.2"></a><a + name="QQ1-1-5"></a>Disclaimer</h4> +<!--107--><p class="noindent">Nothing that is said in this document is meant to imply any endorsement or recommendation, +either positive or negative, concerning any systems or programs mentioned herein. +<!--111--><p class="indent"> Many of the systems or programs are `free' in the sense that they are either public domain or +their licences are roughly equivalent to the GNU Public License. Others are either commercial or +have more restricitive licenses or may require payment. Where known, programs and systems that +are not `free' are noted. + + <h3 class="sectionHead"> 2 <a + name="x1-60002"></a><a + name="QQ1-1-6"></a>PDF</h3> +<!--120--><p class="noindent">The traditional output from a LaTeX (e.g., <span +class="cmss-10--109">*.tex</span>) file is a `device independent' <span +class="cmss-10--109">*.dvi </span>file. The <span +class="cmss-10--109">*.dvi</span> +file is then processed further to convert it to a format suitable for printing on a particular printing +device. In the vast majority of cases the final printable format has been PostScript, +obtained by running the <span +class="cmss-10--109">*.dvi </span>file through a program like <span +class="cmtt-10--109">dvips</span>, to generate a <span +class="cmss-10--109">*.ps</span> +file. +<!--127--><p class="indent"> PostScript was developed by Adobe Systems. The Portable Document Format (PDF) has +since also been developed by Adobe, and seems to be overtaking PostScript as the format of +choice for printing, and especially for display via the Web. +<!--132--><p class="indent"> DVI and PDF are somewhat similar in that they both describe where (electronic) ink is to be +put on (electronic) paper. PostScript also does this but at the same time it is a complete +programming language. This means that it is inherently more difficult, time consuming, and +computer intensive, to process PostScript than either DVI or PDF. This is probably the reason +behind the popularity of PDF on the Web. +<!--139--><p class="indent"> There are now several methods of producing a PDF (e.g., <span +class="cmss-10--109">*.pdf</span>) file from <span +class="cmss-10--109">*.tex</span>. These +include: + <ul class="itemize1"> + <li class="itemize">Converting from PostScript to PDF; from <span +class="cmss-10--109">*.ps </span>to <span +class="cmss-10--109">*.pdf</span>. + </li> + <li class="itemize">Generate PDF from the device independent file; from <span +class="cmss-10--109">*.dvi </span>to <span +class="cmss-10--109">*.pdf</span> + </li> + <li class="itemize">Generate PDF directly from the LaTeX source; from <span +class="cmss-10--109">*.tex </span>to <span +class="cmss-10--109">*.pdf</span>.</li></ul> + <h4 class="subsectionHead">2.1 <a + name="x1-70002.1"></a><a + name="QQ1-1-7"></a>From PostScript to PDF</h4> +<!--153--><p class="noindent">There are basically two routes to getting from PostScript to PDF. The first of these is to use +Acrobat software from Adobe Systems, which essentially means the commercial <span +class="cmtt-10--109">Distiller</span> +program. <span +class="cmtt-10--109">Distiller </span>can read in a PostScript file and output a PDF file where the visual results +of printing the two files are identical. This, or any other, PDF file can be viewed and/or printed +via the charge-free Acrobat <span +class="cmtt-10--109">Reader </span>program. Note that when using <span +class="cmtt-10--109">Reader </span>the `fit to +paper' option may alter the page layout, for example by changing the height of the text +block. +<!--164--><p class="indent"> The second route is to use a non-Adobe converter program, like <span +class="cmtt-10--109">Ghostscript </span>which runs on +nearly all operating systems and which is obtainable from <a + href="http://www.cs.wisc.edu/~ghost" class="url" ><span +class="cmtt-10--109">http://www.cs.wisc.edu/~ghost</span></a>. +The <span +class="cmtt-10--109">Ghostscript </span>distribution comes with a script called <span +class="cmtt-10--109">ps2pdf </span>which performs the conversion. +The distribution also provides the popular <span +class="cmtt-10--109">Ghostview </span>program, which is a viewer for both +PostScript and PDF files. +<!--172--><p class="indent"> Another converter program, which does have some licensing conditions that may not be suitable +for all users, is <span +class="cmtt-10--109">PStill</span>; it is available from <a + href="http://www.this.net/~frank/pstill.html" class="url" ><span +class="cmtt-10--109">http://www.this.net/~frank/pstill.html</span></a>. + + <h4 class="subsectionHead">2.2 <a + name="x1-80002.2"></a><a + name="QQ1-1-8"></a>From DVI to PDF</h4> +<!--179--><p class="noindent">Mark Wicks' <span +class="cmtt-10--109">dvipdfm </span>program ( <a + href="http://odo.kettering.edu/dvipdfm" class="url" ><span +class="cmtt-10--109">http://odo.kettering.edu/dvipdfm</span></a>) converts a <span +class="cmss-10--109">*.dvi </span>file to a +<span +class="cmss-10--109">*.pdf </span>file. The program is used in the same manner as <span +class="cmtt-10--109">dvips </span>and provides similar +capabilities. +<!--184--><p class="indent"> PostScript illustrations are handled in one of two ways. Simple PostScript generated by +the <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small> </span>program [<a + href="#XHOBBY92">Hob92</a>] is included natively. Any other PostScript file is first +converted to PDF by using an external program like <span +class="cmtt-10--109">Ghostscript </span>and then inserted +into the output file. Illustrations in PDF, PNG and JPEG formats require no external +aids. +<!--191--><p class="indent"> <span +class="cmtt-10--109">dvipdfm </span>is written in C but there are some binaries for Linux systems. + <h4 class="subsectionHead">2.3 <a + name="x1-90002.3"></a><a + name="QQ1-1-9"></a>From LaTeX to PDF</h4> +<!--197--><p class="noindent">The <span +class="cmtt-10--109">pdfLaTeX </span>program being developed by Hàn Thê Thành is a modified version of TeX that +generates <span +class="cmss-10--109">*.pdf </span>instead of <span +class="cmss-10--109">*.dvi </span>output files. <span +class="cmtt-10--109">pdfLaTeX </span>is distributed with many of the free LaTeX +distributions, and is also obtainable from <a + href="ftp://ftp.cstug.cz/pub/tex/local/cstug/thanh" class="url" ><span +class="cmtt-10--109">ftp://ftp.cstug.cz/pub/tex/local/cstug/thanh</span></a>, +although it may be better to try <a + href="ftp://ctan.tug.org/tex-archive/systems/pdftex" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/systems/pdftex</span></a>. +<!--204--><p class="indent"> Running <span +class="cmtt-10--109">pdfLaTeX </span>is very similar to running LaTeX, but some minor changes are required to +the <span +class="cmss-10--109">*.tex </span>file. For example: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + % example.tex example latex file + \documentclass[...]{...} + \newif\ifpdf + \ifx\pdfoutput\undefined + \pdffalse + \else + \pdftrue + \fi + + \ifpdf + \pdfoutput=1 + % \usepackage[pdftex]{graphicx} % uncomment if using graphicx + % \usepackage[pdftex]{hyperref} % uncomment if using hyperref + \else + % \usepackage{graphicx} % uncomment if using graphicx + % \usepackage{hyperref} % uncomment if using hyperref + \fi + .... +</pre> +</td></tr></table> +<!--227--><p class="indent"> Running + +<br class="newline"><span +class="cmtt-10--109">latex example</span> +<br class="newline">will produce <span +class="cmss-10--109">example.dvi</span>, while running +<br class="newline"><span +class="cmtt-10--109">pdflatex example</span> +<br class="newline">will produce <span +class="cmss-10--109">example.pdf</span>. It is thus very easy to generate both <span +class="cmss-10--109">*.dvi </span>and <span +class="cmss-10--109">*.pdf </span>from the same +LaTeX source file. +<!--234--><p class="indent"> <span +class="cmtt-10--109">pdflatex </span>will handle graphics files in the following formats: PDF, PNG, JPEG and TIFF, but +notice that (Encapsulated) PostScript is missing from this list. However, it can handle directly the +simple Encapsulated PostScript output by <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small></span> [<a + href="#XHOBBY92">Hob92</a>]. It does, though, expect +<span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small> </span>files to have a <span +class="cmss-10--109">.mps </span>extension. To include PostScript from other sources it is necessary +to convert the PostScript to PDF. +<!--242--><p class="indent"> <span +class="cmtt-10--109">pdftex</span>, and hence <span +class="cmtt-10--109">pdflatex</span>, has some extra primitive commands that are not available in +TeX itself specifically for accessing aspects of the PDF format, for example to create hypertext +links, bookmarks or article threads. Consult the manual for details. +<!--248--><p class="indent"> Independently of <span +class="cmtt-10--109">pdflatex </span>the <span +class="cmtt-10--109">hyperref </span>package ( +<a + href="ftp://ctan.tug.org/tex-archive/macros/latex/contrib/supported/hyperref" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/macros/latex/contrib/supported/hyperref</span></a>) extends the +functionality of the LaTeX cross-referencing commands to include hypertext links, and also ad hoc +hypertext links to, for example, external documents and URLs. + <h4 class="subsectionHead">2.4 <a + name="x1-100002.4"></a><a + name="QQ1-1-10"></a>Fonts</h4> +<!--256--><p class="noindent">The normal fonts used with LaTeX are the Computer Modern family developed by Knuth using +<span +class="cmcsc-10--109"><small +class="small-caps">M</small><small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small><small +class="small-caps">F</small><small +class="small-caps">O</small><small +class="small-caps">N</small><small +class="small-caps">T</small></span> [<a + href="#XKNUTH86b">Knu86</a>]. All <span +class="cmcsc-10--109"><small +class="small-caps">M</small><small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small><small +class="small-caps">F</small><small +class="small-caps">O</small><small +class="small-caps">N</small><small +class="small-caps">T</small> </span>fonts are in the form of bitmaps, which is unfortunate when it +comes to PDF. Typically, PDF will only use one size of each font for a document, and will scale +this if different font sizes are required. This normally works well as fonts used with PDF are +typically `Type 1' fonts (e.g., PostScript fonts) which are designed to be scaleable. Bitmap +fonts look terrible when scaled or printed at a resolution that they were not designed +for. +<!--266--><p class="indent"> In other words, expect bad results if you generate a PDF file with the original Computer +Modern fonts. +<!--269--><p class="indent"> Perhaps the easiest method of dealing with this is to use the most common PostScript fonts, +namely Times, Courier and Helvetica. All that is necessary is to add <span class="obeylines-h"><span +class="cmtt-10--109">\usepackage{times}</span></span> to the +document's preamble. +<!--273--><p class="indent"> Alternatively, if you need to use the CM fonts, perhaps because a lot of mathematics is +involved, many LaTeX distributions include Type 1 versions of the CM fonts. If you don't have +them they can be found at <a + href="ftp://ctan.tug.org/tex-archive/fonts/cm/ps-type1/bluesky" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/fonts/cm/ps-type1/bluesky</span></a> +and at <a + href="ftp://ctan.tug.org/tex-archive/fonts/amsfonts/ps-type1" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/fonts/amsfonts/ps-type1</span></a> for the AMS +fonts. +<!--279--><p class="indent"> Goossens <span +class="cmti-10--109">et al. </span>provide useful and general information on installing and using different fonts +with LaTeX [<a + href="#XGOOSSENS94">GMS94</a>], while for the fontophile, Alan Hoenig [<a + href="#XHOENIG98">Hoe98</a>] delves much more deeply into +the installation of PostScript fonts. +<!--284--><p class="indent"> TeX doesn't care about the particular shape of any glyph, nor how it is constructed or +represented, it only cares about the space occupied by each character (i.e., the <span +class="cmss-10--109">*.tfm </span>files). It is +the DVI processor that needs to know in detail about the fonts in a document. So, the DVI + +processor has to be told to use Type 1 CM PostScript fonts. The following is for the +<span +class="cmtt-10--109">dvips </span>program. For convenience, let <span +class="cmtt-10--109">$TEXMF </span>stand for the root of the <span +class="cmtt-10--109">texmf </span>tree (e.g., +<span +class="cmtt-10--109">/usr/teTeX/texmf</span>). +<!--294--><p class="indent"> <span +class="cmtt-10--109">dvips </span>looks in the <span +class="cmtt-10--109">$TEXMF/dvips/base/psfonts.map </span>to see if it can use any PostScript fonts. +This file starts off something like: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + bchb8r CHarterBT-Bold "TeXBase1Encoding ReEncodeFont" <8r.enc <bchb8a.pfb + ... +</pre> +</td></tr></table> To get <span +class="cmtt-10--109">dvips </span>to use Type 1 versions of the CM fonts, additional lines must be added to +<span +class="cmss-10--109">psfonts.map </span>giving similar information about the fonts. The specification for CM fonts is simpler +and consists of lines like: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + cmb10 CMB10 <cmb10.pfb + cmbsy10 CMBSY10 <cmbsy10.pfb + ... +</pre> +</td></tr></table> In the version of <span +class="cmtt-10--109">teTeX </span>that I use, this information is in files <span +class="cmss-10--109">bsr.map</span>, <span +class="cmss-10--109">bsr-interpolated.map</span>, +<span +class="cmss-10--109">cmcyr.map</span>, <span +class="cmss-10--109">hoekwater.map</span>, and <span +class="cmss-10--109">pl.map</span>, all in directory <span +class="cmtt-10--109">$TEXMF/dvips/config</span>. +<!--315--><p class="indent"> These files can either be copied by hand to the <span +class="cmss-10--109">psfonts.map </span>file in <span +class="cmtt-10--109">$TEXMF/dvips/base </span>or in a +modern <span +class="cmtt-10--109">teTeX </span>distribution (which should also have all the CM Type 1 font data) it is easiest to do +the following: + <ul class="itemize1"> + <li class="itemize">In directory <span +class="cmtt-10--109">$TEXMF/dvips/config </span>copy the script file <span +class="cmtt-10--109">updmap </span>to, say, <span +class="cmtt-10--109">updmap.orig</span>. + </li> + <li class="itemize">Edit <span +class="cmtt-10--109">updmap </span>to comment the line <span +class="cmtt-10--109">type1</span>_<span +class="cmtt-10--109">default=false </span>and uncomment the line + <span +class="cmtt-10--109">type1</span>_<span +class="cmtt-10--109">default=true</span>. + </li> + <li class="itemize">Run the script via <span +class="cmtt-10--109">./updmap</span>.</li></ul> +<!--327--><p class="noindent">Another more general method is to edit the file <span +class="cmss-10--109">config.ps </span>in directory <span +class="cmtt-10--109">$TEXMF/dvips/config </span>and +at the appropriate place (which should be marked, but in any case after the line <span +class="cmtt-10--109">p psfonts.map</span>) +add lines like: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + p +bsr.map + p +bsr-interpolated.map + ... +</pre> +</td></tr></table> + +<!--337--><p class="indent"> Another option when using <span +class="cmtt-10--109">dvips </span>which avoids all of the above, is to call it with options, +like: +<br class="newline"><span class="obeylines-h"><span +class="cmtt-10--109">dvips</span> <span +class="cmtt-10--109">-Pamz</span> <span +class="cmtt-10--109">-Pcmz</span> <span +class="cmtt-10--109">-Ppdf</span> <span +class="cmtt-10--109">-j0</span> <span +class="cmtt-10--109">[other</span> <span +class="cmtt-10--109">options]</span> <span +class="cmtt-10--109">filename</span></span> +<br class="newline">and then use your prefered <span +class="cmss-10--109">*.ps </span>to <span +class="cmss-10--109">*.pdf </span>conversion process. + <h4 class="subsectionHead">2.5 <a + name="x1-110002.5"></a><a + name="QQ1-1-11"></a>MetaPost</h4> +<!--344--><p class="noindent">John Hobby's <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small></span> [<a + href="#XHOBBY92">Hob92</a>] is a language based drawing program based on Knuth's +<span +class="cmcsc-10--109"><small +class="small-caps">M</small><small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small><small +class="small-caps">F</small><small +class="small-caps">O</small><small +class="small-caps">N</small><small +class="small-caps">T</small></span> [<a + href="#XKNUTH86b">Knu86</a>]. <span +class="cmcsc-10--109"><small +class="small-caps">M</small><small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small><small +class="small-caps">F</small><small +class="small-caps">O</small><small +class="small-caps">N</small><small +class="small-caps">T</small> </span>was principally designed for creating fonts, and generates +bitmapped output, while <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small> </span>is principally for drawing general line illustrations and its +output is a particularly simple form of Encapsulated PostScript. + +<a + name="x1-110011"></a> + <hr class="float"><div align="center" class="float" +><table class="float"><tr class="float"><td class="float" +> + +<img +src="webguide0x.gif" alt="PIC" > +<br> <div align="center" class="caption"><table class="caption" +><tr valign="baseline" class="caption"><td class="id">Figure 1: </td><td +class="content">Metapost illustration of an <span +class="cmcsc-10--109"><small +class="small-caps">E</small><small +class="small-caps">X</small><small +class="small-caps">P</small><small +class="small-caps">R</small><small +class="small-caps">E</small><small +class="small-caps">S</small><small +class="small-caps">S</small>-<small +class="small-caps">G</small> </span>diagram</td></tr></table></div> +<a + name="x1-110011"></a> + + </td></tr></table></div><hr class="endfloat"> + This is not the place to describe <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small></span>, but it can generate several output files, one for +each drawing, from a single input file called, say, <span +class="cmss-10--109">fred.mp</span>. The output files have a numeric +extension correspond to the number of the drawing. So, for example, it may generate files <span +class="cmss-10--109">fred.1</span>, +<span +class="cmss-10--109">fred.2 </span>and <span +class="cmss-10--109">fred.3</span>. For a document that is to be processed via <span +class="cmtt-10--109">LaTeX </span>these files can be included as +is. However, for processing through <span +class="cmtt-10--109">pdfLaTeX</span>, the files must have a <span +class="cmss-10--109">.mps </span>extension; for example +<span +class="cmss-10--109">fred1.mps</span>, <span +class="cmss-10--109">fred2.mps </span>and <span +class="cmss-10--109">fred3.mps</span>. +<!--371--><p class="indent"> Figure <a + href="#x1-110011">1</a> is a <span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small> </span>illustration that is included in this document by the code: +<table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + \begin{figure} + \centering + \ifpdf + \includegraphics{expeg6.mps} + \else + \includegraphics{expeg.6} + \fi + \caption{Metapost illustration of an \textsc{express-g} diagram} + \label{fig:mp} + \end{figure} +</pre> +</td></tr></table> where <span +class="cmss-10--109">expeg6.mps </span>is a copy of <span +class="cmss-10--109">expeg.6</span>, to cater for processing by either <span +class="cmtt-10--109">LaTeX </span>or <span +class="cmtt-10--109">pdfLaTeX</span>. +Actually, the following will also work: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + \begin{figure} + \centering + \includegraphics{expeg6.mps} + \caption{Metapost illustration of an \textsc{express-g} diagram} + \label{fig:mp} + \end{figure} +</pre> +</td></tr></table> +<!--397--><p class="indent"> The figure demonstrates part of the capabilities of the <span +class="cmtt-10--109">expressg </span><span +class="cmcsc-10--109">M<small +class="small-caps">E</small><small +class="small-caps">T</small><small +class="small-caps">A</small>P<small +class="small-caps">O</small><small +class="small-caps">S</small><small +class="small-caps">T</small> </span>package ( +<a + href="ftp://ctan.tug.org/tex-archive/graphics/metapost/contrib/macros/expressg" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/graphics/metapost/contrib/macros/expressg</span></a>) for +drawing diagrams consisting of boxes, lines and annotations, such as flowcharts or ER +diagrams. + <h3 class="sectionHead"> 3 <a + name="x1-120003"></a><a + name="QQ1-1-13"></a>HTML</h3> + +<!--406--><p class="noindent">There are a number of systems that convert a LaTeX tagged document into an HTML tagged +document. These can be divided into two classes: + <ol type="1" class="enumerate1" +> + <li class="enumerate"><a + name="x1-12002x1"></a>Systems that parse the <span +class="cmss-10--109">*.tex </span>file themselves. + </li> + <li class="enumerate"><a + name="x1-12004x2"></a>Systems that use TeX as the file parser.</li></ol> +<!--412--><p class="noindent">There are several that do their own parsing, but only one that I know of that uses TeX as the +parser. +<!--415--><p class="indent"> TeX is a macro language and the meaning of existing commands can be changed on the +fly, and also new commands can be defined on the fly [<a + href="#XKNUTH84a">Knu84</a>]. As perhaps the most +extreme example of this is David Carlisle's <span +class="cmss-10--109">xii.tex </span>TeX code, which is obtainable as +<a + href="ftp://ctan.tug.org/tex-archive/macros/plain/contrib/xii.tex" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/macros/plain/contrib/xii.tex</span></a>: <table width="100%" +class="verbatim"><tr class="verbatim"><td +class="verbatim"><pre class="verbatim"> + \let~\catcode~`76~`A13~`F1~`j00~`P2jdefA71F~`7113jdefPALLF + PA''FwPA;;FPAZZFLaLPA//71F71iPAHHFLPAzzFenPASSFthP;A$$FevP + A@@FfPARR717273F737271P;ADDFRgniPAWW71FPATTFvePA**FstRsamP + AGGFRruoPAqq71.72.F717271PAYY7172F727171PA??Fi*LmPA&&71jfi + Fjfi71PAVVFjbigskipRPWGAUU71727374 75,76Fjpar71727375Djifx + :76jelse&U76jfiPLAKK7172F71l7271PAXX71FVLnOSeL71SLRyadR@oL + RrhC?yLRurtKFeLPFovPgaTLtReRomL;PABB71 72,73:Fjif.73.jelse + B73:jfiXF71PU71 72,73:PWs;AMM71F71diPAJJFRdriPAQQFRsreLPAI + I71Fo71dPA!!FRgiePBt'el@ lTLqdrYmu.Q.,Ke;vz vzLqpip.Q.,tz; + ;Lql.IrsZ.eap,qn.i. i.eLlMaesLdRcna,;!;h htLqm.MRasZ.ilk,% + s$;z zLqs'.ansZ.Ymi,/sx ;LYegseZRyal,@i;@ TLRlogdLrDsW,@;G + LcYlaDLbJsW,SWXJW ree @rzchLhzsW,;WERcesInW qt.'oL.Rtrul;e + doTsW,Wk;Rri@stW aHAHHFndZPpqar.tridgeLinZpe.LtYer.W,:jbye +</pre> +</td></tr></table> If you run this through TeX (not LaTeX) I'm sure you will be surprised at the result. +<!--439--><p class="indent"> There is inevitably a problem when converting from LaTeX to HTML for a document that +includes figures/illustrations or anything more than the most simple mathematical typesetting as, +basically, HTML provides no support. Typically, mathematics and illustrations, are converted to a +picture format and then inserted into the HTML document as graphics, usually with a very poor +appearance. +<!--447--><p class="indent"> However, for mathematics the situation is starting to change because of the advent of +MathML ( <a + href="http://www.w3.org/TR/MathML2" class="url" ><span +class="cmtt-10--109">http://www.w3.org/TR/MathML2</span></a>). In particular the Milestone 13 release of Mozilla ( +<a + href="http://www.mozilla.org/binaries.html" class="url" ><span +class="cmtt-10--109">http://www.mozilla.org/binaries.html</span></a>) is a MathML-enabled browser. Some examples, +generated by <span +class="cmtt-10--109">TeX4ht</span>, are available at <a + href="http://www.maths.ox.ac.uk/~gartside/mozSuccess" class="url" ><span +class="cmtt-10--109">http://www.maths.ox.ac.uk/~gartside/mozSuccess</span></a>. +<!--454--><p class="indent"> All the systems generate HTML tagged documents, with the particular tagging `style' set by +the system. It is advantageous to use a converter which either by default generates your desired +style, or which can be modified in some manner to do so. + + <h4 class="subsectionHead">3.1 <a + name="x1-130003.1"></a><a + name="QQ1-1-14"></a>Self-parsing systems</h4> +<!--461--><p class="noindent">The self-parsing systems incorporate their own parsers for the TeX language. In essence, this +means that they `know' the meaning of common TeX commands, but probably not all possible +commands. It is advantageous to use a system that can be extended to deal with commands that +were not anticipated by the author. +<!--467--><p class="indent"> The only system I am familiar with in this class is Peter Wilson's <span +class="cmtt-10--109">ltx2x </span>program ( +<a + href="ftp://ctan.tug.org/tex-archive/support/ltx2x" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/support/ltx2x</span></a>). This program works by replacing known +LaTeX commands, and their arguments, by user-specified text strings [<a + href="#XPRW96h">Wil96</a>]. It is unable to +handle anything more than very simple mathematics and ignores any pictures. The user-specified +command texts are kept in a simple command-table file. Within limits, new LaTeX commands +and environments may be specified within a command-table file and the command texts modified. +The <span +class="cmtt-10--109">ltx2x </span>program has been used to `detex' (i.e., remove all LaTeX commands) files, +convert to HTML, and convert to SGML. It cannot convert to XML due to a yet to be +resolved technical problem in dealing with end of paragraph tags. The program is written +in C and so requires a C compiler for installation. The system can be extended via +some C programming, in which case the <span +class="cmtt-10--109">flex </span>and <span +class="cmtt-10--109">bison </span>programs are also required. +There is no chance that <span +class="cmtt-10--109">ltx2x </span>would ever make any sense whatsoever of <span +class="cmss-10--109">xii.tex </span>on +page <a + href="#x1-120003">10</a>. +<!--485--><p class="indent"> Perhaps the most venerable system is the <span +class="cmtt-10--109">LaTeX2HTML </span>system +( <a + href="http://www-texdev.mpce.mq.edu.au/l2h/docs/manual" class="url" ><span +class="cmtt-10--109">http://www-texdev.mpce.mq.edu.au/l2h/docs/manual</span></a> or +<a + href="ftp://ctan.tug.org/tex-archive/support/latex2html" class="url" ><span +class="cmtt-10--109">ftp://ctan.tug.org/tex-archive/support/latex2html</span></a>), originally by Nikos Drakos +and now maintained by Ross Moore and others. This system is written using <span +class="cmtt-10--109">Perl </span>( +<a + href="ftp://ftp.uu.net/languages/perl" class="url" ><span +class="cmtt-10--109">ftp://ftp.uu.net/languages/perl</span></a>). It also requires a database management system such as the +Unix DBM or NDBM, or the GNU GDBM system. Further, it requires <span +class="cmtt-10--109">Ghostscript </span>and the +<span +class="cmtt-10--109">netpbm </span>library of graphics utilities ( <a + href="ftp://ftp.x.org/contrib/utilities" class="url" ><span +class="cmtt-10--109">ftp://ftp.x.org/contrib/utilities</span></a>). To extend or +change the default conversion style requires, I think, some Perl programming. A fuller description +and examples are given in [<a + href="#XGOOSSENS99">GR99</a>]. +<!--497--><p class="indent"> Another converter is the <span +class="cmtt-10--109">TtH </span>program by Ian Hutchinson ( <a + href="http://hutchinson.belmont.ma.us/tth" class="url" ><span +class="cmtt-10--109">http://hutchinson.belmont.ma.us/tth</span></a>) +which is cost-free for non-commercial use; commercial use in this case is roughly by anyone who gets +paid while using it (but see <a + href="http://hutchinson.belmont.ma.us/tth/tth-commercial/email.html" class="url" ><span +class="cmtt-10--109">http://hutchinson.belmont.ma.us/tth/tth-commercial/email.html</span></a> +for the actual wording). There is also another version, <span +class="cmtt-10--109">TeX2HTML </span>( <a + href="http://www.tex2html.com" class="url" ><span +class="cmtt-10--109">http://www.tex2html.com</span></a>) +which is the `commercial GOLD version of the freeware <span +class="cmtt-10--109">Tth </span>by Ian Hutchinson'. These programs +run on the usual range of operating systems. An example of the output from <span +class="cmtt-10--109">TtH </span>is given +in [<a + href="#XGOOSSENS99">GR99</a>]. + <h4 class="subsectionHead">3.2 <a + name="x1-140003.2"></a><a + name="QQ1-1-15"></a>TeX-based parsing system</h4> +<!--510--><p class="noindent">Eitan Gurari's <span +class="cmtt-10--109">TeX4ht </span>system appears to be unique in that it uses TeX as the +parser for the LaTeX document and instead effectively takes the <span +class="cmss-10--109">*.dvi </span>file as its +starting point for conversion to HTML. That is, it does not have to understand TeX +code and can, in fact, convert David Carlise's <span +class="cmss-10--109">xii.tex </span>(page <a + href="#x1-120003">10</a>) to HTML. The system + +is available from <a + href="http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html" class="url" ><span +class="cmtt-10--109">http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html</span></a>. It +consists of two C programs, one package file, and a set of <span +class="cmss-10--109">*.4ht </span>configuration files, one +for each of the typical LaTeX classes and packages. It also requires ImageMagick ( +<a + href="http://www.wizards.dupont.com/cristy/www/archives.html" class="url" ><span +class="cmtt-10--109">http://www.wizards.dupont.com/cristy/www/archives.html</span></a>) for handling illustrations and +non-simple mathematics. Simply speaking, the system is extended by writing new <span +class="cmss-10--109">*.4ht </span>file(s) and +its output modified by writing simple <span +class="cmss-10--109">*.cfg </span>file(s) that override the <span +class="cmss-10--109">*.4ht </span>file(s). At the moment, +the best and most detailed description is given in [<a + href="#XGOOSSENS99">GR99</a>]. +<!--528--><p class="indent"> By default, <span +class="cmtt-10--109">TeX4ht </span>can generate a non-tagged file or a file tagged with either HTML3.2 or +HTML4.0. By writing appropriate <span +class="cmss-10--109">*.cfg </span>files it can be made to generate XML tagged files. The +system comes with a script called <span +class="cmtt-10--109">htlatex </span>which controls the conversion process from LaTeX; +there is also the <span +class="cmtt-10--109">httex </span>script for converting a TeX document. For instance, to convert the earlier +example LaTeX file, <span +class="cmss-10--109">example.tex </span>(page <a + href="#x1-90002.3">3</a>), to an HTML4.0 tagged document, it is enough to +run: +<br class="newline"><span +class="cmtt-10--109">htlatex example</span> +<br class="newline">which will then output <span +class="cmss-10--109">example.html</span>. Similarly, to convert <span +class="cmss-10--109">xii.tex </span>just run: +<br class="newline"><span +class="cmtt-10--109">httex xii</span>. + <h3 class="sectionHead"> 4 <a + name="x1-150004"></a><a + name="QQ1-1-16"></a>Examples</h3> +<!--543--><p class="noindent">Hopefully, you should find several versions of this document, all of which have been generated +from a single source file. These are: + <ul class="itemize1"> + <li class="itemize"><span +class="cmss-10--109">webguide.tex </span>-- the LaTeX source. + </li> + <li class="itemize"><span +class="cmss-10--109">webguide.ps </span>-- A PostScript version from running <span +class="cmtt-10--109">latex </span>and <span +class="cmtt-10--109">dvips </span>on <span +class="cmss-10--109">webguide.tex</span>. + </li> + <li class="itemize"><span +class="cmss-10--109">webguide.pdf </span>-- A PDF version from runnning <span +class="cmtt-10--109">pdflatex </span>on <span +class="cmss-10--109">webguide.tex</span>. + </li> + <li class="itemize"><span +class="cmss-10--109">webguide.html </span>-- A HTML4.0 version from running <span +class="cmtt-10--109">htlatex </span>on <span +class="cmss-10--109">webguide.tex</span>.</li></ul> +<!--554--><p class="noindent">The HTML version uses the GIF file <span +class="cmss-10--109">webguide0x.gif </span>for the illustration; the file is automatically +generated by <span +class="cmtt-10--109">tex4ht </span>using the ImageMagick <span +class="cmtt-10--109">convert </span>program. The quality of the picture in the +viewed document depends on the particular viewer; different versions of Netscape, for example, +may display and print the diagram with very different rendering qualities. I asked TeX4ht to +generate this particular figure at 180dpi instead of the default 110dpi to improve the +quality. + <h3 class="likesectionHead"><a + name="x1-160004"></a><a + name="QQ1-1-17"></a>References</h3> + + <div class="thebibliography"><p class="bibitem"> +[GMS94] <a + name="XGOOSSENS94"></a>Michel Goossens, Frank Mittelbach, and Alexander Samarin. <span +class="cmti-10--109">The LaTeX</span> + <span +class="cmti-10--109">Companion</span>. Addison-Wesley Publishing Company, 1994. + </p><p class="bibitem"> +[GR99] <a + name="XGOOSSENS99"></a>Michel Goossens and Sebastion Rahtz. <span +class="cmti-10--109">The LaTeX Web Companion - Integrating</span> + <span +class="cmti-10--109">TeX, HTML, and XML</span>. Addison-Wesley Publishing Company, 1999. (with Eitan + Gurari, Ross Moore, and Robert Sutor). + </p><p class="bibitem"> +[Hob92] <a + name="XHOBBY92"></a>John Hobby. <span +class="cmti-10--109">‘A User’s Manual for MetaPost’</span>. Technical Report 162, AT&T Bell + Laboratories, Murray Hill, NJ, 1992. + </p><p class="bibitem"> +[Hoe98] <a + name="XHOENIG98"></a>Alan Hoenig. <span +class="cmti-10--109">TeX Unbound - LaTeX and TeX Strategies for Fonts, Graphics, &</span> + <span +class="cmti-10--109">More</span>. Oxford University Press, 1998. + </p><p class="bibitem"> +[Knu84] <a + name="XKNUTH84a"></a>Donald E. Knuth. <span +class="cmti-10--109">The TeXbook</span>. Addison-Wesley Publishing Company, 1984. + </p><p class="bibitem"> +[Knu86] <a + name="XKNUTH86b"></a>Donald E. Knuth. <span +class="cmti-10--109">The METAFONTbook</span>. Addison-Wesley Publishing Company, + 1986. + </p><p class="bibitem"> +[Lam94] <a + name="XLAMPORT94"></a>Leslie Lamport. <span +class="cmti-10--109">LaTeX: A Document Preparation System</span>. Addison-Wesley + Publishing Company, second edition, 1994. + </p><p class="bibitem"> +[Wil96] <a + name="XPRW96h"></a>Peter R. Wilson. <span +class="cmti-10--109">ltx2x: A LaTeX to X Auto-tagger</span>. NIST Report NISTIR, June + 1996. + </p></div> + +</body> +</html> + + + diff --git a/Master/texmf-dist/doc/latex/webguide/webguide.pdf b/Master/texmf-dist/doc/latex/webguide/webguide.pdf Binary files differnew file mode 100644 index 00000000000..ffdca467fa7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide.pdf diff --git a/Master/texmf-dist/doc/latex/webguide/webguide.ps.gz b/Master/texmf-dist/doc/latex/webguide/webguide.ps.gz Binary files differnew file mode 100644 index 00000000000..02f64e75d0b --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide.ps.gz diff --git a/Master/texmf-dist/doc/latex/webguide/webguide.tex b/Master/texmf-dist/doc/latex/webguide/webguide.tex new file mode 100644 index 00000000000..4b22433386e --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide.tex @@ -0,0 +1,615 @@ +% webguide.tex Guide to LaTeX, STEP and the Web, etc + +\documentclass[11pt]{article} + +% a11pream.tex generic preamble +\usepackage{url} +%\usepackage{ltx2html} +\setlength{\textheight}{8.0in} +\setlength{\textwidth}{6.0in} +\setlength{\oddsidemargin}{0.25in} +\setlength{\evensidemargin}{0.25in} +\setlength{\marginparwidth}{0.6in} +\setcounter{secnumdepth}{4} +\setcounter{tocdepth}{4} + +%% \usepackage{times} + +\newif\ifpdf +\ifx\pdfoutput\undefined + \pdffalse +\else + \pdftrue +\fi + +\ifpdf + \pdfoutput=1 + \usepackage[pdftex]{graphicx} +\else + \usepackage{graphicx} +\fi + +\newcommand{\file}[1]{\textsf{#1}} +\newcommand{\program}[1]{\texttt{#1}} +\newcommand{\package}[1]{\texttt{#1}} +\newcommand{\mpost}{\textsc{MetaPost}} +\newcommand{\mfont}{\textsc{metafont}} +\newcommand{\Han}{H\`{a}n Th\^{e} Th\`{a}nh} +\newcommand{\tex}{TeX} +\newcommand{\latex}{LaTeX} + +\title{A Brief Guide to \latex{} Tools for Web Publishing} +\author{Peter R. Wilson\thanks{With helpful critiques by +Eitan Gurari (\texttt{gurari@cis.ohio-state.edu}) and +David Wilson (\texttt{davidw@utopiatype.com.au}).} \\ + \texttt{peter.r.wilson@boeing.com}} +\date{11 March 2000} + +\begin{document} +\pagestyle{headings} +\pagenumbering{roman} +\maketitle +\begin{abstract} +This document provides a brief guide to converting \latex{} documents +to forms more suitable for dissemination via the Web. +\end{abstract} +\tableofcontents +\listoffigures +\clearpage +\pagenumbering{arabic} + +\section{Introduction} + + Publishing on the Web has rapidly achieved significant importance, +for example, the International Organization for Standardization (ISO) +is moving towards electronic forms of International Standard documents +that are suitable for publishing on the Web, and in particular, documents +as PDF or HTML files rather than their traditional request for camera-ready +paper copy. + + Documents written using \latex~\cite{LAMPORT94} tagging can be +easily converted to +PostScript, PDF and HTML, all from the single electronic source. This +guide briefly notes some of the ways that this can be accomplished. + Most of the programs and systems mentioned here are described in more +detail in~\cite{GOOSSENS99}. + + I have made no attempt to design this document for Web publication. The +typographical rules for printing on paper are well founded, having been +developed over hundreds of years. Display on computer screens is a +very different matter and requires a different set of rules, most of which, +as yet, are either in a state of flux or unavailable. For LaTeXers who +are interested in this topic I suggest a look at D.~P.~Story's work on +AcroTeX (\url{http://www.math.uakron.edu/~dpstory/acrotex.html}). Further, +for the example conversions I have used only the minimal tool options +necessary. Many of the tools have extensive capabilities which are well +documented in their accompanying user manuals; these should be consulted for +further information. + + +\subsection{URLs} + + I have tried to provide URLs for the programs and systems mentioned +here. Most \latex-related software is available from the Comprehensive +TeX Archive Network (CTAN). There are three sites, +\url{ftp://ctan.tug.org/tex-archive} in the USA, +\url{ftp://ftp.tex.ac.uk/tex-archive} in the UK, and +\url{ftp://ftp.dante.de/tex-archive} in Germany, as well as several mirror +sites. Usefully, the CTAN sites (but not necessarily a mirror site) supports +on-the-fly zipping of files and entire directories, which makes downloading +a group of files less tedious than having to get them one-by-one. Below, +I have used \url{ftp://ctan.tug.org/tex-archive} to stand for any of +the three CTAN sites. + + +\subsection{Disclaimer} + + Nothing that is said in this document is meant to imply any endorsement +or recommendation, either +positive or negative, concerning any systems or programs mentioned herein. + + Many of the systems or programs are `free' in the sense that they are +either public domain or their licences are roughly equivalent to the GNU +Public License. +Others are either commercial or have more restricitive +licenses or may require payment. Where known, programs and systems that are +not `free' are noted. + +\section{PDF} + + The traditional output from a \latex{} (e.g., \file{*.tex}) file is +a `device independent' \file{*.dvi} file. The \file{*.dvi} file is then processed further to convert +it to a format suitable for printing on a particular printing device. +In the vast majority of cases the final printable format +has been PostScript, obtained by running the \file{*.dvi} file through a +program like \program{dvips}, to generate a \file{*.ps} file. + + PostScript was developed by Adobe Systems. The Portable Document +Format (PDF) has since also been developed by Adobe, and seems to be +overtaking PostScript as the format of choice for printing, and especially +for display via the Web. + + DVI and PDF are somewhat similar in that they both describe where +(electronic) ink is to be put on (electronic) paper. PostScript also +does this but at the same time it is a complete programming language. +This means that it is inherently more difficult, time consuming, and computer +intensive, to process PostScript than either DVI or PDF. This is probably +the reason behind the popularity of PDF on the Web. + + There are now several methods of producing a PDF (e.g., \file{*.pdf}) +file from \file{*.tex}. These include: +\begin{itemize} +\item Converting from PostScript to PDF; + from \file{*.ps} to \file{*.pdf}. +\item Generate PDF from the device independent file; + from \file{*.dvi} to \file{*.pdf} +\item Generate PDF directly from the \latex{} source; + from \file{*.tex} to \file{*.pdf}. +\end{itemize} + + +\subsection{From PostScript to PDF} + + There are basically two routes to getting from PostScript to PDF. The +first of these is to use Acrobat software from Adobe Systems, which +essentially means the commercial \program{Distiller} program. +\program{Distiller} can read in a PostScript file and output a PDF file +where the visual results of printing the two files are identical. This, +or any other, PDF file can be viewed and/or printed via the charge-free +Acrobat \program{Reader} program. Note that when using \program{Reader} +the `fit to paper' option may alter the page layout, for example by changing +the height of the text block. + + + The second route is to use a non-Adobe converter program, +like \program{Ghostscript} which runs on nearly all operating systems and +which is obtainable from +\url{http://www.cs.wisc.edu/~ghost}. The \program{Ghostscript} distribution +comes with a script called \program{ps2pdf} which performs the conversion. +The distribution also provides the popular \program{Ghostview} program, +which is a viewer for both PostScript and PDF files. + + Another +converter program, which does have some licensing conditions that may not +be suitable for all users, is \program{PStill}; it is available from +\url{http://www.this.net/~frank/pstill.html}. + +\subsection{From DVI to PDF} + + Mark Wicks' \program{dvipdfm} program +(\url{http://odo.kettering.edu/dvipdfm}) converts a \file{*.dvi} file to a +\file{*.pdf} file. The program is used in the same manner as \program{dvips} +and provides similar capabilities. + + PostScript illustrations are handled in one of two ways. Simple PostScript +generated by the \mpost{} program~\cite{HOBBY92} is included natively. +Any other PostScript file is first converted to PDF by using an external +program like \program{Ghostscript} and then inserted +into the output file. Illustrations in PDF, PNG and JPEG formats require +no external aids. + + \program{dvipdfm} is written in C but there are some binaries for Linux +systems. + + +\subsection{From LaTeX to PDF} + + The \program{pdfLaTeX} program being developed by \Han{} is a modified +version of \tex{} that generates \file{*.pdf} instead of \file{*.dvi} output +files. \program{pdfLaTeX} is distributed with many of the free \latex{} +distributions, and is also obtainable from +\url{ftp://ftp.cstug.cz/pub/tex/local/cstug/thanh}, although it may be +better to try \url{ftp://ctan.tug.org/tex-archive/systems/pdftex}. + + Running \program{pdfLaTeX} is very similar to running \latex, but some +minor changes are required to the \file{*.tex} file. For example: \label{code:example} +\begin{verbatim} +% example.tex example latex file +\documentclass[...]{...} +\newif\ifpdf +\ifx\pdfoutput\undefined + \pdffalse +\else + \pdftrue +\fi + +\ifpdf + \pdfoutput=1 +% \usepackage[pdftex]{graphicx} % uncomment if using graphicx +% \usepackage[pdftex]{hyperref} % uncomment if using hyperref +\else +% \usepackage{graphicx} % uncomment if using graphicx +% \usepackage{hyperref} % uncomment if using hyperref +\fi +.... +\end{verbatim} + +Running \\ +\texttt{latex example} \\ +will produce \file{example.dvi}, while running \\ +\texttt{pdflatex example} \\ +will produce \file{example.pdf}. It is thus very easy to generate both +\file{*.dvi} and \file{*.pdf} from the same \latex{} source file. + + \program{pdflatex} will handle graphics files in the following formats: +PDF, PNG, JPEG and TIFF, but notice that (Encapsulated) PostScript is +missing from this list. However, it can handle directly the simple +Encapsulated PostScript output by \mpost~\cite{HOBBY92}. +It does, though, expect \mpost{} files to have a \file{.mps} extension. +To include PostScript from other sources it is necessary to convert the +PostScript to PDF. + + \program{pdftex}, and hence \program{pdflatex}, has some extra +primitive commands +that are not available in \tex{} itself specifically for accessing aspects +of the PDF format, for example to create hypertext links, bookmarks or +article threads. Consult the manual for details. + + Independently of \program{pdflatex} the \package{hyperref} package +(\url{ftp://ctan.tug.org/tex-archive/macros/latex/contrib/supported/hyperref}) +extends the functionality of the \latex{} cross-referencing commands to +include hypertext links, and also ad hoc hypertext links to, for example, +external documents and URLs. + +\subsection{Fonts} + + The normal fonts used with \latex{} are the Computer Modern family +developed by Knuth using \mfont~\cite{KNUTH86b}. +All \mfont{} fonts are in the form of +bitmaps, which is unfortunate when it comes to PDF. Typically, PDF will +only use one size of each font for a document, and will scale this if +different font sizes are required. This normally works well as fonts +used with PDF are typically `Type~1' fonts (e.g., PostScript fonts) +which are designed to be scaleable. Bitmap fonts look terrible when scaled +or printed at a resolution that they were not designed for. + + In other words, expect bad results if you generate a PDF file with +the original Computer Modern fonts. + + Perhaps the easiest method of dealing with this is to use the most common +PostScript fonts, namely Times, Courier and Helvetica. All that is +necessary is to add \verb|\usepackage{times}| to the document's preamble. + + Alternatively, if you need to use the CM fonts, perhaps because a lot +of mathematics is involved, many \latex{} distributions include +Type~1 versions of the CM fonts. If you don't have them they can be found at +\url{ftp://ctan.tug.org/tex-archive/fonts/cm/ps-type1/bluesky} and +at \url{ftp://ctan.tug.org/tex-archive/fonts/amsfonts/ps-type1} for the AMS fonts. + + Goossens \textit{et al.} provide useful and general information +on installing and using different fonts with \latex~\cite{GOOSSENS94}, +while for the fontophile, Alan Hoenig~\cite{HOENIG98} delves much +more deeply into the installation of PostScript fonts. + + \tex{} doesn't care about the particular shape of any glyph, nor how it +is constructed or represented, it only cares about the space occupied by +each character (i.e., the \file{*.tfm} files). +It is the DVI processor that needs to know in detail +about the fonts in a document. So, the DVI processor has to be told to +use Type~1 CM PostScript fonts. +The following is for the \program{dvips} program. +For convenience, let \path{$TEXMF} stand for the root of the +\path{texmf} tree (e.g., \path{/usr/teTeX/texmf}). + + \program{dvips} looks in the \path{$TEXMF/dvips/base/psfonts.map} +to see if it can use any PostScript fonts. This file starts off something +like: +\begin{verbatim} +bchb8r CHarterBT-Bold "TeXBase1Encoding ReEncodeFont" <8r.enc <bchb8a.pfb +... +\end{verbatim} +To get \program{dvips} to use Type~1 versions of the CM fonts, additional +lines must be added to \file{psfonts.map} giving similar information about +the fonts. The specification for CM fonts is simpler and consists of +lines like: +\begin{verbatim} +cmb10 CMB10 <cmb10.pfb +cmbsy10 CMBSY10 <cmbsy10.pfb +... +\end{verbatim} +In the version of \program{teTeX} that I use, this information is in +files \file{bsr.map}, \file{bsr-interpolated.map}, \file{cmcyr.map}, +\file{hoekwater.map}, and \file{pl.map}, all in directory +\path{$TEXMF/dvips/config}. + + These files can either be copied by hand to the \file{psfonts.map} +file in \path{$TEXMF/dvips/base} or in a modern \program{teTeX} +distribution (which should also have all the CM Type~1 font data) it +is easiest to do the following: +\begin{itemize} +\item In directory \path{$TEXMF/dvips/config} copy the script file + \path{updmap} to, say, \path{updmap.orig}. +\item Edit \path{updmap} to comment the line \texttt{type1\_default=false} + and uncomment the line \texttt{type1\_default=true}. +\item Run the script via \texttt{./updmap}. +\end{itemize} + + Another more general method is to edit the file \file{config.ps} in +directory \path{$TEXMF/dvips/config} and at the appropriate place (which +should be marked, but in any case after the line \texttt{p psfonts.map}) +add lines like: +\begin{verbatim} +p +bsr.map +p +bsr-interpolated.map +... +\end{verbatim} + + Another option when using \program{dvips} which avoids all of the above, +is to call it with options, like: \\ +\verb|dvips -Pamz -Pcmz -Ppdf -j0 [other options] filename| \\ +and then use your prefered \file{*.ps} to \file{*.pdf} conversion process. + +\subsection{MetaPost} + + John Hobby's \mpost{}~\cite{HOBBY92} is a language based drawing program +based on Knuth's \mfont~\cite{KNUTH86b}. \mfont{} was principally designed +for creating fonts, and generates bitmapped output, while \mpost{} is +principally for drawing general line illustrations and its output is a +particularly simple form of Encapsulated PostScript. + + +\begin{figure} +\centering +\ifpdf + \includegraphics{expeg6.mps} +\else + \includegraphics{expeg.6} +\fi +\caption{Metapost illustration of an \textsc{express-g} diagram} + \label{fig:mp} +\end{figure} + + This is not the place to describe \mpost, but it can generate several +output files, one for each drawing, from a single input file called, say, +\file{fred.mp}. The output files have a numeric extension correspond to the +number of the drawing. So, for example, it may generate files \file{fred.1}, +\file{fred.2} and \file{fred.3}. For a document that is to be processed via +\program{LaTeX} these files can be included as is. However, for processing +through \program{pdfLaTeX}, the files must have a \file{.mps} extension; for +example \file{fred1.mps}, \file{fred2.mps} and \file{fred3.mps}. + + Figure~\ref{fig:mp} is a \mpost{} illustration that is included in +this document by the code: +\begin{verbatim} +\begin{figure} +\centering +\ifpdf + \includegraphics{expeg6.mps} +\else + \includegraphics{expeg.6} +\fi +\caption{Metapost illustration of an \textsc{express-g} diagram} + \label{fig:mp} +\end{figure} +\end{verbatim} +where \file{expeg6.mps} is a copy of \file{expeg.6}, +to cater for processing by either \program{LaTeX} or \program{pdfLaTeX}. +Actually, the following will also work: +\begin{verbatim} +\begin{figure} +\centering +\includegraphics{expeg6.mps} +\caption{Metapost illustration of an \textsc{express-g} diagram} + \label{fig:mp} +\end{figure} +\end{verbatim} + +The figure demonstrates part of the capabilities of the +\program{expressg} \mpost{} +package (\url{ftp://ctan.tug.org/tex-archive/graphics/metapost/contrib/macros/expressg}) for +drawing diagrams consisting of boxes, lines and annotations, such as flowcharts +or ER diagrams. + + +\section{HTML} + + There are a number of systems that convert a \latex{} tagged document into +an HTML tagged document. These can be divided into two classes: +\begin{enumerate} +\item Systems that parse the \file{*.tex} file themselves. +\item Systems that use \tex{} as the file parser. +\end{enumerate} +There are several that do their own parsing, but only one that I know of that +uses \tex{} as the parser. + +\tex{} is a macro language and the meaning of existing +commands can be changed on the fly, and also new commands can be defined on +the fly~\cite{KNUTH84a}. +As perhaps the most extreme example of this is David Carlisle's +\file{xii.tex} \tex{} code, which is obtainable as +\url{ftp://ctan.tug.org/tex-archive/macros/plain/contrib/xii.tex}: \label{code:xii} +\begin{verbatim} +\let~\catcode~`76~`A13~`F1~`j00~`P2jdefA71F~`7113jdefPALLF +PA''FwPA;;FPAZZFLaLPA//71F71iPAHHFLPAzzFenPASSFthP;A$$FevP +A@@FfPARR717273F737271P;ADDFRgniPAWW71FPATTFvePA**FstRsamP +AGGFRruoPAqq71.72.F717271PAYY7172F727171PA??Fi*LmPA&&71jfi +Fjfi71PAVVFjbigskipRPWGAUU71727374 75,76Fjpar71727375Djifx +:76jelse&U76jfiPLAKK7172F71l7271PAXX71FVLnOSeL71SLRyadR@oL +RrhC?yLRurtKFeLPFovPgaTLtReRomL;PABB71 72,73:Fjif.73.jelse +B73:jfiXF71PU71 72,73:PWs;AMM71F71diPAJJFRdriPAQQFRsreLPAI +I71Fo71dPA!!FRgiePBt'el@ lTLqdrYmu.Q.,Ke;vz vzLqpip.Q.,tz; +;Lql.IrsZ.eap,qn.i. i.eLlMaesLdRcna,;!;h htLqm.MRasZ.ilk,% +s$;z zLqs'.ansZ.Ymi,/sx ;LYegseZRyal,@i;@ TLRlogdLrDsW,@;G +LcYlaDLbJsW,SWXJW ree @rzchLhzsW,;WERcesInW qt.'oL.Rtrul;e +doTsW,Wk;Rri@stW aHAHHFndZPpqar.tridgeLinZpe.LtYer.W,:jbye +\end{verbatim} +If you run this through \tex{} (not \latex) I'm sure you will be surprised at +the result. + + There is inevitably a problem when converting from \latex{} to HTML for +a document that includes figures/illustrations or anything more than the +most simple mathematical +typesetting as, basically, HTML provides no support. Typically, mathematics +and illustrations, are converted to a picture format and then +inserted into the HTML document as graphics, usually with a very poor +appearance. + + However, for mathematics the situation is starting to change +because of the advent of MathML (\url{http://www.w3.org/TR/MathML2}). +In particular the Milestone~13 release +of Mozilla (\url{http://www.mozilla.org/binaries.html}) +is a MathML-enabled browser. Some examples, generated by \program{TeX4ht}, +are available at \url{http://www.maths.ox.ac.uk/~gartside/mozSuccess}. + + All the systems generate HTML tagged documents, with the particular tagging +`style' set by the system. It is advantageous to use a converter which either by +default generates your desired style, or which can be modified in some manner +to do so. + +\subsection{Self-parsing systems} + + The self-parsing systems incorporate their own parsers for the \tex{} +language. In essence, this means that they `know' the meaning of common +\tex{} commands, but probably not all possible commands. +It is advantageous to use a system that can be +extended to deal with commands that were not anticipated by the author. + + The only system I am familiar with in this class is Peter Wilson's +\program{ltx2x} program (\url{ftp://ctan.tug.org/tex-archive/support/ltx2x}). +This program works by replacing known \latex{} +commands, and their arguments, by user-specified text strings~\cite{PRW96h}. +It is unable +to handle anything more than very simple mathematics and ignores any pictures. +The user-specified command texts are kept in a simple command-table file. +Within limits, new \latex{} commands and environments may be specified +within a command-table file and the command texts modified. The \program{ltx2x} +program has been used to `detex' (i.e., remove all \latex{} commands) files, +convert to HTML, and convert to SGML. It cannot convert to XML due to a +yet to be resolved technical problem in dealing with end of paragraph tags. +The program is written in C and so requires a C compiler for installation. +The system can be extended via some C programming, in which case +the \program{flex} and \program{bison} programs are also required. +There is no chance that \program{ltx2x} would ever make any sense whatsoever +of \file{xii.tex} on page~\pageref{code:xii}. + + Perhaps the most venerable system is the \program{LaTeX2HTML} +system (\url{http://www-texdev.mpce.mq.edu.au/l2h/docs/manual} +or \url{ftp://ctan.tug.org/tex-archive/support/latex2html}), originally +by Nikos Drakos and now maintained by Ross Moore and others. This system +is written using \program{Perl} (\url{ftp://ftp.uu.net/languages/perl}). +It also requires a database management system such as the Unix DBM or NDBM, +or the GNU GDBM system. Further, it requires \program{Ghostscript} and +the \program{netpbm} library of graphics utilities +(\url{ftp://ftp.x.org/contrib/utilities}). To extend or change the default +conversion style requires, I think, some Perl programming. A fuller description +and examples are given in~\cite{GOOSSENS99}. + + Another converter is the \program{TtH} program by Ian Hutchinson +(\url{http://hutchinson.belmont.ma.us/tth}) which is cost-free for +non-commercial use; commercial use in this case is roughly by anyone who gets +paid while using it +(but see \url{http://hutchinson.belmont.ma.us/tth/tth-commercial/email.html} +for the actual wording). There is also another version, \program{TeX2HTML} +(\url{http://www.tex2html.com}) which is the `commercial GOLD version of +the freeware \program{Tth} by Ian Hutchinson'. These programs run on the usual +range of operating systems. An example of the output from \program{TtH} is +given in~\cite{GOOSSENS99}. + +\subsection{TeX-based parsing system} + + Eitan Gurari's \program{TeX4ht} system appears to be unique in that +it uses \tex{} as the parser for the \latex{} document and instead effectively +takes the \file{*.dvi} file as its starting point for conversion to HTML. +That is, it does not have to understand \tex{} code and can, in fact, convert +David Carlise's \file{xii.tex} (page~\pageref{code:xii}) to HTML. +The system is available from +\url{http://www.cis.ohio-state.edu/~gurari/TeX4ht/mn.html}. It consists of +two C programs, one package file, and a set of \file{*.4ht} configuration +files, one for each of the typical LaTeX{} classes and packages. It also +requires ImageMagick +(\url{http://www.wizards.dupont.com/cristy/www/archives.html}) for handling +illustrations and non-simple mathematics. +Simply speaking, the system +is extended by writing new \file{*.4ht} file(s) and its output modified +by writing simple \file{*.cfg} file(s) that override the \file{*.4ht} file(s). +At the moment, the best and most detailed description is given +in~\cite{GOOSSENS99}. + + By default, \program{TeX4ht} can generate a non-tagged file or a file +tagged with either HTML3.2 or HTML4.0. By writing appropriate \file{*.cfg} +files it can be made to generate XML tagged files. The system comes with a +script called \program{htlatex} which controls the conversion process from +\latex; there is also the \program{httex} script for converting a \tex{} document. +For instance, to convert the earlier example LaTeX{} file, +\file{example.tex} (page~\pageref{code:example}), + to an HTML4.0 tagged document, it is enough to run: \\ +\texttt{htlatex example} \\ +which will then output \file{example.html}. Similarly, to convert +\file{xii.tex} just run: \\ +\texttt{httex xii}. + +\section{Examples} + + Hopefully, you should find several versions of this document, all of +which have been generated from a single source file. These are: +\begin{itemize} +\item \file{webguide.tex} --- the \latex{} source. +\item \file{webguide.ps} --- A PostScript version from running + \program{latex} and \program{dvips} on \file{webguide.tex}. +\item \file{webguide.pdf} --- A PDF version from runnning + \program{pdflatex} on \file{webguide.tex}. +\item \file{webguide.html} --- A HTML4.0 version from running + \program{htlatex} on \file{webguide.tex}. +\end{itemize} + The HTML version uses the GIF file +\file{webguide0x.gif} for the illustration; the file is automatically +generated by \program{tex4ht} using the ImageMagick \program{convert} +program. The quality of the picture in the viewed document depends on +the particular viewer; different versions of Netscape, for example, +may display and print the diagram with very different rendering qualities. +I asked TeX4ht to generate this particular figure at 180dpi instead of +the default 110dpi to improve the quality. + + +\bibliographystyle{alpha} +%%\bibliography{refs,prw} + +\begin{thebibliography}{GMS94} + +\bibitem[GMS94]{GOOSSENS94} +Michel Goossens, Frank Mittelbach, and Alexander Samarin. +\newblock {\em The LaTeX Companion}. +\newblock Addison-Wesley Publishing Company, 1994. + +\bibitem[GR99]{GOOSSENS99} +Michel Goossens and Sebastion Rahtz. +\newblock {\em The LaTeX Web Companion -- Integrating TeX, HTML, and XML}. +\newblock Addison-Wesley Publishing Company, 1999. +\newblock (with Eitan Gurari, Ross Moore, and Robert Sutor). + +\bibitem[Hob92]{HOBBY92} +John Hobby. +\newblock {\em `{A User's Manual for MetaPost}'}. +\newblock Technical Report 162, AT\&T Bell Laboratories, Murray Hill, NJ, 1992. + +\bibitem[Hoe98]{HOENIG98} +Alan Hoenig. +\newblock {\em TeX Unbound -- LaTeX and TeX Strategies for Fonts, Graphics, \& + More}. +\newblock Oxford University Press, 1998. + +\bibitem[Knu84]{KNUTH84a} +Donald~E. Knuth. +\newblock {\em The TeXbook}. +\newblock Addison-Wesley Publishing Company, 1984. + +\bibitem[Knu86]{KNUTH86b} +Donald~E. Knuth. +\newblock {\em The METAFONTbook}. +\newblock Addison-Wesley Publishing Company, 1986. + +\bibitem[Lam94]{LAMPORT94} +Leslie Lamport. +\newblock {\em LaTeX: A Document Preparation System}. +\newblock Addison-Wesley Publishing Company, second edition, 1994. + +\bibitem[Wil96]{PRW96h} +Peter~R. Wilson. +\newblock {\em {ltx2x: A LaTeX to X Auto-tagger}}. +\newblock NIST Report NISTIR, June 1996. + +\end{thebibliography} + + +\end{document} + diff --git a/Master/texmf-dist/doc/latex/webguide/webguide0x.gif b/Master/texmf-dist/doc/latex/webguide/webguide0x.gif Binary files differnew file mode 100644 index 00000000000..e3c19233b35 --- /dev/null +++ b/Master/texmf-dist/doc/latex/webguide/webguide0x.gif |