FAQ: installing

FAQ: installing

[Henning Hraban Ramm]

I will publish my tutorial sources and PDF about next weekend, but everything 
in german...
Now, for the moment:

NEEDS:
-- new pdfTeX (version >0.14h, best >=1.0pre)
-- Perl (e.g. ActivePerl from ActiveState.com)
-- newest ConTeXt-Beta (only cont-tmf.zip)

(if you'd like to choose a TeX distribution, take fpTeX (= TeX Live) --
it's a bit faster and better suitable for ConTeXt.)

INSTALLATION:
1. unpack cont-tmf.zip in some "other" texmf tree
   (e.g. texmf-var, texmf-local)

on Linux/Unix:
2. mark the perl scripts in context/perltk as executable
3. make symlinks in the TeX binary directory to this perl scripts
   (on teTeX there are sometimes older scripts directly in the bin dir,
   delete them. symlinks will work even after an update!)

on Windows:
2. unpack runperl.zip. copy runperl.exe to "everyscript".exe 
   (texexec.exe etc.), so Perl becomes run by the simple call of the 
   script name.
3. add the script's path to the PATH (Control Panels, System, Environment)

4. update the kpathsea database: "mktexlsr" = "texhash"

5. adapt the config files:

5a: copy context/config/texexec.rme to texexec.ini
    enable your TeX distribution (set TeXShell to fpTeX)
    You may want to adapt more options, but it's not needed.

5b: copy tex/context/user/cont-sys.rme to cont-sys.tex
    uncomment "\autoloadfilemapstrue"
    uncomment "\usetypescript[map][\defaultencoding]"
    uncomment the three lines "\runMPgraphicstrue" and following
    uncomment "\useMETAFUNformattrue" and "\protextbufferstrue"
    i suggest to add "\setupoutput[pdftex]" for default PDF output
    you may leave the other options as they are

5c: pdftex/config/pdftex.cfg:
    comment all "map" lines ("# map psfonts"), if you only use ConTeXt

5d: ???/texmf.cnf (e.g. /etc/texmf/texmf.cnf or web2c/texmf.cnf)
    make sure that you "other" texmf tree is named in the 
    appropriate variables
    make sure "shell_escape = t" (ConTeXt needs \write18)

5e: ???/fmtutil.cnf:
    uncomment all lines that start with "cont-"
    make sure these lines look like
    "cont-en  pdfetex  cont-usr.tex  *cont-en.ini"

6. make sure the environment var TEXMFCNF points to the location of texmf.cnf

7. update the kpathsea database: "mktexlsr" = "texhash"

8. try if "texexec --verbose" gives a long list of variables or only 
   an short error message

9. if 8. works, you can make the formats:
   "texexec --make"  (not more needed, if UsedInterfaces set in texexec.ini)
   if it doesn't work, try to add --alone, then fmtutil isn't called.

10. rebuild ls-R: "texhash"

11. test installation: "texexec --verbose"

YOUR FIRST FILES:

\enableregime[windows] % 8-bit input
\mainlanguage[nl]      % if you don't use english
\setupencoding[default=texnansi] % otherwise problems with some chars
\setupbodyfontenvironment[default][em=italic] 
% otherwise you get ugly slanted for \em

\starttext
etc.
\stoptext

Grüßlis vom Hraban!
Greetlings from the Raven!