[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
AUCTeX allows you to start external programs for previewing your document. These are normally invoked by pressing C-c C-c once the document is formatted or via the respective entry in the Command menu.
AUCTeX will try to guess which type of viewer (DVI, PostScript or PDF) has to be used and what options are to be passed over to it. This decision is based on the output files present in the working directory as well as the class and style options used in the document. For example, if there is a DVI file in your working directory, a DVI viewer will be invoked. In case of a PDF file it will be a PDF viewer. If you specified a special paper format like `a5paper' or use the `landscape' option, this will be passed to the viewer by the appropriate options. Especially some DVI viewers depend on this kind of information in order to display your document correctly. In case you are using `pstricks' or `psfrag' in your document, a DVI viewer cannot display the contents correctly and a PostScript viewer will be invoked instead.
The information about which file types and style options are
associated with which viewers and options for them is stored in the
variables TeX-output-view-style
and TeX-view-style
.
The command TeX-view
, bound to C-c C-v, starts a viewer
without confirmation. The viewer is started either on a region or the
master file, depending on the last command issued. This is especially
useful for jumping to the location corresponding to point in the
DVI viewer when using TeX-source-specials-mode
.
List of output file extensions, style options and view options.
List of style options and view options. This is the predecessor of
TeX-output-view-style
which does not allow the specification of
output file extensions. It is used as a fallback in case none of the
alternatives specified in TeX-output-view-style
match. In case
none of the entries in TeX-view-style
match either, no suggestion
for a viewer will be made.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
You can make use of forward and inverse searching if this is supported
by your DVI viewer and you enabled
TeX-source-specials-mode
. See section Executing Commands, on how to do that.
AUCTeX will automatically pass the necessary command line options to
the viewer in order to display the page containing the content you are
currently editing (forward search).
Upon opening the viewer you will be asked if you want to start a server
process (Gnuserv or Emacs server) which is necessary for inverse search.
This happens only if there is no server running already. You can
customize the variable TeX-source-specials-view-start-server
to
inhibit the question and always or never start the server respectively.
If TeX-source-specials-mode
is active and a DVI viewer
is invoked, the default behavior is to ask if a server process should be
started. Set this variable to t
if the question should be
inhibited and the server should always be started. Set it to nil
if the server should never be started. Inverse search will not be
available in the latter case.
Once the server and the viewer are running you can use a mouse click in the viewer to jump to the corresponding part of your document in Emacs (inverse search). Refer to the documentation of your viewer to find out what you have to do exactly. In xdvi you usually have to use C-down-mouse-1.
For PDF output, forward search is availabe when using the pdfsync
LaTeX package and xpdf as PDF viewer. With the pdfsync package
forward search does not rely on source specials. Therefore you don't
have to bother about the provisions for source specials explained above.
If document parsing is enabled, the functionality is usable immediately,
e.g. by typing C-c C-v (TeX-view
) which will open the
viewer or bring it to front if it is already opened and display the
output page corresponding to the position of point in the source file.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] |
This document was generated on August, 12 2007 using texi2html 1.76.