Pdftex FAQ Collection (In Pdf)
Total Page:16
File Type:pdf, Size:1020Kb
General The pdfTEX FAQ Information ∗ Installation Version 0.12 Fonts in pdfTEX Graphics Maintained by: C. V. Radhakrishnan Miscellaneous ConTEXt July 4, 2000 Home Page Abstract Title Page This document is a preliminary version of pdfTEX’s frequently asked questions (FAQ) and answers. If you can contribute to this document, please mail C. V. Rad- JJ II hakrishnan or pdfTEX’s mailing list. Including the key FAQ in the subject line of your contribution will help the FAQ maintainer stay organized. This document is J I in LATEX syntax and is generated in an Intel 500MHz PIII system running Linux ker- nel version 2.2.12-20 by pdfTEX ver. 14f. The packages used are hyperref.sty and pdfscreen.sty. Page 1 of 26 Go Back c This document is freely distributable. Full Screen Close ∗This document is for public distribution Quit 1. General 1.1. TEX and PDF 1.1.1. What is pdfT X? General E Information Contributed by: Pavel Jan´ık jr Installation pdfTEX is a variant of well known typesetting program of prof. Donald E. Knuth – TEX. Fonts in pdfTEX Output of Knuth’s TEX is a file in dvi format. The difference between TEX and pdfTeX Graphics is that pdfTEX directly generates pdf. You can also create pdf with Adobe’s Distiller Miscellaneous program, using a dvi to PostScript program to create PS from TEX’s dvi file. ConTEXt 1.1.2. What is TEX? Home Page Contributed by: Pavel Jan´ık jr Title Page From ‘TEX – The Program’ by Donald E. Knuth: “This is TEX, a document compiler intended to produce typesetting of high quality”. TEX is a batch oriented typesetting system. When we talk about T X we mean the macro programming language as well JJ II E as the program that interprets and executed this language. J I 1.1.3. What is PDF? Page 2 of 26 Contributed by: Pavel Jan´ık jr This question is answered in the Adobe Systems’ document Portable Document For- Go Back mat Reference Manual available at http://www.adobe.com/supportservice/devrelations/ PDFS/TN/PDFSPEC.PDF on page 27. It can not be reproduced here for strange copy- Full Screen right reasons. Think of pdf as PostScript without programming constructs. A pdf file consists Close of graphical objects tight together in such a way that fast viewing is possible and incremental updates become possible. Quit 1.1.4. How can I view a PDF file? Contributed by: Steve Phipps Contributed by: Michael Sanders General There are several .pdf readers available as free ware over the Internet. Information Adobe’s Acrobat Reader is available for many operating systems, including Win95, Installation nt, and 3.1, Macintosh, Linux, Sun, and OS/2. Download the self-installing executable Fonts in pdfTEX from Adobe’s web site: http://www.adobe.com/prodindex/acrobat/. Graphics Ghostscipt is a .ps interpreter and Ghostview is its graphical front-end. Ghostscript Miscellaneous is also available for many operating systems, including unix and vms, ms-dos, MS- Windows, OS/2 and Macintosh. See the Ghostscript home page at http://www.cs. ConTEXt wisc.edu/∼ghost/ for details, documentation, and downloads. Another previewer is xpdf, a pdf viewer for X maintained by Derek B. Noonburg Home Page with a home page at http://www.aimnet.com/∼derekn/xpdf. Xpdf runs under the X Window System on unix, vms, and os/2 and is designed to be small and efficient. It Title Page does not use the Motif or Xt libraries and only uses standard X fonts. [FIXME: some words about Xpdf and other pdf viewers] JJ II 1.2. Authors J I 1.2.1. Who is the author of pdfTEX? Page 3 of 26 Contributed by: Pavel Jan´ık jr The primary author of pdfTEX is Han The Thanh. [FIXME: in pdftex.ch there is also Go Back Petr Sojka and the current head (rector) of Masaryk’s University and Jiˇr´ı Zlatuˇska.] Full Screen Close Quit 2. Information 2.1. Locations 2.1.1. Where can I find pdfT X? General E Information Contributed by: Pavel Jan´ık jr Installation ftp://ftp.cstug.cz/pub/tex/local/cstug/{janik,thanh} daily mirror on ftp://ftp.inet.cz/ Fonts in pdfTEX pub/Mirrors/pdfTeX Graphics Miscellaneous 2.1.2. What is the latest version? ConTEXt Contributed by: Pavel Jan´ık jr Home Page The latest version of pdfTEX is pdfTEX-0.14f. This is the latest version of pdfTEX approved by Han The Thanh (for now). Title Page 2.1.3. Where can I find some docs about pdfTEX? JJ II Contributed by: Jody Klymak J I A web site for the pdfTEX project is maintained by Sebastian Rahtz, and can be found at: http://www.tug.org/applications/pdftex/ Page 4 of 26 In it you will find: Go Back • The pdfTEX manual in pdf format: http://www.tug.org/applications/pdftex/pdftexman.pdf and HTML format: Full Screen http://www.tug.org/applications/pdftex/pdftexman.html Close • The pdfTEX mailing list archives: http://tug.org/ListsArchives/pdftex/threads.html Quit • This FAQ in pdf format: http://www.tug.org/applications/pdftex/pdfTeX-FAQ.pdf and dvi format: http://www.tug.org/applications/pdftex/pdfTeX-FAQ.dvi General [FIXME: The best documentation is in the source files...] Information Installation 2.1.4. Is there a pdfTEX mailing list? Fonts in pdfTEX Graphics Contributed by: Jody Klymak Miscellaneous Yes, to subscribe send mail to [email protected], and put the line: ConTEXt subscribe pdftex username@hostname Home Page in the body of the message, where username@hostname is your complete email address. Title Page 2.1.5. Where can I find an archive of the pdfTEX mailing list? JJ II Contributed by: Jody Klymak An ftp site of the mailing list, arranged chronologically can be found at: ftp://ftp. J I tug.org/mail-archives/pdftex/ Daily mirror is also at ftp://ftp.inet.cz/pub/Mirrors/ pdfTeX-MailArchive/ Page 5 of 26 2.1.6. How do I get new versions of this FAQ? Go Back Contributed by: Jody Klymak Full Screen The TEX version of this document is periodically posted to pdfTEX’s mailing list. It is also uploaded to http://www.tug.org/applications/pdftex/pdfTeX-FAQ.pdf with its LAT X source: http://www.tug.org/applications/pdftex/pdfTeX-FAQ.tex Close E Quit 2.1.7. How do I contribute to this FAQ? Contributed by: Jody Klymak Send email to the FAQ maintainer: C. V. Radhakrishnan with the word FAQ in the General subject line. If possible FAQ entries should be formatted like this example: Information \question{This_is_a_template_faq_question}% Installation {This is a template faq question}{1998/09/24} Fonts in pdfTEX \contributor{Pavel Jan\’{\i}k jr} Graphics {[email protected]}{1998/09/10} Miscellaneous \contributor{Jody Klymak} ConTEXt {[email protected]}{1998/09/24} This is a sample FAQ question. It can reference other Home Page questions, like Question \ref{q:what_is_TeX}, or sections (See Section \ref{sec:General}). This FAQ can be found Title Page at \url{http://www.tug.org/applications/pdftex/pdfTeX-FAQ.pdf}, and is maintained by \href{mailto:[email protected]} {Jody Klymak}. JJ II J I Page 6 of 26 Go Back Full Screen Close Quit 3. Installation 3.1. General Installation 3.1.1. How do I install the latest version of pdfT X? General E Information Contributed by: Pavel Jan´ık jr Installation Get the precompiled binaries and also the zip archive, pdftexlib-0.12.zip in the Fonts in pdfTEX pdfTEX distribution which contains platform–independent files required for running Graphics pdfTEX: Miscellaneous configuration file: pdftex.cfg ConTEXt encoding vectors: *.enc map files: *.map Home Page macros: *.tex Unpacking this archive don’t forget the -d option when using pkunzip will create Title Page a texmf tree containing pdfTEX–specific files. The next step is to place the binaries somewhere in PATH. If you want to use LATEX, you also need to make a copy (or symbolic link) of pdfTEX and name it pdfLATEX. The JJ II files texmf.cnf and pdftex.pool and the directory texmf, created by unpacking the file pdftexlib-0.12.zip, should be moved to the ’appropriate’ place (see below). J I Web2c–based programs, including pdfTEX, use the Web2c run–time configuration file called texmf.cnf. This file can be found via the user–set environment variable Page 7 of 26 TEXMFCNF or via the compile–time default value if the former is not set. It is strongly recommended to use the first option. Next you need to edit texmf.cnf so pdfTEX can find all necessary files. Usually one has to edit TEXMFS and maybe some of the Go Back next variables. When running pdfTEX, some extra search paths are used beyond those normally requested by TEX itself: Full Screen Close Quit VFFONTS the path where pdfTEX looks for virtual fonts T1FONTS the path where pdfTEX looks for Type1 fonts TTFONTS the path where pdfTEX looks for TrueType fonts PKFONTS the path where pdfTEX looks for PK fonts General TEXPSHEADERS the path where pdfTEX looks for the configuration file pdf- tex.cfg, font mapping files (*.map), encoding files (*.enc), Information and pictures Installation Fonts in pdfTEX Graphics 3.1.2. How do I use pdflatex (how to generate pdflatex.fmt)? Miscellaneous Formats for pdfTEX are created in the same way as for TEX. For plain TEX and LATEX it ConTEXt looks like: Home Page pdftex -ini -fmt=pdftex plain \dump pdftex -ini -fmt=pdflatex latex.ltx Title Page In ConTEXt the generation depends on the interface used.