[Top] | [Contents] | [Index] | [ ? ] |
This help file documents MiKTeX 2.0.
1. What is MiKTeX? General information about MiKTeX. 2. What's new in MiKTeX 2.0? New features in MiKTeX 2.0. 3. Installing MiKTeX How to install MiKTeX. 4. Configuring MiKTeX How to configure MiKTeX. 5. Non-standard TeX Features MiKTeX implements some non-standard TeX features. 6. TeXify: The MiKTeX Compiler Driver How to use the MiKTeX compiler driver. A. Manual Pages Manual pages for some few programs. B. The MiKTeX Configuration File What the MiKTeX configuration file contains. C. Index Index (concepts and programs).
1.1 MiKTeX Features Basic features and components. 1.2 How to get MiKTeX How to get the MiKTeX distribution. 1.3 The MiKTeX Project Page Where is the MiKTeX Project Page? 1.4 The MiKTeX Mailing List Where is the MiKTeX mailing list? 1.5 Documentation Where to find MiKTeX related documentation.
MiKTeX is a TeX distribution for Windows (95/98/NT/2000). Its main features include:
The MiKTeX distribution consists of the following components:
The official (i.e. most recent & stable) MiKTeX release is archived in the CTAN(1) directory
`systems/win32/miktex/'. |
Visit the Project Page (see section 1.3 The MiKTeX Project Page) for detailed download instructions.
Here is a list of other packages you should take into consideration:
psmerge
) are Perl scripts. You should
install Perl if you want to use these utilities.
You can visit the MiKTeX Project Page for information about new releases, patches and so on.
There is a discussion list for MiKTeX. To join this list, send an e-mail to <miktex-request@dsts.dk> which contains the word subscribe as the first line in the message body.
This list is archived at www.egroups.com.
The MiKTeX Manual (which you are reading right now) concentrates on documenting MiKTeX specific features.
Other MiKTeX related documentation includes:
Shortcuts to these documents can be found in the MiKTeX program folder (see section 3.2 Items in the Start Menu).
initexmf
).
PATH
environment
variable.
\write18
primitive (see below).
\write18
primitive: starts a command interpreter to carry out
the specified command
3.1 Running Setup Wizard How to install MiKTeX with Setup Wizard. 3.2 Items in the Start Menu Start menu items created by Setup Wizard. 3.3 The TEXMF Folder Hierarchy Folders created by Setup Wizard. 3.4 Removing MiKTeX How to remove MiKTeX.
C:\Program
Files\MiKTeX
). This folder receives the files of the MiKTeX
distribution.
C:\Local
TeXMF
).
Benefits that a local TEXMF tree provides include the following:
E:
, then it would be possible to include E:\texmf
(the
root of the TeXLive TEXMF tree) in the MiKTeX search procedure.
setupwiz.exe
). You will
presented with the welcome page:
You have the option to create a shared installation, so that other users are able to use MiKTeX. Under Windows NT/2000, this option requires administrator privileges.
Enter the full path to the desired installation folder (see step 4).
Choose the components that you want to install.
Enter the full path to the desired local TEXMF folder (see step 5). Check the button `No local TEXMF tree', if you don't want to use a local TEXMF tree.
You are asked about whether you want to incorporate existing TEXMF trees. If you check the button `Incorporate existing TEXMF directory trees', then you must specify the locations of those trees on a subsequent page.
You should now review the installation options.
Click `Finish' to close Setup Wizard.
3.1.1 Setup Options
For the purpose of an unattended setup, some settings can be specified
on the command-line and/or in a separate text file named
setupwiz.opt
.
You can invoke the MiKTeX Setup Wizard with the following command-line options:
--additional-directory-trees DIRS
--allow-unattended-reboot
--dry-run
--installation-directory DIR
--help
--no-additional-directory-trees
--no-local-directory
--program-folder FOLDER
--unattended
Command-line options can also be specified in a text file named
setupwiz.opt
. This file must be in the same directory as
setupwiz.exe
.
The Setup Wizard inserts the following menu items into the start menu:
MiKTeX 2.0 | Help | Frequently Asked Questions
MiKTeX 2.0 | Help | LaTeX2e Reference
MiKTeX 2.0 | Help | Local Guide
MiKTeX 2.0 | Help | Release Notes
MiKTeX 2.0 | Help | Tips and Tricks
MiKTeX 2.0 | DVI viewer
MiKTeX 2.0 | MiKTeX Options
Setup Wizard creates a TDS-compliant folder hierarchy:
You can incorporate additional TEXMF folders, if the need arises. For
example, you could create a TDS-compliant folder hierarchy rooted at
C:\My TeXMF Files
. This would serve as a repository for your own
TeX files. See section Defining TEXMF Root Directories, for more information.
3.3.1 Installation Folder 3.3.2 Local TEXMF Folder
The installation folder (usually C:\Program Files\MiKTeX
) is
the root of a TDS-compliant folder hierarchy. If you have installed
the complete distribution, then the installation folder contains the
following subfolders:
bibtex
, dvips
, makeindex
, ...
doc
fonts
miktex
miktex
subfolder is reserved for MiKTeX related files:
miktex\bin
miktex\config
miktex.ini
and the
MiKTeX font mapping file miktex.map
. The MiKTeX Setup
Wizard deposits its own log file in this subfolder.
miktex\base
mf.pool
.
miktex\fmt
etex.pool
, pdftex.pool
,
omega.pool
, tex.pool
.
miktex\mem
mp.pool
.
The local TEXMF folder (usually C:\Local TeXMF
) receives files that
are generated on-the-fly. For example, if the TeX compiler needs a
TeX Font Metric (TFM) file that is not available yet, then it creates
that file (if possible) and installs it in an appropriate subfolder
of the local TEXMF folder.
Typically, the local TEXMF folder contains the following subfolders:
fonts
miktex\config
miktex\base
miktex\fmt
miktex\mem
MiKTeX can be removed with the help of the Remove MiKTeX! Wizard:
Start | Settings | Control Panel
).
Software
(or Add/Remve Programs
) icon.
MiKTeX 2.0
.
4.1 Managing TEXMF Folder Hierarchies How to administer TEXMF folder hierarchies. 4.2 Refreshing the File Name Database How to refresh the file name database. 4.3 Managing Format Files How to administer TeX format files. 4.4 Selecting Hyphenation Rules How to administer languages. 4.5 Expert Topics Configuration topics for TeX experts.
The standard setup process creates two TEXMF root folders:
C:\Program Files\MiKTeX
: the installation folder (see section 3.3.1 Installation Folder).
C:\Local TeXMF
: the local TEXMF folder (see section 3.3.2 Local TEXMF Folder).
You can incorporate additional TEXMF folder hierarchies with the help of MiKTeX Options:
Start | Programs | MiKTeX 2.0 | MiKTeX Options
.
Roots
tab.
The Roots
window displays a list of TEXMF root folders that are used
by MiKTeX:
Click Up
and Down
to change the order by which
the TEXMF folders are searched for input files.
Click Add...
to append a new TEXMF root folder to the list.
Click Refresh FNDB
to scan the selected folders for
new files and update the file name database (see section 4.2 Refreshing the File Name Database)
accordingly.
Click Remove
to remove selected folders from the list.
Click Declare Local
to declare the selected folder as the
local TEXMF folder (see section 3.3.2 Local TEXMF Folder).
To speed up file search, MiKTeX makes use of a list of known file names. This list is called the file name database (FNDB).
It is strongly recommended that you update the file name database whenever files are added to or removed from one of the TEXMF directories. You can update the file name database with the help of MiKTeX Options:
Start | Programs | MiKTeX 2.0 | MiKTeX Options
.
Refresh Now
Some programs initialize itself by reading parts of the memory from an external file. For the TeX family of programs, such a file is called a Format File.
4.3.1 Building Format Files How to update all format files. 4.3.2 Defining New Format Files How to define new format files.
MiKTeX Setup Wizard has created standard format files in course of the installation process. You can refresh those format files with the help of MiKTeX Options:
Start | Programs | MiKTeX 2.0 | MiKTeX Options
.
Update Now
.
Start | Programs | MiKTeX 2.0 | MiKTeX Options
.
TeX Formats
tab.
You are presented with a list of well known TeX formats.
To add an entry to this list, click New...
.
You have to supply the following information:
A new executable with the the name of the format will be created.
You can control the loading of hyphenation patterns with the help of MiKTeX Options:
Start | Programs | MiKTeX 2.0 | MiKTeX Options
.
Languages
tab.
You can choose which hyphenation patterns are to be loaded by TeX.
4.5.1 Maintaining the PostScript resource database PostScript resource database.
The PostScript resource database (PSres) is used by some utilities in order to locate PostScript resources (font outlines/metrics/encodings).
The database is located in the local MiKTeX config folder (usually `C:\Local TeXMF\miktex\config'). The name of the database file is `dpres.dpr'. It is a text file, i.e. you can view it with a conventional text editor.
It is strongly recommended that you update the database whenever PostScript resources (`*.pfb;*.afm;*.enc') are added to or removed from one of the TEXMF trees.
You update the database files by invoking initexmf
with
the command line switch --mkpsres
:
C:\> initexmf --mkpsres |
4.5.1.1 Incorporating External Font Directories
It is possible to add non-MiKTeX font directories to the PostScript
resource database. The --mkpsres
switch accepts as an optional
argument the name of an external font directory. You can use several
--mkpsres
switches with one invocation of initexmf
.
By specifying the command line flag --search
, you can cause
initexmf
to automatically search your workstation for third party
PostScript resource files (e.g. Acrobat Reader fonts):
C:\> initexmf --mkpsres --search |
This chapter describes features, that were added to the MiKTeX implementation of Donald Knuth's TeX.
5.1 Suppressing Screen Output How to suppress screen output. 5.2 Auto-insertion of Source Specials How to insert source specials. 5.3 Quoted File Names How to use long file names with spaces. 5.4 Specifying Additional Input Directories How to extend the search path. 5.5 Specifying the Output Directory How to specify an alternative output directory. 5.6 Running Programs How to start programs from within .tex
file.5.7 TCX files: Character translations Character translations.
The command-line option `--quiet' suppresses all diagnostic messages. You will see no screen output, unless there are errors. These are shown in a "C style form" and do not stop the compilation process. For example, the input file
foo.tex: \documentclass{article} \begin{document} What's \This? \end{documnt} |
would cause TeX to print one error message, as in
C:\> latex --quiet foo.tex foo.tex:3: Undefined control sequence C:\> |
Source specials are pieces of information embedded in a DVI file, which
make a connection between the source file location (e.g. line 100 in
foo.tex
) and the DVI location (e.g. page 2 in foo.dvi
).
Source specials can improve the Edit-TeX-View-Edit cycle:
The TeX compiler option `--src' inserts source specials into the DVI file. You would say
C:\> latex --src foo.tex |
to create the DVI file foo.dvi
with embedded source specials.
The TeX compiler can handle quoted file names. This makes it possible to specify long file names that contain spaces.
For example, to compile the input file `long file name.tex', you start TeX as follows:
C:\> latex "long file name" |
This produces the DVI file `long file name.dvi'. The log file is named `long file name.log'.
You can, to some extent, use quoted file names inside the TeX document. For example,
\input{"extra long file name"} |
would cause TeX to read the file `extra long file name.tex'.
Things get a little bit complicated if you want to use the LaTeX primitive `\include'. You have to write
\include{"extra\space long\space file\space name"} |
in order to get the expected result.
The command-line option `--include-directory=dir' allows you to extend the input search path for one invocation of TeX.
For example,
tex --include-directory="C:\My TeX" foo.tex |
prepends `C:\My TeX' to the input search path, i.e. `C:\My TeX'
will be searched first, when TeX opens any input file (including foo.tex
).
You can specify either absolute paths (as in the example above) or relative paths.
The command-line option `--output-directory=dir' causes TeX to create all output files in another directory.
Example:
mkdir C:\texoutput latex --output-directory=C:\texoutput foo.tex |
All output files (foo.dvi
, foo.log
, ...) will be created in
C:\texoutput
.
TeX handles output stream 18 in a special way: the token list is
interpreted as a system command. If the \write18
feature is
enabled (see below), then \write18{toklist}
starts the
command interpreter (usually command.com
) to carry out the
command specified by toklist. For example:
\write{dir} |
lists the files and subdirectories of the current directory.
TeX ignores \write18
by default. You enable it by editing
miktex.ini
(search for write18
) or by using the
TeX compiler switch --enable-write18
.
[ This section is "borrowed" from the Web2C manual ].
TCX (TeX character translation) files help TeX support direct input of 8-bit international characters if fonts containing those characters are being used. Specifically, they map an input (keyboard) character code to the internal TeX character code (a superset of ASCII).
Of the various proposals for handling more than one input encoding, TCX files were chosen because they follow Knuth's original ideas for the use of the `xchr' and `xord' tables. He ventured that these would be changed in the WEB source in order to adjust the actual version to a given environment. It turned out, however, that recompiling the WEB sources is not as simple task as Knuth predicted; therefore, TCX files, providing the possibility of changing of the conversion tables on on-the-fly, has been implemented instead.
This approach limits the portability of TeX documents, as some implementations do not support it (or use a different method for input-internal reencoding). It may also be problematic to determine the encoding to use for a TeX document of unknown provenance; in the worst case, failure to do so correctly may result in subtle errors in the typeset output.
While TCX files can be used with any format, using them breaks the LaTeX `inputenc' package. This is why you should either use tcxfile or `inputenc' in LaTeX files, but never both.
TCXPath
path.
INITEX
ignores TCX files.
The MiKTeX distribution comes with at least two TCX files, `il1-t1.tcx' and `il2-t1.tcx'. These support ISO Latin 1 and ISO Latin 2, respectively, with Cork-encoded fonts (a.k.a. the T1 encoding). TCX files for Czech, Polish, and Slovak are also provided.
src [dest] |
Finally, here's what happens: when TeX sees an input character with code src, it 1) changes src to dest; and 2) makes code the dest "printable", i.e., printed as-is in diagnostics and the log file instead of in `^^' notation.
By default, no characters are translated, and character codes between 32 and 126 inclusive (decimal) are printable. It is not possible to make these (or any) characters unprintable.
Specifying translations for the printable ASCII characters (codes
32--127) will yield unpredictable results. Additionally you shouldn't
make the following characters printable: ^^I
(TAB), ^^J
(line feed), ^^M
(carriage return), and ^^?
(delete),
since TeX uses them in various ways.
Thus, the idea is to specify the input (keyboard) character code for src, and the output (font) character code for dest.
texify
is a command-line utility that simplifies the creation
of DVI (PDF) documents: texify
automatically runs LaTeX
(pdfLaTeX), MakeIndex and BibTeX as many times as necessary to
produce a DVI (PDF) file with sorted indices and all cross-references
resolved.
To run texify
on an input file `foo.tex', do this:
C:\> texify foo.tex |
As shown in this example, the input file names to texify
must
include any extension (`.tex', `.ltx', etc.).
There are several command-line optione you can use to control texify
(see section A.9 texify
). Here are some examples:
This chapter includes manual pages for some few programs. Only programs
with non-standard command-line options are documented here. You should
browse the document folder (usually C:\Program Files\MiKTeX\doc
) if you
are searching for 'real' documentation.
A.1 Common Compiler Options Options common to all compilers. A.2 bibtex Manual page for bibtex
.A.3 dvicopy
Manual page for dvicopy
.A.4 initexmf
(MiKTeX Configuration Utility)Manual page for initexmf
(MiKTeX Configuration Utility).A.5 mp
(MetaPost)Manual page for mp
(MetaPost)A.6 omega
Manual page for omega
.A.7 pdftex
Manual page for pdftex
.A.8 tex
Manual page for tex
.A.9 texify
Manual page for texify
(MiKTeX Compiler Driver).
The following command-line switches are commonly supported by all variants of the TeX compiler.
--alias=app
--buf-size=n
buf_size
to n. buf_size
is the
maximum number of characters simultaneously present in current lines of
open files and in control sequences between \csname
and
\endcsname
; must not exceed 1073741823.
--c-style-errors
\scrollmode
.
--error-line=n
error_line
to n. error_line
us the
width of context lines on terminal error messages.
--half-error-line=n
half_error_line
to n.
half_error_line
is the width of first lines of contexts in
terminal error messages; should be between 30 and (error_line
-
15).
--halt-on-error
--initialize
\dump
ed to a dump
file.
--include-directory=dir
--interaction=mode
batchmode
, nonstopmode
,
scrollmode
, errorstopmode
).
--job-name=name
--job-time=filename
--help
--max-in-open=n
max_in_open
to n. max_in_open
is
the maximum number of input files and error insertions that can be going
on simultaneously.
--max-print-line=n
max-print-line
to n.
max-print-line
is the width of longest text lines output; should
be at least 60.
--max-strings=n
max_strings
to n. max_strings
is
the maximum number of strings; must not exceed 1073741823.
--mem-bot=n
mem_bot
to n. mem_bot
is the
smallest index in the code
array dumped by INITEX
(INIOMEGA
, INIPDFTEX
); must not be less than
mem_min
.
--mem-max=n
mem_max
to n. mem_max
is the
greatest index in the internal mem
array; must be strictly less
than 1073741823.
--mem-min=n
mem_min
to n. mem_min
is the
smallest index in the internal mem
array; must be 0 or more; must
be equal to mem_bot
in INITEX
(INIOMEGA
,
INIPDFTEX
), otherwise <= mem_bot
.
--mem-top=n
mem_top
to n. mem_top
is the
largest index in the mem
array dumped by INITEX
(INIOMEGA
, INIPDFTEX
); must be substantially larger than 0
and not greater than mem_max
.
--nest-size=n
nest_size
to n. nest_size
is the
maximum number of semantic levels simultaneously active.
--output-directory=dir
--param-size=n
param_size
to n. param_size
is the
maximum number of simultaneous macro parameters.
--pool-size=n
pool-size
to n. pool_size
is the
maximum number of characters in strings, including all error messages
and help texts, and the names of all fonts and control sequences; must
exceed string_vacancies
by the total length of the program's own
strings, which is currently about 30000.
--quiet
--save-size=n
save_size
to n. save_size
is the
amount of space for saving values outside of current group; must be at
most 1073741823.
--shell-escape
--enable-write18
.
--silent
--quiet
.
--src-specials
--stack-size=n
stack_size
to n. stack_size
is the
maximum number of simultaneous input sources.
--string-vacancies=n
string_vacancies
to n.
string_vacancies
is the minimum number of characters that should
be available for the user's control sequences and font names, after the
program's own error messages are stored.
--tcx=name
--translate-file=name
--terminal=oem
--trace=traceflags
--trie-size=n
trie_size
to n. trie_size
is the
amount of space for hyphenation patterns; should be larger for
INITEX
(INIOMEGA
, INIPDFTEX
) than it is in
production versions of the program.
--trie-op-size=n
trie_op_size
to n. trie_op_size
is
the amount of space for "opcodes" in the hyphenation patterns.
--try-gz
.tex.gz
if file.tex
cannot be found.
--undump=name
--version
--enable-write18
\\write18
construct (see section 5.6 Running Programs).
BibTeX is a preprocessor for the LaTeX document-preparation
system. It handles most of the formatting decisions required to produce
a reference list, outputting a .bbl
file; with this file LaTeX
actually produces the reference list.
bibtex [option...] name |
Reads the file `name.aux' and outputs the file `name.bbl'.
--help
--min-crossrefs=N
min_crossrefs
parameter to N.
--version
See BibTeXing, available as file `btxdoc.dvi'.
dvicopy
dvicopy
is a utility program that allows one to take a DVI file
that references composite fonts (VF) and convert it into a DVI file that
does not contain such references.
dvicopy [option...] old new |
Converts DVI file old into new.
--help
--mag=MAG
--select=range
--version
initexmf
(MiKTeX Configuration Utility)
initexmf
is the MiKTeX Configuration Utility.
initexmf [option...] |
--dump
*.base
;*.efmt
;*.fmt
;*.mem
).
--dump=program
elatex
,
etex
,
lambda
,
latex
,
metafont
,
metapost
,
omega
,
pdflatex
,
pdftex
,
tex
.
--find-elatex-input FILE
--find-etex-input FILE
--find-executable FILE
--find-lambda-input FILE
--find-latex-input FILE
--find-metafont-input FILE
--find-metapost-input FILE
--find-omega-input FILE
--find-other-executable FILE
--find-pdflatex-input FILE
--find-pdftex-input FILE
--find-tex-input FILE
--list-modes
--local-root root
--mkpsres
--search
(see below).
--mkpsres=`dir'
--personal
-p
--personal=filename
-pfilename
--print-only
-n
--quiet
--reconfigure
--report
--root-directories dirlist
-r dirlist
--search
--mkpsres
).
--update-fndb
-u
--update-fndb=root
-uroot
--verbose
-v
--version
-V
mp
(MetaPost)
MetaPost (installed as mp
) reads a series of pictures specified
in the MetaPost programming language, and outputs corresponding
PostScript code.
mp [option...] [name[.mp]] [command...] mp [option...] "&format" [command...] |
--c-style-errors
\scrollmode
.
--initialize
--help
--tex=texprogram
tex
when compiling text labels.
This flag overrides the environment variable TEX
.
--version
inimp
mpost
virmp
TEX
For a complete description of the MetaPost language, see AT&T technical report CSTR-162, available as the file `mpman.ps'.
omega
Omega is a 16-bit enhanced version of TeX.
omega [option...] [name[.tex]] [command...] |
Omega supports the common compiler options (see section A.1 Common Compiler Options).
iniomega
omega --ini
.
viromega
omega
.
lambda
omega "&lambda"
.
For a complete description of Omega, see the Omega manual, available as the file `omega-manual.dvi'.
pdftex
pdfTeX is a special version of TeX that outputs PDF.
pdftex [option...] [name[.tex]] [command...] pdftex [option...] "&format" [command...] |
Besides the common command-line switches (see section A.1 Common Compiler Options), pdfTeX supports these options:
--font-max=n
font_max
to n. font_max
is the
maximum internal font number; must not exceed 5000.
inipdftex
pdftex --ini
.
virpdftex
pdftex
.
pdflatex
pdftex "&pdflatex"
.
For a complete description of pdfTeX, see the the pdfTeX User Manual, available as file `pdftexman.pdf'.
tex
tex
is Donald Knuth's TeX compiler.
tex [option...] [name[.tex]] [command...] tex [option...] "&format" [command...] |
Besides the common command-line switches (see section A.1 Common Compiler Options), tex
supports the following options:
--font-max=n
font_max
to n. font_max
is the
maximum internal font number; must not exceed 5000.
See section A.9 texify
, for an alternative way to invoke TeX.
For a complete description of TeX, see The TeXbook by Donald E. Knuth.
texify
texify
runs Texinfo or LaTeX input files through TeX
(pdfTeX) in turn until all cross-references are resolved, building
all indices.
texify [option]... file... |
The directory containing each file is searched for included files. The suffix of file is used to determine its language (LaTeX or Texinfo).
Makeinfo is used to perform Texinfo macro expansion before running TeX when needed.
-@
@input
instead of \input
; for preloaded Texinfo.
-b
--batch
-c
--clean
-e
--expand
-I dir
-h
--help
-l lang
--language=lang
latex
or texinfo
.
--max-iterations=n
--mkidx-option=option
-p
--pdf
-q
--quiet
--batch
).
--run-viewer
-s
--silent
--quiet
.
-t cmd
--texinfo=cmd
@setfilename
in copy of input file.
Multiple values accumulate.
--tex-option=option
-v
--version
--viewer-option=option
The values of the BIBTEX
, LATEX
(or PDFLATEX
),
MAKEINDEX
, MAKEINFO
, TEX
(or PDFTEX
), and
TEXINDEX
environment variables are used to run those commands, if
they are set.
texi2dvi
texify
.
This chapter describes the contents of the MiKTeX configuration file (miktex.ini
).
B.1 Specifying search paths How to specify search paths. B.2 Contents of a MiKTeX Configuration File What the MiKTeX configuration file contains.
Search paths are used by MiKTeX to find special files (such as TeX input files) within a comprehensive directory hierarchy.
A search path is a semicolon-separated list of directory paths. This list is traversed from left to right, i.e. the first directory is searched first.
In a directory path, the following character sequences have a special meaning:
%R
//
Assuming that C:\Program Files\MiKTeX;\\myserver\texmf
is the list of TEXMF root
directories, the search path .;%R\tex\latex//;%R\tex\generic//
causes LaTeX to search its input files in the following locations:
.
).
C:\Program Files\MiKTeX\tex\latex
and in all directories below
it.
\\myserver\texmf\tex\latex
and in all
directories below it.
C:\Program Files\MiKTeX\tex\generic
and in all directories
below it
\\myserver\texmf\tex\generic
and in all
directories below it.
You can use the configuration utility initexmf
to test whether
an input file can be found via the current search path.
For example, the command
C:\> initexmf --find-latex-input a4.sty |
searches for the LaTeX input file a4.sty
. The full path name
is printed if the file was found.
A MiKTeX configuration file is divided into several named sections. Each section contains configuration settings for a specific application or feature.
The section [BibTeX]
contains BibTeX related configuration
settings.
Input Dirs
min_crossrefs
cite_list
inclusion.
The section [Dvips]
contains Dvips related configuration
settings.
CONFIGPath
config.ps
).
ENCPath
.enc
files.
GraphicsPath
.eps
files.
MAPPath
.map
files.
PSPath
The section [Graphics]
contains graphics conversion rules. Each
rule has the syntax
.fromext.toext=commandline |
fromext is the file name extension of the source file. toext is the file name extension of the destination file. commandline is the command-line which does the conversion. The command-line may include the following placeholders:
%i
%o
The standard MiKTeX configuration file contains the following rules:
The section [Magic]
contains memory related configuration settings.
The values are used by TeX, pdfTeX and Omega for the dynamic
allocation of certain data structures.
The following parameters can be changed at run time to extend or reduce
TeX's capacity. They may have different values in INITEX
and
in production versions of TeX.
mem_min
mem
array; must be 0 or more;
must be equal to mem_bot
in INITEX
, otherwise <=mem_bot
.
mem_max
mem
array; must be strictly
less than 1073741823.
buf_size
\csname
and
\endcsname
; must not exceed 1073741823.
error_line
half_error_line
error_line
- 15).
max_print_line
stack_size
max_in_open
font_max
font_mem_size
font_info
for all fonts.
param_size
nest_size
max_strings
string_vacancies
pool_size
string_vacancies
by the total length of TeX's own
strings, which is currently about 23000.
save_size
trie_size
INITEX
than
it is in production versions of TeX.
trie_op_size
Like the preceding parameters, the following quantities can be changed
at run time to extend or reduce TeX's capacity. But if they are
changed, it is necessary to rerun the initialization program
INITEX
to generate new tables for the production TeX program.
One can't simply make helter-skelter changes to the following constants,
since certain rather complex initialization numbers are computed from
them.
mem_bot
INITEX
; must not be
less than mem_min
.
mem_top
INITEX
; must be
substantially larger than 0 and not greater than mem_max
.
The section [MakeIndex]
contains MakeIndex related configuration
settings.
INDEXSTYLE
The section [MakePK]
contains configuration settings that are
related to the auto-creation of packed raster fonts.
DestDir
The specifiation may include special character sequences which will be replaced at search-time:
%m
%d
%s
public
).
%t
cm
).
Admin note: All MiKTeX users must have permission to create files in the specified directory.
DestDir
.tfm
files are to be installed.
The specifiation may contain special character sequences which are replaced at search-time:
Admin note: MiKTeX users must have permission to add files to the specified directory.
The section [METAFONT]
contains METAFONT related configuration
settings.
Input Dirs
The section [MetaPost]
contains MetaPost related configuration
settings.
Input Dirs
The section [MiKTeX]
contains general configuration settings
and search path specifications.
Trace
notrace
fndb
filesearch
access
process
tcx
error
time
TraceFile
AFMPath
*.afm
).
BASEPath
*.base
).
ENCPath
*.enc
files.
EXEPath
FMTPath
.fmt
). Also used to
locate e-TeX format files (.efmt
).
GraphicsPath
*.eps;*.bmp;...
).
MAPPath
*.map
).
MEMPath
.mem
).
OFMPath
*.ofm
).
OVFPath
*.ovf
).
PKPath
*.pk
).
PSPath
*.enc;*.map
);
TCXPath
.tcx
).
TFMPath
*.tfm
).
TTFPath
*.ttc;*.ttf
).
Type1Path
*.pfa;*.pfb
).
VFPath
*.vf
).
The section [Omega]
contains Omega related configuration settings:
Input Dirs
OCPPath
otp2ocp
Configuration Settings
Input Dirs
otp2ocp
to locate OTP files (.otp
).
The section [pdfTeX]
contains pdfTeX related configuration settings.
Input Dirs
PSPath
ps2pk
Configuration Settings
The section [ps2pk]
contains configuration settings for the
ps2pk
utility:
PSResPath
ps2pk
searches for PS resource files.
The section [TeX]
contains TeX-related configuration settings.
Editor
e
in the error menu.
You can use the following placeholders:
%f
%h
%l
%m
%t
For example, a suitable value for WinEdt would be `winedt %f -G(1,%l,0) -S(12,+1,0)'.
Input Dirs
Input Dirs
*.dvi
).
Jump to: | %
-
.
/
8
\
^
A B C D E F G H I J K L M N O P Q R S T U V W Y |
---|
Jump to: | %
-
.
/
8
\
^
A B C D E F G H I J K L M N O P Q R S T U V W Y |
---|
[Top] | [Contents] | [Index] | [ ? ] |
CTAN: Comprehensive TeX Archive Network
[Top] | [Contents] | [Index] | [ ? ] |
1. What is MiKTeX?
1.1 MiKTeX Features2. What's new in MiKTeX 2.0?
1.2 How to get MiKTeX
1.3 The MiKTeX Project Page
1.4 The MiKTeX Mailing List
1.5 Documentation
3. Installing MiKTeX
3.1 Running Setup Wizard4. Configuring MiKTeX
3.1.1 Setup Options3.2 Items in the Start Menu
3.3 The TEXMF Folder Hierarchy
3.3.1 Installation Folder3.4 Removing MiKTeX
3.3.2 Local TEXMF Folder
4.1 Managing TEXMF Folder Hierarchies5. Non-standard TeX Features
4.2 Refreshing the File Name Database
4.3 Managing Format Files
4.3.1 Building Format Files4.4 Selecting Hyphenation Rules
4.3.2 Defining New Format Files
4.5 Expert Topics
4.5.1 Maintaining the PostScript resource database
4.5.1.1 Incorporating External Font Directories
5.1 Suppressing Screen Output6. TeXify: The MiKTeX Compiler Driver
5.2 Auto-insertion of Source Specials
5.3 Quoted File Names
5.4 Specifying Additional Input Directories
5.5 Specifying the Output Directory
5.6 Running Programs
5.7 TCX files: Character translations
A. Manual Pages
A.1 Common Compiler OptionsB. The MiKTeX Configuration File
A.2 bibtex
A.3dvicopy
A.4initexmf
(MiKTeX Configuration Utility)
A.5mp
(MetaPost)
A.6omega
A.7pdftex
A.8tex
A.9texify
B.1 Specifying search pathsC. Index
B.2 Contents of a MiKTeX Configuration File
B.2.1 [BibTeX]: BibTeX Configuration Settings
B.2.2 [Dvips]: Dvips Configuration Settings
B.2.3 [Graphics]: Graphics Conversion Rules
B.2.4 [Magic]: Memory Settings for TeX & Friends
B.2.5 [MakeIndex]: MakeIndex Configuration Settings
B.2.6 [MakePK]: MakePK Configuration Settings
B.2.7 [MakeTFM]: MakeTFM Configuration Settings
B.2.8 [METAFONT]: METAFONT Configuration Settings
B.2.9 [MetaPost]: MetaPost Related Configuration Settings
B.2.10 [MiKTeX]: General Configuration Settings
B.2.11 [Omega]: Omega Configuration Settings
B.2.12 [otp2ocp]:otp2ocp
Configuration Settings
B.2.13 [pdfTeX]: pdfTeX Configuration Settings
B.2.14 [ps2pk]:ps2pk
Configuration Settings
B.2.15 [TeX]: TeX Configuration Settings
B.2.16 [Yap]: Yap Configuration Settings
[Top] | [Contents] | [Index] | [ ? ] |
1. What is MiKTeX?
2. What's new in MiKTeX 2.0?
3. Installing MiKTeX
4. Configuring MiKTeX
5. Non-standard TeX Features
6. TeXify: The MiKTeX Compiler Driver
A. Manual Pages
B. The MiKTeX Configuration File
C. 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 |