Readme File for MiKTeX 1.08 Copyright (C) 1997 Christian Schenk Contents: What is it? What is it not? What should you download? Installation Configuring Dvips Where are the docs? Copying No Warranty What is it? *********** MiKTeX 1.08 is an implementation of TeX, METAFONT, dvips and other TeX related utilities for Windows NT and Windows 95. The MiKTeX distribution contains the following packages: * TeX 3.14159 * LaTeX2e Jun'97 including standard packages * METAFONT 2.718 * MetaPost 0.632 * dvips 5.74 * MakeIndex 2.12 * Texinfo 3.11 * BibTeX 0.99c * YAP (Yet Another Previewer) 0.91 * TeXware (dvitype, ...) * METFONTware (gftopk, ...) * psutils (psselect, pstops, ...) * DVIcopy You must have some basic knowledge of (La)TeX in order to make use of MiKTeX. If you are an absolute beginner, then you should start with one of the FAQs: English: http://www.cogs.susx.ac.uk/cgi-bin/texfaq2html?introduction=yes German: http://www.dante.de/dante/dante-faq.html MiKTeX features --------------- * Native Win32 implementation * Supports multiple TeXMF directory trees * Uses a file name data base for fast file access * TDS compliant * Supports long file names * On-the-fly generation of TFM files * On-the-fly generation of PK files * Free software (GPLed). Source code available. What is it not? *************** Most of the programs that come with MiKTeX are command line oriented, i.e., you will miss a graphical user interface. MiKTeX does not run under Windows 3.1. What should you download? ************************* MiKTeX 1.08 is distributed in the form of 21 packed archives (zip format): --------------------------------------------------------------------------- Filename | | Description ---------------+---+------------------------------------------------------- amsf108.zip | | AMS-Fonts amsl108.zip | | AMS-LaTeX babl108.zip | | Babel system bib108.zip | | Generic BibTeX input files cm108.zip | | Computer Modern fonts dvips108.zip | | Generic dvips input files ec108.zip | | EC fonts exe108ia.zip | ! | intel-based executables, part 1/2 exe108ib.zip | ! | intel-based executables, part 2/2 latex108.zip | | LaTeX2e base distribution mf108.zip | | Generic METAFONT input files and plain base file mik108.zip | ! | Essential MiKTeX files misc108.zip | | MiKTeX input files mkind108.zip | | Generic MakeIndex input files mp108.zip | | Generic MetaPost input files ps108.zip | | PostScript fonts for LaTeX2e src108.zip | | MiKTeX source files sty108.zip | | Various LaTeX packages tex108.zip | | Generic TeX input files txi108.zip | | Texinfo input files and documentation vga108.zip | | PK font files for the screen --------------------------------------------------------------------------- You use an installation utility (install.exe) to unpack the archives and to configure MiKTeX for your system. The installation utility depends on the presence of unzip.exe: --------------------------------------------------------------------------- Filename | | Description ---------------+---+------------------------------------------------------- install.exe | ! | MiKTeX installation utility unzip.exe | ! | Unzip utility (by Info-ZIP) --------------------------------------------------------------------------- Files marked with '!' are absolutely necessary. The others are optional. If you already have a comprehensive TeX directory tree (such as a TeX Live 2 CD), then it should be enough to download the essential files. You don't need to download SRC108.ZIP unless you want to re-compile MiKTeX (you then need M$ Visual C++ 5.0 Pro). Installation ************ 1. Make sure that you have the necessary files (see previous section). 2. Choose a name for the root TEXMF directory, say C:\TEXMF. Please note, that due to a bug in Unzip 5.31, you cannot choose a UNC path here. Work-around: Use a non-UNC path for installation. Later you can redefine the root directory with the help of the Configuration Utility. 3. Decide whether you want to use pre-existing TEXMF trees (such as a shared teTeX directory hierarchy). 4. Don't install MiKTeX 1.08 over an older MiKTeX version. If you have an old version, then you should remove it (after you have saved you local additions). 5. Invoke INSTALL.EXE. 5.1 When prompted for the destination directory, enter the name chosen in step 2. 5.2 When prompted for the root directories of other TEXMF trees, enter a semicolon-separated list of existing TEXMF root directories. Enter nothing, if you just want to use the TEXMF tree that comes with MiKTeX. For example, if your workstation is connected to a shared teTeX directory, then you can enter its UNC name (e.g. \\SERVER\TETEX). If you have a TeX Live 2 CD, then you can enter X:\SHARE\TEXMF (replace X with the CD-ROM drive letter). 6. Add the MiKTeX bin directory to the environment variable PATH. Under Windows 95 you have to append something like set PATH=c:\texmf\miktex\bin;%PATH% to your AUTOEXEC.BAT. Under Windows NT you can use Control Panel to change the value of PATH. 7. Restart Windows. Example Installation -------------------- Here comes the transcript of a standard installation procedure. C:\TEXMF is the destination directory. No additional TEXMF trees will be incorporated. +------------------------------------------------------------------+ | C:\temp> install | | Welcome to MiKTeX 1.08 Installation Utility. This program will | | install MiKTeX 1.08 on your system. | | | | MiKTeX 1.08 will be installed in `c:\texmf'. | | | | To install to this directory, press . | | | | To install to a different directory, enter the name of another | | directory. | | | | You can choose not to install MiKTeX 1.08. Enter `cancel' to | | cancel the installation. | | | | Destination Directory: c:\texmf | | | | You can cause MiKTeX to incorporate additional TEXMF trees. | | To do so, enter a semicolon-separated list of directory names. | | Press , to use nothing but the TEXMF tree that comes | | with MiKTeX. | | | | Incorporate other TEXMF trees: | | | | Installing AMS-Fonts... | | Installing AMS-LaTeX... | | Installing Babel system... | | Installing Generic BibTeX input files... | | Installing Computer Modern fonts... | | Installing Generic dvips input files... | | Installing EC fonts... | | Installing intel-based executables, part 1/2... | | Installing intel-based executables, part 2/2... | | Installing LaTeX2e base distribution... | | Installing Generic METAFONT input files... | | Installing Essential MiKTeX files... | | Installing Various input files... | | Installing Generic MakeIndex input files... | | Installing Generic MetaPost input files... | | Installing PostScript fonts for LaTeX2e... | | Installing Various LaTeX packages... | | Installing Generic TeX input files... | | Installing Texinfo input files and documentation... | | Installing PK font files for the screen... | | | | Writing file name data base... | | | | Checking that the installation worked: | | | | 1. Invoking TeX... | | | | This is TeX, Version 3.14159 (MiKTeX 1.08) | | (test.tex [1] ) | | Output written on test.dvi (1 page, 484 bytes). | | Transcript written on test.log. | | | | 2. Opening DVI file... | | | | Installation is complete. Please append `c:\texmf\miktex\bin' to | | the environment variable `PATH' and reboot the system. | +------------------------------------------------------------------+ Configuring dvips ***************** Dvips is configured as follows: a) When generating fonts, Dvips uses METAFONT mode ljfour (HP Laserjet 4). b) Horizontal resolution is 600 dpi. c) Paper size is A4. If these settings are not suitable for your printer, then you have to edit the Dvips configuration file CONFIG.PS. You will find this file in the directory C:\TEXMF\DVIPS\CONFIG\LOCAL. See the Local Guide, for more information. Where are the docs? ******************* The Local Guide is available in HTML/WinHelp format: c:\texmf\doc\miktex\miktex.html c:\texmf\doc\miktex\miktex.hlp For up-to-date information, visit the MiKTeX project page: http://www.snafu.de/~cschenk/miktex Copying ******* MiKTeX is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. No warranty *********** MiKTeX is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with MiKTeX; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. -- Christian Schenk