MiKTeX 2.0 Readme File

Copyright (C) 2000 Christian Schenk



MiKTeX Readme File

******************


   This is the MiKTeX 2.0 Readme File.


What is it

**********


   MiKTeX is a free TeX distribution for Windows.


Downloading the MiKTeX distribution

***********************************


   The download folder (i.e. the folder that contains this Readme file)

contains an HTML page named `index.html'.  The page contains links to

all downloadable files.  It is highly recommended that you open this

page with an Internet browser now.

   The MiKTeX distribution consists of the MiKTeX Setup Wizard

(`setupwiz.exe') and accompanying Zip files.  Download the components

(Zip files), that you want to install.  Download all components, if you

intend to redistribute MiKTeX.

`msdll.zip'

     Various dynamic link libraries by Microsoft.  It's highly

     recommended that you download this Zip file.

`lcore.zip'

     MiKTeX core distribution: shared libraries.

`xcore.zip'

     MiKTeX core distribution: executable files.

`core.zip'

     MiKTeX core distribution: non-executable files.

`latex.zip'

     LaTeX core distribution & Babel.  You should download this Zip

     file if you intend to use LaTeX and/or Babel.

`latexpkg.zip'

     Standard LaTeX packages.  You should download this Zip file if you

     intend to use LaTeX.

`urw.zip'

     URW PostScript fonts.  You should download this Zip file if you

     intend to use standard PostScript fonts.

`amslatex.zip'

     This component includes the AMS-LaTeX package and the AMS fonts.

     You should download this Zip file if you intend to typeset

     mathematics.

`cmps.zip'

     Computer Modern fonts in Type1 format.  You should download this

     Zip file if you intend to use pdfTeX and/or Dvipdfm.

`amsps.zip'

     AMS fonts in Type1 format.  You should download this Zip file if

     you intend to use pdfTeX and/or Dvipdfm and if you typeset

     mathematics.

`ecfonts.zip'

     This component includes the European Computer Modern Fonts and Text

     Companion Fonts.  You should download this Zip file if you write

     in an european language.

`dvipdfm.zip'

     This component includes Dvipdfm.  This utility converts DVI files

     into PDF files.  You should download the Zip file if you want to

     create PDF documents.

`metapost.zip'

     This component includes the MetaPost application.  MetaPost is a

     graphics language based on METAFONT, but with PostScript output.

`lhfonts.zip'

     This component includes LH fonts in various encodings.  You should

     download this Zip file if you want to typeset cyrillic texts.

`yandy.zip'

     This component includes support files for Lucida Bright and

     MathTime fonts.  Download this Zip file if you have these fonts.

`psutils.zip'

     Utilities for manipulating PostScript documents.  Some of these

     utilities require Perl.

`pdftex.zip'

     This component includes pdfTeX.  pdfTeX can be used to convert TeX

     documents into PDF documents.

`etex.zip'

     This component includes e-TeX.  e-TeX is a feature-enhanced

     version of TeX.

`pdfetex.zip'

     This component includes pdfeTeX.  pdfeTeX is a pdfTeX/e-TeX merger.

`texinfo.zip'

     This component includes the programs Makeinfo, Makertf and

     Texindex.

`eplain.zip'

     Extended Plain TeX macros.

`xomega.zip'

     Omega executables.  Omega is a unicode-enhanced version of TeX.

`omega.zip'

     Omega input files.

`source2.zip'

     This component includes the source code for the LaTeX2e packages

     included in MiKTeX.

