Changes

Jump to navigation Jump to search
1,300 bytes removed ,  15:44, 6 February 2008
update the info a bit
< [[Installation]] | [[New ConTeXt Minimals (Implementation)]] >
http://minimals''(This page will probably loose the adjective "new" at some point.contextgarden.net)''
The ''New 'Minimals''' are an attempt to provide the same functionalities functionality as the current [http://www.pragma-ade.com/download-1.htm Pragma's minimal zip ConTeXt distributions. They are currently hosted on ] in the contextgarden.net server (the same one as this wiki)zip files.
Everyone is invited They are hosted on http://minimals.contextgarden.net (equivalent to test this distribution, but is kindly asked for patience and understanding until we tidy up the details'''rsync://contextgarden.net/minimals/''').
Below Everyone is a manifest of the goals of the projectinvited to test this distribution, but is kindly asked for patience and understanding until we tidy up the way we want details. You need to achieve themhave '''rsync''' installed, for windows it's shipped together with the minimals= Goals =
We wanted to provide:
* Windows
* Linux
* Linux, 64 -bit
* Mac OS X Intel
* Mac Os OS X PPCppc
* (Solaris)
* other platforms on request (please send a mail to the ntg-context mailing list)
= Installation =
== First Installation == The needed files are under:* http://minimals.contextgarden.net/setup/Well, to be honest, all you need to run it on linux/mac is done by this script (the rest of files will be downloaded autematically):* http://minimals.contextgarden.net/setup/linux/first-setup.sh (<code>mtxrsync -av rsync://contextgarden.net/minimals/setup/linux/first-updatesetup.sh .lua</code> which is already part of ConTeXt. If you already have )Take a working installationlook at it, modify it if needed and run it. On Windows you should be able to use it through can either take that command-line version from the generic <code>mtxrun<zip or* [http://minimals.contextgarden.net/setup/code>: [actually this is a little lie for the moment; even the most recent mtxcontext-updateinstaller/ContextMinimalInstall.lua needs to be updated itself in order for the process to workexe Vyatcheslav's Windows Installer].with a GUI
mtxrun --It will download about 200 MB. '''Please note that the location or name of that simple installation script update --platform=<your platform> --engine=<may change!''' ''(It's a TeX engine> --texroot=<install dir> --updatereally stupid one, one could also call it a prototype.)''
Platform can be ''win'', ''linux'', ''linux-64'', ''osx-ppc'', ''osx-intel'' or ''sun'' (default: ''win'');engine can be ''pdftex'', ''xetex'', ''luatex'', ''all'', or a comma-separated list of any of those (default: ''all''). If you want to specify a list of engines, you would have to protect it on most shells: <code>--engine='xetex, luatex'</code>, for example. TeX root, obviously, is the location of your installation (the directory where texmf trees like texmf, texmf-local, etc. are to be found), default: ''tex'' (relative to the current directory).= Updating ==
Most of For now, the task of main recipe to update is to run <code>mtxfirst-updatesetup</code> is again. A command similar to run <code>rsyncctxtools --updatecontext</code> to synchronize your local installation with the repository. It is assumed that Unix users (including Mac OS X) would have an rsync client installed by default on their system; for Windows an rsync binary is might be provided as part of in the initial setup (see next paragraph)future.
If you ''don't'' have an installed ConTeXt distribution, you must download from http://minimals.contextgarden.net/setup/ the appropriate zip archive for your system, and run the shell / batch script in the top-level directory (which should be called <code>context</code>); it is a very simple script that sets the necessary environment to run mtx-update, and it accepts exactly the same switches as mtx-update. By default it will install a ConTeXt distribution suitable for pdfTeX on your system; the top-level directory for that distribution will be <code>context/tex</code> until you tell it otherwise (with the <code>--texroot</code> switch).
The rest of this section is a manifest of how we would like things to work (most of it is already done!)= TODO =
This is a description of how the first installation and any subsequent updates should work (or how it would be nice if they worked that way):
 
One should be able to download <code>setup.zip</code> (approx. 2MB) which would download all the other things (selected engines, fonts, modules, ...) on demand. It should contain:
* some really basic documentation (README, INSTALL)
* setup script
* texmf-[os]/bin/luatex + texlua symbolic link
* ... [finishme]
We need to:
* create files <code>README INSTALL</code>
* create a file <code>minimals.lua</code> (or some other self-explanatory name):
** <b>rsync location</b> (default: <code>rsync://contextgarden.net/minimals</code>, could be anything)
** ??? <b>installation location</b> (default is simply the current location (<code>pwd</code>))
** <b>engines</b> (default: all - pdftex, xetex, luatex, metapost)
** <b>formats</b> (default: english + dutch context for all the installed engines, metapost, metafun; optional: other interfaces, plain pdftex, xetex)
** <b>fonts</b> (need to be reorganized/improved anyway, perhaps a list of fonts should be fetched)
** once in the future: <b>supported font encodings for pdftex</b> (default: texnansi, ec, optional: greek, t5, t2a, t2b, t2c, ...)
** <b>third party modules</b> (list needs to be fetched form the garden, default)
** <b>context version</b> (default: current, other options: beta, highly-experimental (for "Hans-and-Taco-only"), specific-date <font color="red">in the case of a fixed version issue a warning at next update</font>)
** <b>interactive flag</b>: shoud the script ask for changes interactively again or should it simply reaspect & use them (defaut: interactive for the first time, after that automatic)
* create a file <code>context-minimals-seetings.lua</code> (or some other self-explanatory name):*** <b>rsync location</b> (default: <code>rsync://contextgarden.net/minimals</code>, could be anything)*** ??? <b>installation location</b> (default is simply the current location (<code>pwd</code>))*** <b>engines</b> (default: all - pdftex, xetex, luatex, metapost)*** <b>formats</b> (default: english + dutch context for all the installed engines, metapost, metafun; optional: other interfaces, plain pdftex, xetex)*** <b>fonts</b> (need to be reorganized/improved anyway, perhaps a list of fonts should be fetched)*** once in the future: <b>supported font encodings for pdftex</b> (default: texnansi, ec, optional: greek, t5, t2a, t2b, t2c, ...)*** <b>third party modules</b> (list needs to be fetched form the garden, default)*** <b>context version</b> (default: current, other options: beta, highly-experimental (for "Hans-and-Taco-only"), specific-date <font color="red">in the case of a fixed version issue a warning at next update</font>)*** <b>interactive flag</b>: shoud the script ask for changes interactively again or should it simply reaspect & use them (defaut: interactive for the first time, after that automatic) * create a file improve <code>first-setup(.sh, .bat)</code> (or with some other self-explanatory name), which:
** checks if rsync exists (if not, an error is issued, saying <code>please install rsync first</code>)
** checks for perl and ruby and issues a similar error/warning (in fact, we can still proceed to the next step and download things even if perl & ruby are not installed, but that doesn't make much sense)
** detects the platform (straightforward for windows, for unix-like platforms the same kind of detection is used as later in <code>setuptex</code>)
** does rsync to installation files themselves (in case mtx-update has changed in the mean time)
** reads in <code>context-minimals-seetings.lua</code> (which engines, formats, fonts, modules to download ...) if interactive is set to true, ask for default settings again, otherwise respect those settings and continue
** asks for installation location
** creates (or updates) the file with settings (if interactive)
** create formats
** suggest what to put into <code>.bash_profile</code> (or equivalent locations) to have context initilized automatically
 
* add unzip for windows
= Binaries =
* dvipdfmx
* dvips
 
=== Windows-only ===
''Additional standard tools, such as unzip etc. TODO.''
= ConTeXt =
There's a plan to The Minimals provide three several versionsof ConTeXt:
* stable
* beta(suggested for living-on-the-edge ones; will default to stable if not available)* broken alpha (rarely used; will use beta if not available)* experimental (only for Hans, Taco and nerds onlytesting - not meant for general use)And * date-based ones (currenty only a plan few versions available - planning to provide possibility improve)You can use --context=XXXto revert back to an older stable get the desired version. TODO.
= Fonts =
= Hans's requests =
* upload rsync binaries from Delta (minimals/rsync/windows)
* reorganize fonts into fonts/data/e-foundry/texgyre/<everything>
* list directory contents
''Ein Teil von jener Kraft, / Die stets das Böse will, und stets das Gute schafft.'' <code>:-)</code>
 
 
[[Category:Installation]]

Navigation menu