help ltex

Title

Featured list of LaTeX files in the working directory

Syntax

ltex [ stub ] , erase

where stub may be a single letter or any combination of
characters that can be used for filenames.

Description

ltex returns a list of LaTex files that are stored in the
working directory. If stub is specified, only files with names
containing stub are listed. Along with the file names,
the programs offer a list of click-able links for some typical tasks
that one wants to do for LaTeX files.

Specifically, ltex provides links for viewing, editing,
and typesetting each of the LaTeX files in the working directory.

By default, the Stata do-file editor is invoked when clicking
the edit-item of the ltex-output. However, you can use a
different editor by setting the global macro "MYEDITOR" to the command
that opens your preferred text editor. I, for example, have the line

profile.do

global MYEDITOR !emacsclient -n

in my profile file, which works under Linux. Windows users might
prefer something along the following lines

profile.do

global MYEDITOR winexec textpad

Note that setting the macro MYEDITOR also affects the editor
used to open do-files with ldo.

Typesetting the LaTeX-file is done with the pdflatex, which
produces PDF output. After typesetting, the created file is opened
immediately. Typesetting requires that LaTeX is installed properly on
your computer. Opening the created PDF requires that a previewer for
PDF files is installed on the computer. By default, acrobat reader is
assumed as previewer, but this can be changed by setting the global
macro "MYPDFVIEWER". I, for example have the

profile.do

global MYPDFVIEWER xpdf

in my profile file.

Technical note

LaTeX files produced by Stata are often incomplete in the sense
that they don't have a preamble. Before typesetting ltex
therefore looks in the first 30 rows of the file whether there is a
preamble or not. If not, ltex tries to run the file with a
minimal preamble. This works sometimes, but sometimes not.

Options

erase brings up yet another click-able item which
allows to erase files on disk. Clicking on that item removes the
respective file immediately from the disk. The file is not moved to
the recycle bin. The erase button is printed in red to
indicate that it should be handled with care.

Example

. ltex

Author

Ulrich Kohler, kohler@wzb.eu

Also see

Online: ldta, cdout, clickout,
fastcd (if installed)