This page contains a list of external programs that are used when building. Not all programs are necessary in use, the actual programs needed depends on the project output format and build commands -settings.
Choose one program in the list and press the edit-button. A configuration dialog
will appear. The program configuration dialog contains a text field for specifying
the location of the program, and another field for the program arguments. The
default values that are provided should work on fairly recent systems.
LaTeX version 7.3.x doesn't seem to support --src-specials
-argument, so that may have to be changed when working with an older distribution.
TeX distribution usually contains one directory, where all the executable programs
are installed (usually called "bin"). That directory contains a lot of
programs, and some people don't keep it in their path.
If the TeX-programs directory is not in the path (or if Eclipse installs
its own path environment variable at startup), TeXlipse can't find the necessary
programs. Because it is boring to setup ten programs individually, there is a
text box to set the paths all at once. Press Browse-button, browse to the TeX-programs directory
(the directory where latex
, bibtex
, etc. programs are) and
press the big Apply-button at the bottom of the page. The program paths should all change.
The console log means the Console View, which is accessible through Window > Show View > Other > Basic > Console. If the builder console log is enabled, all the messages printed by external programs to standard output will be shown in the console log. That's a lot of output, and that's why this option is disabled by default. It is, however, very handy for figuring out why something doesn't work.
\begin
and \end
)
can have their contents indented to keep the document structure clear. Those environments
are listed in this page. Also the indentation width, i.e. the number of spaces that is inserted
to the beginning of a line, can be changed in this page.
This page shows the list of example configurations for an external viewer program.
The configuration at the top of the list is used when activating the previewer.
Viewer configurations can be edited by choosing a configuration name from the
list and pressing the edit-button. A viewer configuration dialog will appear.
The viewer program location and viewer arguments can be changed from this
dialog. If the arguments-field contains the special string "%file
",
it will be replaced with the input file name when launching viewer.
The build before launch -checkbox controls whether the project will be built automatically before launching viewer. If the Project > Build Automatically -option is used, this checkbox has no effect.
The inverse search port number is the port that is opened for external viewer programs to input inverse search (navigation from output file to source file) commands.
This dialog opens by selecting Project > Properties from the Eclipse menu and choosing Latex project properties. This dialog contains options specific to the project.
Note: project properties dialog shows only the property pages associated to the current Eclipse perspective. If your project is a Java project, your workbench is likely to be in Java perspective. Because TeXlipse is built upon Resource perspective, you may have to switch to Resource perspective in order to see the Latex project properties.
This field contains the name and path of the project main file. Main file means
the file that is given to external latex
program as a parameter.
The project main file is necessary because a Latex project doesn't always have an obvious main file. If the Latex project is, for example, a book project, there might be more than ten files with the extension '.tex'. Because of the flexible syntax of LaTeX, there is no simple way to determine which of these files is the starting point of the document. To prevent weird errors, determining which file is the main file is left to the user.
This field contains the name and path of the project output file. Note that the extension of this file must be the extension of the output format chosen.
This field contains the name of the directory that is used for storing temporary files (e.g. Latex aux- and log-files). Temporary files are recognised from their file extension. The list of file extensions for temporary files is in the Latex Temp Files preference page.
This option configures the output file format of the project. There is a possibility to choose between DVI (Device Independent format), PS (PostScript format) and PDF (Portable Data File format). The output file has to have the extension according the file format. Note that changing this field affects the output file name's extension, but not the other way around.
This option shows which combination of external programs is used to build
this project. For example, if PostScript (.ps) output is chosen, there is
a chance to choose between pslatex
and latex+dvips
.
Choosing pslatex
here means that the pslatex
program is
used to produce a PostScript file directly, whereas
latex+dvips
means that the latex
program is used to
produce a DVI file and then the dvips
program is used to convert
the DVI file into PostScript format.