View source for Talk:ConTeXt Standalone

== Binary versions ==

Mojca, what is the linux kernel version?  There is a difference between binaries for 2.4.x and 2.6.x kernels. If ldd reports linux-gate.so, then it is a 2.6 binary and will not run on 2.4 kernels, regardless of glibc version. [[User:Taco|Taco]]

: Garden uses kernel 2.6. If anyone starts complaining about too new kernel, we should start seeking an older machine (or maybe create a virtual machine somewhere). --[[User:Mojca Miklavec|Mojca]] 11:42, 21 April 2008 (CEST)

== older content ==

Installation is done by the <code>mtx-update.lua</code> which is already part of ConTeXt. If you already have a working installation, you should be able to use it through the generic <code>mtxrun</code>: [actually this is a little lie for the moment; even the most recent mtx-update.lua needs to be updated itself in order for the process to work].

  mtxrun --script update --platform=<your platform> --engine=<a TeX engine> --texroot=<install dir> --update

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).

Most of the task of <code>mtx-update</code> is to run <code>rsync</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 provided as part of the initial setup (see next paragraph).

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).

== More older content ==

= Contents =

The minimals contain:
* '''ConTeXt''': current, beta + some older releases
* '''Fonts''': most important TeX-aware ones
* '''Binaries''': latest version of pdfTeX, XeTeX, LuaTeX, Metapost
* '''Formats''' (need to be generated by user) for
** ConTeXt, mptopdf and plain TeX for pdfTeX/XeTeX/LuaTeX
** metafun and plain for Metapost

See [[ConTeXt Minimals/Contents]].

= Configuration =

=== What to install ===
* --'''platform'''=''name-of-platform'' (see supported platforms; default: the one we are working on)
* --'''engines'''=''list-of-engines'' (options: luatex, xetex, pdftex, all; default: '''all''')
* --'''context'''=''version'' (options: current, beta, alpha, ''yyyy.mm.dd''; default: '''beta''')

=== What to do ===
* --'''force''' (as opposed to --dryrun; do the real thing; this is '''needed''') ''needs to be fixed''
* --'''update''' (update minimal tree)
* --'''make''' (make formats and generate file databases)
* --state (update tree using saved state) ''needs to be implemented/fixed''
* --keep (as apposed to --delete; don't delete unused or obsolete files) ''needs to be improved''
=== Where to install ===
* --'''texroot'''=''path'' (installation path; default: '''tex''')
=== Rsync Server ===
''(currently there's only one anyway)''
* --'''server'''=''repository-url'' (default: '''<code>rsync://contextgarden.net</code>''')
* --'''module'''=''string'' (default: '''minimals''')
* --'''rsync'''=''name-of-rsync-binary'' (default: '''rsync''') ''Why do we need this?''

See also [[ConTeXt Minimals/Implementation]].

== script cleanup ==

line 5 in first-setup.sh tells me:
<pre># feel free to suggest a more elegant solution</pre>
so i do.

<pre>if which rsync &> /dev/null; then
  echo "OK" > /dev/null
else
  echo "You need to install rsync first."
  exit
fi
</pre>
can be replaced with
<pre>
if [ ! -x "`which rsync`" ]; then
  echo "You need to install rsync first."
  exit 1
fi
</pre>

or (as there is another such test below):
<pre>
check_and_complain () {
  if [ ! -x "`which $1`" ]; then
    echo "You need to install $1 first."
    exit 1
  fi
}
check_and_complain rsync
check_and_complain ruby
</pre>

Tobias Florek (w/o user account)

== Ruby version ==

On that recent change to ruby 1.8 '''or newer''': has this actually been tested? Last I remember, there were big problems with ruby 1.9 because it is not upward compatible with ruby 12.8 sources [[User:Taco|Taco]] 14:32, 8 May 2010 (UTC)
: I have no idea. I have 1.8 here and I'm not sure if I want to mess with my system. The user from Lithuania(?) who wrote that did not login, so maybe he wrote "or later" just because this usually is the case with programming languages. I have no idea to what extent the incompatibility goes. --[[User:Mojca Miklavec|Mojca]] 12:27, 10 May 2010 (UTC)

:: Hans says that it "should" work [[User:Taco|Taco]] 12:39, 10 May 2010 (UTC)

== Contextwriter: mac links ==

There are a great many links to the internet that are potentially useful to people that have trouble handling their own computer, but those are not on topic for this wiki. Please don't add 'how to use your Apple' links on ConTeXt specific pages, it clutters the wiki with off-topic information. [[User:Taco|Taco]] 08:48, 11 August 2010 (UTC)

: Actually, I thought for a moment that you were a commercial spammer because you don't have a user page and were posting links to external sites. If you really '''must''' have Mac-specific links on this wiki, please add them to [[Mac Fix]], that page seems to contain more of that. [[User:Taco|Taco]]