[Top] | [Contents] | [Index] | [ ? ] |
This help file documents Yap 0.97.
Introduction What is Yap? Opening Files How to open a DVI file Printing Printing DVI documents DVI Search Forward and inverse DVI search Graphics Graphics Tools Yap tools Keyboard Keyboard interface Customizing Yap How to customize Yap Logbook The logbook Command Line Command line switches Specials Specials Copyright Yap copyright Troubleshooting Troubleshooting Index Index
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
You use Yap(1) to view a DVI file compiled by TeX. Yap tries hard to follow the WYSIWYG-principle: what you see (on screen) is what you get (when you take the paper out of the tray).
This document will explain
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
You can open a DVI file
File
menu
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
There are two different methods to send a DVI document to the printer:
The Dvips interface also works in conjunction with non-PostScript printers, provided that you have GhostScript installed on your workstation.
Standard Printing Standard Print Command Dvips Interface Printing using Dvips
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The command `File|Print...' opens the standard Print Setup dialog box.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The command `File|Print PostScript...' opens the Print PostScript dialog box.
Dvips Dialog Box Print PostScript Dialog Box
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This dialog box allows you select various Dvips options.
GhostScript device
Check this button if you want to pipe the Dvips output through the
GhostScript interpreter (gswin32c.exe
). GhostScript will be
invoked with the following options:
-sDEVICE=device
-dBATCH
-dNOPAUSE
-dSAFER
PS File
Check this button if you want to send the Dvips output to a PostScript printer or if you want to save the output in a PostScript file. Enter a port name (such as `lpt1' or `\\servername\printer') or a file name.
Print range
Select the pages that you want to print.
Extra Dvips options
You can enter additional Dvips options here.
Reconfirm command line
Check this button if you want to inspect the Dvips command line.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap is capable of searching the DVI file for so called source specials. This feature can help you to optimize the edit-compile-view cycle:
Inserting Source Specials How to enrich your document with source specials Forward Search How to search forward Inverse Search Initiating Inverse Search
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
TeX inserts source specials into the DVI file, if you specify the command-line switch `--src-specials'. You simply can say
tex --src-specials mybook.texand the TeX compiler will insert one source special at the beginning of each paragraph.
You can control the frequency of embedded source specials by specifying where to insert the specials into the DVI file:
tex --src-specials=where mybook.texThe where argument must be a comma-separated value list. Legal values are:
cr
display
hbox
math
par
vbox
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Forward search is initiated by specifying --find-src-special
on the Yap command-line (see section 10. Command line switches).
But initiating forward search from the command-line is rather invonvenient.
It makes more sense to initiate forward search out of the text editor.
The editor must be capable of starting Yap with a correct
--find-src-special
directive.
Two popular text editors which are capable to initiate forward search are
GNU Emacs
and
WinEdt.
Emacs Configuring Emacs for forward search.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
You will need the Emacs package Auc-TeX, which provides an enhanced TeX environment.
The following code should be added to your `.emacs':
(setq TeX-command-list '(("TeX" "tex --src \"\\nonstopmode\\input %t\"" TeX-run-TeX nil t) ("LaTeX" "%l --src \"\\nonstopmode\\input{%t}\"" TeX-run-LaTeX nil t) ("View" "yap -1 -s \"%n %t\" %d" TeX-run-discard nil nil) ("BibTeX" "bibtex %s" TeX-run-BibTeX nil nil) ("Index" "makeindex %s" TeX-run-command nil t)))`TeX' (resp. `LaTeX') creates a DVI file which contains source file information.
`View' starts Yap (if it is not already running) and moves the focus to the corresponding DVI location.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Provided that the DVI document contains source file information (see section 4.1 How to enrich your document with source specials), you can initiate inverse search by double-clicking inside the Yap document window.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap supports the following graphics formats:
*.emf
).
*.wmf
).
*.bmp
).
*.eps
); requires GhostScript.
WMF Windows Metafiles BMP Windows Bitmap (BMP) Files EPS Encapsulated PostScript Other Formats Other Graphics Formats
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap has built-in support for Windows Metafiles (WMF) and Enhanced Metafiles (EMF).
Example
You can use the `graphicx' package to include WMF/EMF files.
For example, the following LaTeX code will include the WMF file
drawing.wmf
:
\usepackage{graphicx} \DeclareGraphicsRule{.wmf}{bmp}{}{}% declare WMF filename extension \begin{document} \includegraphics[width=2in,height=1in]{drawing.wmf} \end{document}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap has built-in support for Windows Bitmap Files.
Example
You can use the `graphicx' package to include BMP files.
For example, the following LaTeX code will include the BMP file
picture.bmp
:
\usepackage{graphicx} \begin{document} \includegraphics[width=2in,height=1in]{picture.bmp} \end{document}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap displays EPS figures with the help of GhostScript, which must be installed on your computer.
Example
You can use the `graphicx' package to include EPS files.
For example, the following LaTeX code will include the EPS file
drawing.eps
:
\usepackage{graphicx} \begin{document} \includegraphics{drawing.eps} \end{document}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap can convert almost any graphics file into an equivalent Windows Bitmap (BMP) file, provided that a suitable filter program is available. The BMP file will then be displayed instead of the original file.
Many filters are included in the netpbm graphics suite, which can be downloaded
from the CTAN directory systems/win32/miktex/util
.
Example
You can use the `graphicx' package to include graphics files.
For example, the following LaTeX code will include the GIF file
picture.gif
:
\usepackage{graphicx} \DeclareGraphicsRule{.gif}{bmp}{}{}% declare GIF filename extension \begin{document} \includegraphics[width=2in,height=1in]{picture.gif} \end{document}
Filters Specifying filters
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
[Graphics]
section of the
MiKTeX configuration file (`miktex.ini'). A filter specification
has the syntax `.xxx.bmp=command', where
Example
The following specification defines a GIF filter:
[Graphics] .gif.bmp=giftopnm %i | ppmtobmp -windows > %oThis filter works as follows:
giftopnm
is used to convert the .gif
file into a portable
bitmap, which is written to a pipe (`|')
ppmtobmp
is used to convert the portable bitmap, which is read from the
pipe, into the final BMP file.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap provides several tools for browsing the DVI document.
src Browser Browsing Source Specials Hand Tool Hand Tool Magnifying Glasses Magnifying Glasses
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The command `Tools|Source Specials...' opens the the Source Specials windows.
Source Specials Window Source Specials Window
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This window lists all source specials found in the current DVI document.
Goto
This button brings into view the portion of the DVI document which contains the selected source special
Edit Source
This button invokes an editor to edit the TeX source corresponding to the selected source special.
Close
This button closes the window.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The hand tool allows you to scroll the page by moving the cursor while the left mouse button is pressed. You select the Hand Tool with the command `Tools|Hand Tool' or by clicking the corresponding button in the toolbar.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The Magnifying Glass allows you to view a small part of the unshrunk page. You select this tool with the command `Tools|Magnifying Glass' or by clicking the corresponding button in the toolbar.
You can choose between three sizes:
You can specify the power of the magnifying glass by entering a numerical prefix argument. The argument is interpreted as a shrink factor for the text inside the magnifying glass. A shrink factor of 1 (the default) results in a maximum magnification.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Numerical Prefix
Zooming
Navigation
Goto Page
dialog box if no prefix argument was entered.
Otherwise goes to the specified page.
Scrolling
Misc
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Options Options Dialog Box PostScript Fonts Telling Yap About PostScript Fonts
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
UI User Interface Property Page Magnifying Glass Magnifying Glass Property Page Display Settings Display Property Page Printer Settings Printer Property Page Inverse Search Settings Inverse Search Property Page GhostScript GhostScript Property Page Security Security Property Page Advanced Options Advanced Property Page
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The User Interface
property page allows you to customize the
Look & Feel of Yap.
Maintain vertical position
Select this checkbox to cause Yap to keep the vertical scroll position at a change of page.
Maintain horizontal position
Select this checkbox to cause Yap to keep the horizontal scroll position at a change of page.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This property page allows you to customize the three magnifying glasses.
Hide mouse cursor
Check this button if the mouse cursor should not be visible while a magnifying glass is open.
Width
Enter the width (in screen pixels) of the rectangular magnifying glass window.
Height
Enter the height (in screen pixels) of the rectangular magnifying glass window.
Shrink Factor
Specify the shrink factor to be used in the magnifying glass window. The shrink factor specifies the power of the magnifying glass. A shrink factor of 1 results in a maximum magnification.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The Display
property page allows you to change various display settings.
Mode
Specify the METAFONT mode for the display.
The Mode
list field contains a list of known METAFONT modes.
This information is needed, when new PK fonts are to be generated.
In principle, it doesn't matter what mode name you select here.
But it's recommended, that you use the same mode name as for the printer,
since this reduces the invocations of the font-generator.
Shrink Factor
Specify the default shrink factor.
Paper Size
Specify the paper type.
Orientation
Specify the orientation of the paper.
Enable colored text
Check this button if you want Yap to interpret color specials (`color.sty'). You may want to uncheck this button if your display adapter supports only 256 different colors.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The Printer
property page allows yoy to change various printer settings.
Mode
Specify the METAFONT mode for the printer.
The Mode
list field contains a list of known METAFONT modes.
This information is needed, when new PK fonts are to be generated.
You must select a mode, that matches your printer resolution.
x-shift, y-shift
Specify the the print offset.For some old printer models it may be necessary to adjust the the print offset (i.e. the position, where printing begins). x-shift/y-shift gives the amount of pixels, an output page has to be shifted right/down.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Program
Specify the program Yap shall execute to do the inverse DVI search.
Command line
Specify the command line Yap shall execute to do the inverse DVI search.
The command line may contain the following placeholders:
%f
%l
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This property page allows you to configure PostScript support.
Disable PostScript interpretation
Check this button, if you want Yap to ignore all PostScript specials.
Draft mode (no anti-aliasing)
Check this button to disable anti-aliasing for PostScript graphics. This speeds up the interpretation of PostScript specials at the expense of output quality.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This property page allows you to permit or forbid the execution of embedded shell commands.
Never execute any shell commands
Check this button to prevent the execution of embedded shell commands.
Ask for permission to execute shell command
Check this button if you want to be warned about any embedded shell commands. You can then choose whether or not to execute the command.
Execute only secure shell commands
Check this button to allow secure commands. Enter a comma-separated list of command names in the edit box.
Execute all shell commands
Check this button to execute embedded shell commands unconditionally.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This property page allows you to set advanced options.
Keep logbook
Check this button to cause Yap to record events into the logbook.
Show source specials
Check this button to cause Yap to show all source specials.
Yap should check to see whether it is the default viewer
Check this button, if Yap should check to see whether it is associated with the
file extension .dvi
.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap consults several font mapping files when a missing PK font has to be generated from a PostScript Type 1 font:
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap records certain events in a logbook. The command `View|Logbook...' opens the logbook.
Close
Press this button to close the logbook.
Copy
Press this button to copy the logbook to the Windows Clipboard.
Erase
Press this button to erase the logbook.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The general Yap command line syntax is
yap [options] [dvifile]The following options are recognized:
--find-src-special srcspecial
-s srcspecial
--goto-hyper-label label
html:
special.
--single-instance
-1
--unregister
Example
You want Yap to do a forward search to the DVI location corresponding
to line 41 of the source file mydoc.tex
.
The name of the DVI file is mydoc.dvi
.
The forward search is initiated like this:
yap -s 41mydoc.tex mydoc.dviIf you already have an open Yap application instance, and you don't want to start another instance, then add the
-1
flag:
yap -1 -s 41mydoc.tex mydoc.dvi
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
A.1 PostScript Specials A.2 HyperTeX Specials A.3 emTeX Specials A.4 DviWin Specials A.5 Color Specials
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
\special{! string}
\special{" string}
\special{ps: string}
\special{ps::[begin] string}
\special{ps:: string}
\special{ps::[end] string}
\special{ps: plotfile filename}
\special{header=filename}
\special{PSfile="filename"}
\special{psfile=filename}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
\special{html:<a href="hrefstring">}
\special{html:<a name="namestring">}
\special{html:</a>}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
\special{em: graph filename}
\special{em: graph filename, width, height}
\special{em: message string}
\special{em: line p1, p2}
\special{em: line p1, p2, width}
\special{em: lineto}
\special{em: linewidth width}
\special{em: moveto}
\special{em: point P}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
\special{anisoscale filename, width, height}
{src: linenumber filename}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
\special{color push color}
\special{color pop}
\special{color reset}
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The following copyright notice applies to the Yap program. The copyright and copying permissions for this manual appear near the beginning of this document.
Copyright (C) 1996, 97, 98 Christian Schenk. Yap is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. Yap is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Yap; if not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
C.1 Cannot locate GhostScript DLL C.2 Cannot locate GhostScript Executable C.3 Cannot create font C.4 No source specials found C.5 Cannot open TeX source file
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The GhostScript interpreter (gsdll32.dll
) could not be located.
Remedy: Install GhostScript 5.50 and make sure that the GhostScript
directory (usually `c:\gstools\gs5.50') is included in the
PATH
variable.
More information: PostScript specials are rendered with the help of GhostScript, a free PostScript interpreter.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The GhostScript executable (gswin32.exe
) could not be located.
Remedy: Install GhostScript 5.50 and make sure that the GhostScript
directory (usually `c:\gstools\gs5.50') is included in the
PATH
variable.
More information: PostScript specials are printed with the help of GhostScript, a free PostScript interpreter.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap was not able to create a missing font.
Remedy: Install the font source file(s).
More information: The logbook (`View|Logbook...') should state the name of the missing file.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
The DVI file contains no source specials.
Remedy: Use the `--src' option the next time you compile your TeX source file (see section 4.1 How to enrich your document with source specials).
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Yap cannot open the TeX source file because the current DVI page contains no source file information.
Remedy: Use the `--src' option the next time you compile your TeX source file (see section 4.1 How to enrich your document with source specials).
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
[Top] | [Contents] | [Index] | [ ? ] |
Yet Another Previewer
Most Recently Used (File)
[Top] | [Contents] | [Index] | [ ? ] |
[Top] | [Contents] | [Index] | [ ? ] |
[Top] | [Contents] | [Index] | [ ? ] |
Button | Name | Go to | From 1.2.3 go to |
---|---|---|---|
[ < ] | Back | previous section in reading order | 1.2.2 |
[ > ] | Forward | next section in reading order | 1.2.4 |
[ << ] | FastBack | previous or up and previous section | 1.1 |
[ Up ] | Up | up section | 1.2 |
[ >> ] | FastForward | next or up and next section | 1.3 |
[Top] | Top | cover (top) of document | |
[Contents] | Contents | table of contents | |
[Index] | Index | concept index | |
[ ? ] | About | this page |