Professional Documents
Culture Documents
INSTALL
INSTALL
INSTALLATION DIRECTIONS
-----------------------
There are various ways that KOMA Script can be distributed. The primary
distribution from the KOMA Script maintainers consists of a complete TEXMF
tree (also known as the/a TDS tree). This TEXMF tree in its original form is
provided as a ZIP archive. It may also be distributed in other archival
formats. When the following text refers to an archive, it therefore does not
necessarily refer to a ZIP archive. When creating a new archive,
distributors are strongly encouraged to preserve the structure and contents
of the TEXMF tree so that these instructions remain valid. Distributors are
otherwise urged to provide their own instructions for installation.
The user should therefore first check to see whether the distributor has
included further installation directions. Logically the name of these
directions would also begin with `INSTALLD.', immediately followed by the
distributor's name or acronym. A `README' file should likewise created.
TeX Live users can easily install the current release of KOMA-Script from
the KOMA repository for TeX Live. See <http://www.komascript.de/current>
for more information. But if you want to install another release, you have
to read the installation instructions below.
MiKTeX users can easily install the current release of KOMA-Script using
the self extracting archive for windows also known as MiKTeX installation
file. See <http://www.komascript.de/current> for more information. But
if you want to install another release, you have to read the installation
instructions below.
If you received the KOMA Script archive with a complete TEXMF tree, the
installation is quite easy. First check to see whether the archive does in
fact contain a complete TEXMF tree. Take a look at the contents of the
archive; there should be three directories: `doc/latex/koma-script',
`tex/latex/koma-script' and `source/latex/koma-script', the last with
additional subdirectories. In each of these directories there are several
files. A file `README' should be found at least at
`doc/latex/koma-script/README'. It may be found outside the archive as well.
When you unpack such an archive be sure to preserve the directory structure,
but without creating a new directory, either in the local TEXMF tree or in a
private TEXMF tree. More information about the local TEXMF tree and the
question of a private TEXMF tree, as well as how one makes this known to the
system can be found in the directions for your TEX system.
If KOMA Script is already present as an expanded TEXMF tree, you can either
register it in the system as a further TEXMF tree or you can copy the contents
of this TEXMF tree -- while preserving the directory structure -- into a
private or local TEXMF tree.
Here too a refresh of the filename database is necessary. See the last
paragraph of the previous section for more information.
- Copy one of the lines that begins with `#INSTALLTEXMF' from the file
`Makefile.baseinit' into this new file.
- Edit this line so that the name of the directory where the TEXMF tree is to
be installed appears following the equal sign.
CAUTION: No forward slash (/) or backslash (\) at the end of the directory
name!
- After `make' has successfully been run with no errors, run `make install'.
- First create the following new directories in the TEXMF tree in which you
wish to install KOMA Script: `source/latex/koma-script',
`doc/latex/koma-script' and `tex/latex/koma-script'.
- Copy all of the files from the KOMA Script distribution into the new
directory `source/latex/koma-script'.
- Copy all files with filenames ending in `.pdf', `.html', or `.txt' and the
`README' file into the directory `doc/latex/koma-script'.
- Run the command `tex scrmain.ins'. Answer any possible questions with `y'
for `yes'.
- Copy all newly created files whose filenames end in `.cls', `.sty' or `.lco'
into the directory `tex/latex/koma-script'.
---------------------------------------------------
German text by Markus Kohm, 2014
Translation by Kevin Pfeiffer and Markus Kohm, 2014