tkdvi - Tk-based DVI previewer

tkdvi ?option ... fileName option ... fileName?

-overview

Indicates that the following DVI file(s) should be displayed as reduced 4 by 4 overviews. This gives a view of 16 pages at once, so page breaks and float positions can be conveniently checked.

-papersize size

Specifies the paper size to be assumed for the following DVI file(s). Valid sizes include a4 (and other DIN sizes), letter, and legal. All these sizes can have an r appended to indicate landscape (`rotated') format. The default is a4.

-present

Switches to `presentation' mode, displaying A6 landscape documents at shrink factor 3, with the window covering all of the screen with all extraneous user interface elements (scrollbars, menu bar, tool bar, page selector) turned off. This is probably not useful without appropriate LaTeX style support and on screens with a resolution different from 1024x768.

-single

Indicates that the following DVI file(s) should be displayed as single pages.

-shrink factor

Specifies the linear shrink factor to be applied to the following DVI file(s) on the screen. This can be any positive integer. The default is 8, which gives reasonable results at 600 dpi.

-spread

Indicates that the following DVI file(s) should be displayed as two-page `spreads'.

TkDVI is a simple previewer for TeX DVI files built around the dvi(n) Tcl/Tk extension. It displays pages from DVI files in windows on the screen. TkDVI takes a number of command line arguments which are either options or the names of DVI files to be displayed. Any options stay in force for all the DVI files that follow them on the command line, until countermanded by other options.

On startup, TkDVI reads X11 resources from the file tkdvi.ad in an installation-specific directory (usually /usr/local/share/tkdvi) or the directory given in the environment variable TKDVI_TCLLIB (if this exists). It also reads resources from the file $HOME/.tkdvi-resources if it exists. Furthermore, it arranges to autoload procedures from the directory $HOME/.tk/tkdvi. In particular, TkDVI tries to invoke a procedure called userInit before it starts looking at the command line (but after the X11 resources have been loaded). You can supply an implementation of userInit by putting it in a file in $HOME/.tk/tkdvi and setting up an appropriate tclIndex file in that directory.

TkDVI starts a `DVI browser' for each DVI file named on the command line (you can open several browsers for a single file by mentioning it several times; it will be actually loaded only once). This is a window containing a representation of the DVI file's contents together with the appropriate scroll bars, menu bar and a page selector. See tkdvi::browser(3) for details about the browser's features.

The `q' key is a shortcut for quitting TkDVI.

The page selector is displayed to the left of the DVI page. It shows a list of the page numbers in the DVI file and makes it possible to jump to any page directly by clicking on its number. The current page (or, in the spread and overview modes, the page in the upper left corner of the window) has its number framed in the page selector.

It is also possible to select individual pages for printing, by clicking on the page numbers in question using button 2 (usually the middle button). A little red box to the left of the page number will light up, and only the selected pages will be printed when `Print Marked Pages' is selected from the `File' menu. (This requires a version of dvips(1) that understands the -pp option, as any reasonably recent version will.)

Anselm Lingnau <lingnau@tm.informatik.uni-frankfurt.de>