1.2. Generating printable/viewable documents
Prev Chapter 1. LaTeX Next

1.2. Generating printable/viewable documents

Table of Contents

1.2.1. Generating postscript output for a simple document
1.2.2. Generating PDF output for a simple document (dvips/ps2pdf)
1.2.3. Generating PDF output for a simple document (pdflatex)
1.2.4. Generating output for a document with a style
1.2.5. Generating output for a document with a bibliography
1.2.6. Configuring one or more style repositories
Generating a printable/viewable document is a several step process. The number of steps will vary depending on the type of document and the desired output format.

1.2.1. Generating postscript output for a simple document

Start with a simple document: 

$ ls
document.tex

Run latex: 

$ latex document    1
$ ls
document.aux  document.dvi  document.log  document.tex

1

Note: *tex programs do not need the .tex extension.

Run dvips: 

-o          output file
-t          paper type

$ dvips -o document.ps -t letter document.dvi
$ ls
document.aux  document.dvi  document.log  document.ps  document.tex

1.2.2. Generating PDF output for a simple document (dvips/ps2pdf)

Note: Allows use of pstricks graphics package. Included images should be encapsulated postscript (.eps).

Start with a simple document: 

$ ls
document.tex

Run latex: 

$ latex document
$ ls
document.aux  document.dvi  document.log  document.tex

Run dvips: 

-P          specify printer
-G0         shift non-printing characters to higher-numbered positions
-o          output file
-t          paper type

$ dvips -Ppdf -G0 -o document.ps -t letter document
$ ls
document.aux  document.dvi  document.log  document.ps  document.tex

Run ps2pdf: 

$ ps2pdf document.ps
$ ls
document.aux  document.dvi  document.log  document.pdf  document.ps  document.tex

1.2.3. Generating PDF output for a simple document (pdflatex)

Note: Does not work with pstricks. Included images should be JPEG or PDF.

Start with a simple document: 

$ ls
document.tex

Run pdflatex: 

$ pdflatex document
$ ls
document.aux  document.log  document.pdf  document.tex

1.2.4. Generating output for a document with a style

Start with a document and a style file: 

$ ls -R
.:
document.tex  latex/

./latex:
latex8.sty

Set environment variables and run (for latex): 

$ setenv TEXINPUTS_latex "./latex::"
$ latex document
Set environment variables and run (for pdflatex): 
$ setenv TEXINPUTS "./latex::"
$ pdflatex document

Run dvips and/or ps2pdf as necessary.

1.2.5. Generating output for a document with a bibliography

Start with a document, bibliography, and styles (if applicable): 

$ ls -R
.:
document.bib  document.tex  latex/

./latex:
latex8.bst  latex8.sty

Set environment variables and run (substitute pdflatex for latex and TEXINPUTS for TEXINPUTS_latex where appropriate): 

$ setenv TEXINPUTS_latex "./latex::"
$ setenv BSTINPUTS "./latex::"
$ latex document
$ bibtex document
$ ls
document.aux  document.bib  document.dvi  document.tex
document.bbl  document.blg  document.log  latex/

Run latex (or pdflatex) N more times, where N >= 2. This is to resolve references and update lists. Check document.log for errors/warnings regarding unresolved references. In particular, look for this error: 

LaTeX Warning: There were undefined references.

1.2.6. Configuring one or more style repositories

Instead of manually setting the environment variables every time, set the environment variables in your shell resource file (e.g. $HOME/.cshrc or $HOME/.tcshrc): 

# .tcshrc
# ...
# setting TEXMF here may not be necessary.
setenv TEXMF /usr/share/texmf//:/usr/share/texmf-var//:
setenv TEXINPUTS_latex .:./latex:$HOME/.latex//:
setenv TEXINPUTS .:./latex:$HOME;/.latex//:
setenv BSTINPUTS .:./latex:$HOME/.latex//:
For example, here latex will search for style files in the current working directory, then the ./latex directory, and finally the $HOME/.latex directory.

Prev Up Next
1.1. Introduction Home 1.3. Creating a LaTeX document