`german.zip'

     This component includes files supporting german-language

     typesetting.

`polish.zip'

     This component includes files supporting polish-language

     typesetting.

   Every Zip file has a correspinding `.lst' file which shows the Zip

file's contents.


Installation Instructions

*************************


  1. You should first remove any previous MiKTeX installation:

        * MiKTeX 1.11 users can use the uninstall program.

        * MiKTeX 1.20 users must remove MiKTeX by hand.  See the Local

          Guide of version 1.20, for more information.

        * MiKTeX 2.0 users can use the uninstall program.

  2. Make sure that you have enough disk space.  A complete MiKTeX

     installation consumes approximately 70MB of disk space.

  3. It is highly recommended that you login as Administrator, if you're

     installing MiKTeX on a Windows NT/2000 computer.

  4. Choose a location for the installation folder (e.g. `C:\Program

     Files\MiKTeX').  This folder receives the files of the MiKTeX

     distribution.

  5. You can cause MiKTeX to deposit newly created files (fonts, format

     files, file name databases) in a separate hierarchy of folders,

     called the _Local TEXMF tree_.  If you decide to use a local TEXMF

     tree, then you must choose a location for its root folder (e.g.

     `C:\Local TeXMF').

     Benefits that a local TEXMF tree provides include the following:

        * You can use it for your own additions (macros, fonts).

        * Easier updates: You don't have to worry about future MiKTeX

          updates, since the local TEXMF tree wont be touched by the

          setup program.

  6. Decide whether you want to incorporate an existing TEXMF tree.  For

     example, if you have a TeXLive CD inserted in your CD-ROM drive

     `E:', then it would be possible to include `E:\texmf' (the root of

     the TeXLive TEXMF tree) in the MiKTeX search procedure.

  7. Start MiKTeX Setup Wizard (`setupwiz.exe').  You will presented

     with the welcome page:

  8. Click `Next>' to go to the next 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.

  9. Click `Next>' to go to the next page:

     Enter the full path to the desired installation folder (see step

     4).

 10. Click `Next>' to go to the next page:

     Choose the components that you want to install.

 11. Click `Next>' to go to the next page:

     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.

 12. Click `Next>' to go to the next page:

     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.

 13. Click `Next>' to go to the next page:

     You should now review the installation options.

 14. Click `Next>' to start the installation process.  The selected

     components will be copied to the installation folder chosen in

     step 9.

 15. When the files have been copied to your computer, you have the

     option to register the path to the MiKTeX bin directory:

 16. Click `Next>' to go to the final page:

     Click `Finish' to close Setup Wizard.

   It is possible to run the MiKTeX Setup Wizard in unattended mode.

See the Local Guide for more information.


Configuring dvips

*****************

   Dvips is configured as follows:

   * When generating fonts, Dvips uses METAFONT mode `ljfour' (HP

     Laserjet 4).

   * Horizontal resolution is set to 600 dpi.

   * Paper size is A4.

   * Dvips does not make use of the Computer Modern PostScript fonts.

   If these settings are not suitable for your site, then you have to

edit the Dvips configuration file `config.ps'.  You will find this file

in the directory `dvips\config' relative to the MiKTeX installation

folder (usually `C:\Program Files\MiKTeX').  See the MiKTeX Manual

(http://www.miktex.org/doc/manual/index.html), for more information.


Where are the docs?

*******************

   The MiKTeX Manual is available in a variety of formats:

  1. As a DVI document viewable/printable with Yap:

          C:\Program Files\MiKTeX\doc\miktex\miktex.dvi

  2. As a Windows Help file:

          C:\Program Files\MiKTeX\doc\miktex\miktex.hlp

  3. As an HTML document:

          C:\Program Files\MiKTeX\doc\miktex\miktex.html

  4. As a PDF file viewable with Acrobat Reader:

          C:\Program Files\MiKTeX\doc\miktex\miktex.pdf

   For up-to-date information, visit the MiKTeX Project Page

(http://www.miktex.org) (see below).


Mailing List

************

   There is a discussion list for MiKTeX.  To join the list, send an

email to <miktex-request@dsts.dk> which contains the word `subscribe'

as the first line in the message body.


MiKTeX Project Page

*******************

   Latest news are available on the MiKTeX Project Page:

   `http://www.miktex.org'


Copying

*******

   As far as I know, all components of the MiKTeX distribution are

freely redistributable, i.e. the whole MiKTeX distribution is freely

redistributable.


Disclaimer

**********

   The MiKTeX distribution comes with absolutely no warranty of any

kind.




