Changes

Jump to navigation Jump to search
59 bytes removed ,  22:36, 13 January 2013
no edit summary
 
== Introduction ==
setting up and maintaining [[Mark IV]].
The most important motivation for this page is that the [[TeX Live]] 2008 edition contains Mark IV, but it is only copied to the installed system, no post-install setup takes place at all. For this Tex Live release, the post-install setup has to be done manually. TeX Live 2009 does notcome with a usable Mark IV at all because the luatex on the 2009 editions is too old. Instructions on how to deal with TeX Live 2009 will be added soon.== History ==
If you have trouble following these instructionsThe most important original motivation for this page was that the [[TeX Live]] 2008 edition contained Mark IV, but it was only copied to the installed system, no post-install setup took place at all. For the Tex Live 2008 release, please direct you questions or complaints the post-install setup had to be done manually. TeX Live 2009 did not come with a usable Mark IV at all because the luatex on the 2009 editions was too old compared to the ConTeXt version. Instructions on how to deal with TeX Live 2009 were needed then. TeX Live 2010 has a working Context Mark IV out of the [httpbox://wwwyou can just run 'context' directly.ntg.nl/mailman/listinfo/ntg At most, you could run `luatools --generate; context ntg-context mailing list]-make` to deal with any tlmgr updates you may have performed since installing TeX Live.  In TeX Live 2011, not even that is needed and you only have to run `mtxrun --generate` when files are installed manually ''outside'not''' the tex-live listof tlmgr. If you are running tl 2011, this page is just background information, there should be no need to take actual actions.
=== Special notes (TL 2008/2009): ===
Special notes:
* '''Windows''': Running Mark IV under Windows is the same as on Unix, but see [[Running_Mark_IV#In_case_of_trouble|below]] for a installation hints for the 'spaces in names' problem that seem to affect Windows users more often than other platforms.
 
* '''Debian''': Mark IV suggests the tex-gyre package ([[TeX Gyre]]), not distributed currently under Debian due to licensing issues (see [[Debian installation]] )
 
=== Special notes (TL 2010): ===
 
* '''[[MacTeX]]''': You need to [[Running_Mark_IV#Updating_ConTeXt|update]] ConTeXt first.
* '''Debian''': Mark IV suggests the tex-gyre package ([[TeX Gyre]]), not distributed currently under Debian due to licensing issues (see [[Debian installation]] )
== Quickstart ==
 
If you have trouble following these instructions, please direct you questions or complaints on the [http://www.ntg.nl/mailman/listinfo/ntg-context ntg-context mailing list], '''not''' the tex-live list.
Just for the extremely impatient unix user that knows how to deal with a web2c-based TeX distribution and has a simple, private (single-user) installation, this is the only absolutely required extra knowledge:
luatools --generate # 2010 and earlieror mtxrun --generate # 2011
is the Mark IV replacement for mktexlsr.
Everybody else should read on.
'''A note for windows users:(tl2008/2009)''' the luatex executable doest does not accept filenames with spaces in their name. This means that if you are on windows you will at least have to set up a texmfcnf.lua as explained below, and you likely will even have to reinstall texlive, because the default texlive installation directory itself contains spaces. [[Running_Mark_IV#File_not_found | Details]].
== Updating ConTeXt Generating and updating formats ==
Updating is not absolutely necessary unless you Before first use and after each update to either the [[MacTeXcontext]], but most MKIV users distribution or the [[luatex]] executable you will probably want have to play with latest & greatest featuresregenerate the formats.The manual command for that is:
There's a work context -in-progress to create a TL repository on the garden with the latest ConTeXt and LuaTeX, so that TeX Live users should be able to upgrade ConTeXt automatically.make cont-en
Until then you can update ConTeXt in different waysThis will generate a new Mark IV format with the English interface. Without an explicit format argument, for example withit will generate four formats: rsync Mark IV cont-en, Matk IV cont-av rsync://contextgardennl, luatex+mptopdf, and luatex+plain.net/minimals/current/context/current/ /usr/local/texlive/2008/texmf-dist/
To update LuaTeX you may use the following line Starting with 2011, formats are automatically (depending on your platformre): rsync -av rsync://contextgardengenerated by `context myfile.net/minimals/current/bin/luatex/<i><font color="#F00">platform-garden</font></i>/bin/luatex \ /usr/local/texlive/2008/bin/<i><font color="#F00">platform-TL</font></i>/Which resolves tex` when it believes it is necessary to one do so. Specifically: assuming the format already exists, automatic regeneration takes places whenever the ConTeXt version of the following lines: rsync -av rsync://contextgarden.net/minimals/current/bin/luatex/freebsd/bin/luatex /usr/local/texlive/2008/bin/i386version do not match the ones in the pre-freebsd/ rsync -av rsync://contextgardenexisting format.net/minimals/current/bin/luatex/linux/bin/luatex /usr/local/texlive/2008/bin/i386-linux/ rsync -av rsync://contextgarden.net/minimals/current/bin/luatex/linux-64/bin/luatex /usr/local/texlive/2008/bin/x86_64-linux/ rsync -av rsync://contextgardenManual patches of the core files still require manual regeneration of the formats.net/minimals/current/bin/luatex/osx-universal/bin/luatex /usr/local/texlive/2008/bin/universal-darwin/
You can upgrade XeTeX or metapost in The generated formats are stored inside the same way as LuaTeXtexmf cache.
Of course you need to repeat all the steps mentioned above, for MKIV: luatools --generate context --makeand for MKII: mktexlsr texexec --make --all texexec --make --xtx --all== Experimental speedup ==
Note that this In addition to standard [[luatex]] we provide [[luajittex]] which uses just in time compilation to speed up processing. The speedup is a quick-and-dirty way mostly due to upgrade TLthe faster virtual machine. Use at your own risk. One should be able to update in a more elegant wayThe exact speedup depends on the tex/lua ratio and we measured speedups between 10% and 40%.You force this engine with
== Generating and updating formats == context --jit ....
Before first use and after each update to either the [[context]] distribution or the [[luatex]] executable Alternatively you will have to regenerate the formats. The command for that is:can put
context --make cont-en<texcode>% engine=luajittexThis will generate a new Mark IV format with the English interface. Without an explicit format argument, it will generate four formats: Mark IV cont-en, Matk IV cont-nl, luatex+mptopdf, and luatex+plain.</texcode>
The generated formats are stored inside the texmf cacheon top of your main document source.
== Using fonts ==
== In case of trouble ==
=== File not found (TL 2008/2009) ===
* You may get errors like
* You must put the main texmf tree in path without spaces. If you're installing Mark IV via TeXLive 2008, then simply change the top installation path at install time.
* If you're running XP or Server 2003 (and not Vista or Server 2008), you must also set the TeX user home and the Lua cache to paths without spaces. <code>C:/tlhome</code> is a good candidate.
** In <code>texmf.cnf</code> set HOMETEXMF TEXMFHOME to <code>C:/tlhome/$USERNAME</code> or to something similar of your liking. Using $USERNAME in the path will still give a per-user directory, just not under "Documents and Settings". This assumes that the user name doesn't have spaces of course...
** As mentioned above, create/edit <code>texmfcnf.lua</code> and put a line like <code>return { TEXMFCACHE = 'C:/tlhome/$USERNAME/.texlive2008/texmf-var' }</code>, which sets each user's cache inside his space-free TeX home path.
(this paragraph is for developers and power-users only)
If you look at the folder that TEXMFCACHE points to, you will see a folder named luatex-cache. Inside that, there is the folder context. Inside the context folder, there usually is a single subfolder with a hexadecimal name. This is the md5sum of the name of the 'tex root' folder location (aka SELFAUTOPARENTto be precise, it is the md5sum of the full path expansion of the context lua equivalent of the TEXMFCNF variable).  Below this, there are currently four folders:
* '''curl''' contains downloaded files. The url is converted to something that can be represented on disk by replacing problematic characters by dashes
* '''formats''' contains the Mark IV format file
* '''trees''' has a small set of files with hexadecimal names, one for each of the top-level constituents of TEXMF (containing the filename database for that tree), and one for each of the found texmf.cnf files (containing in preprocessed form all the variables defined by that file). The filenames are md5sums of the contained directory or filename.
 
 
[[Category:Installation]]
30

edits

Navigation menu