Changes

Modules are extensions to ConTeXt's ConTeXt’s core functions.

There are not as many modules for ConTeXt as packages for LaTeX, because ConTeXt’s core already contains a lot of LaTeX that needs a package features are in ConTeXt's coreLaTeX.

but their existence depends on the TeX distribution; among these, texmf-local is the most common.

When you want to install a new single-file module which is available as file only , createthe subdirectories in the way described above and place the file there, formodules which are available as zip files with pre-created subdirectories youcan unzip the archive in the top-level directory (e.g. texmf-local/) and allfiles are on the correct place.

After the Most modules consist of several files though and are placed at distributed as ZIP archives that contain the right place necessary TDS tree.These you have to update TeX's databaseto let it know where it can find unzip in the top-level directory (e.g. texmf-local/), and all files, this is done for MkII withshould be in the correct place.

mktexlsr (command name depends on After the TeX distribution) and for MkIV withfiles are installed, you must update ConTeXt’s database to let it know where it can find the files:

==(ConTeXt standalone==doesn’t use `ls-R` files or `kpsewhich` any more.)

Users of the ConTeXt standalone ==Installation by script (formerly "minimals"LMTX) distribution don't have to download the module files and unzip them in the local directory, because they can use the <tt>first-setup</tt> script for this.==

To As of 2023-05-07, there’s a script for `mtxrun` to list and install for example modules, usually from https://modules.contextgarden.net. Some modules, get special treatment: For the simpleslides [[TikZ]] modules you writefiles are downloaded from CTAN and patches for incompatibilities are applied.

firstmtxrun -setup.sh -script install-modules="t-simpleslides"-list

To mtxrun --script install more -modules at the same time write--install --all

firstPreviously, the ConTeXt LMTX distribution did not provide a built-setupin way to install or update modules. Here’s a method using `rsync`, to be run from the toplevel directory of the ConTeXt LMTX distribution, i.e. the directory that contains <tt>install.sh --modules="t-simpleslides,t-french"</tt>.

The complete list Because the final <tt>tex/texmf-modules</tt> must contain the union of availables all individual module directories, the commands create and leave an intermediate <tt>modules in standalone is:</tt> directory that wastes less than 50 MB.

* [http://modules.contextgarden.net/account t-account] draw T-accounts* [http://modules.contextgarden.net/algorithmic t-algorithmic] like LaTeX algorithmic* [http://modules.contextgarden.net/animation t-animation] create animations* [http://modules.contextgarden.net/annotation t-annotation] todo lists* [http://modules.contextgarden.net/t-bnf t-bnf] BNF grammar* [http://modules.contextgarden.net/chromato t-chromato] chromatograms* [http://modules.contextgarden.net/cmscbf t-cmscbf] bold small caps* [http://modules.contextgarden.net/cmttbf t-cmttbf] bold typewriter* [http://modules.contextgarden.net/t-construction-plan t-construction-plan] figures with defined scale* [http://modules.contextgarden.net/t-degrade t-degrade] degrading JPEG images* [http://modules.contextgarden.net/fancybreak t-fancybreak] thought breaks* [http://modules.contextgarden.net/filter t-filter] run external programs on inline code* [http://modules.contextgarden.net/fixme t-fixme] like LaTeX fixme* [http://modules.contextgarden.net/t-french t-french]* [http://modules.contextgarden.net/fullpage t-fullpage]* [http://modules.contextgarden.net/games t-games] board games* [http://modules.contextgarden.net/gantt t-gantt] Gantt charts* [http://modules.contextgarden.net/gnuplot t-gnuplot] include GNUplot graphics* [http://modules.contextgarden.net/t-layout t-layout]* [http://modules.contextgarden.net/letter t-letter] formal letters* [http://modules.contextgarden.net/t-lettrine t-lettrine] decorative paragraph starts (initials)* [http://modules.contextgarden.net/t-lilypond t-lilypond] include musical scores with GNU LilyPond* [http://ctan.org/pkg/markdown t-markdown] render markdown documents* [http://modules.contextgarden.net/mathsets t-mathsets] mathematical sets, probabilities etc.* [http://modules.contextgarden.net/pararef t-pararef] {{cmd|startParagraph|link=no}}, for paragraphs as ‘thought blocks’ that may contain more than one 'TeX paragraph'. These paragraphs are numbered and can be referenced. See [[Paragraph Referencing]].* t-pgfplots* [http://modules.contextgarden.net/ruby t-ruby] Ruby markup (for Chinese, not programming language)* [http://modules.contextgarden.net/simplefonts t-simplefonts] simplified font mechanism* [http://modules.contextgarden.net/simpleslides t-simpleslides] presentations* [http://modules.contextgarden.net/typearea t-typearea] like LaTeX/KoMa typearea* [http://modules.contextgarden.net/typescripts t-typescripts] collection of typescripts* [http://modules.contextgarden.net/urwgaramond t-urwgaramond]* [http://modules.contextgarden.net/urwgothic t-urwgothic]* [http://modules.contextgarden.net/vim t-vim] syntax highlighting using vim’s syntax files (some of these are obsolete...) ==ConTeXt LMTX== As of 2020-06-06, the ConTeXt LMTX distribution does not provide a built-in way to install or update modules. However, (something like) the following can be used to install and update all modules together with the rest of the distribution. The snippet must be run from the toplevel directory of the ConTeXt LMTX distribution, i.e. the directory that contains <tt>install.sh</tt>. Because the final <tt>tex/texmf-modules</tt> must contain the union of all individual module directories, the snippet creates and leaves an intermediate <tt>modules</tt> directory in the toplevel directory of the ConTeXt LMTX distribution. There may be a more clever way of using <tt>rsync</tt>, that does not need an intermediate directory. On the other hand, as of 2020-06-06, only 37MB of space are wasted.  # Transfer all modules from the ConTeXt Garden. # # No -p (--perms) is given to rsync, because, as of 2020-06-06, many # files (e.g. all files in # modules/t-letter/tex/context/third/letter/style) would come out # world-writeable, which may pose a significant security risk on a # multi-user system. # # The --chmod=D755,F644 may not be necessary. However, as of # 2020-06-06, without it files come out with executable bits set. rsync -rltsv --new-compress --delete --chmod=D755,F644 \ rsync://contextgarden.net/minimals/current/modules/ \ modules # Recreate tex/texmf-modules as an empty directory. WARNING: This # assumes that you have nothing but modules from ConTeXt Garden in # tex/texmf-modules. rm -rf tex/texmf-modules mkdir -p tex/texmf-modules # Create the union of all modules in tex/texmf-modules. for module in modules/* ; do rsync -rlts --exclude=/VERSION ${module}/ tex/texmf-modules done # Update the ConTeXt LMTX distribution. Alternatively, if you do not # want to do that, you have to run mtxrun --generate. sh ./install.sh Here is a simplified version of this procedure, tested with MacOS 10.15 on 2020-12-12. There doesn't seem to be any perm issues anymore.   # Synchronize all modules from the ConTeXt Garden in the directory 'modules'directory, which is created if it doesn't doesn’t exist.

# Create the union of all modules in tex/texmf-modules (the directory is created if it doesn't doesn’t exist). # If you have personal modules in tex/texmf-modules, they won't won’t be modified.

# You may delete the 'modulemodules's directory to reclaim some space or keep it to speed up the next update.

# Update the ConTeXt LMTX distributionfile database. # Alternatively, if you do not want to do that, you have to run mtxrun --generate  ==Installation by script (MkIV) == Users of the ConTeXt MkIV standalone can use the <tt>first-setup</tt> script to install modules: E.g. to install the simpleslides modules: sh ./installfirst-setup.sh--modules="t-simpleslides"

TeX Live is a large TeX distribution for most Linux and BSD based common operating systems. It provides binaries and many other files necessary to run TeX and its flavors. Many ConTeXt modules are included.

* m-modulaname modulename (core module)

* t-modulename ("Third party " contributed module)

Once a file is found , ConTeXt stops the search and loads the found file (only once).

When you have two file files with the same name but different prefixes , you can tell ConTeXt which file it should load with

For a list of contributed modules see [http://tlcontrib.metatex.org/ tlcontrib] and/or [http://modules.contextgarden.net the modules section] on contextgarden.net.:

* [http://modules.contextgarden.net/account t-account] draw T-accounts* [http://modules.contextgarden.net/algorithmic t-algorithmic] like LaTeX algorithmic* [http://modules.contextgarden.net/animation t-animation] create animations* [http://modules.contextgarden.net/annotation t-annotation] todo lists* [http://modules.contextgarden.net/t-bnf t-bnf] BNF grammar* [http://modules.contextgarden.net/chromato t-chromato] chromatograms* [http://modules.contextgarden.net/cmscbf t-cmscbf] bold small caps* [http://modules.contextgarden.net/cmttbf t-cmttbf] bold typewriter* [http://modules.contextgarden.net/t-construction-plan t-construction-plan] figures with defined scale* [http://modules.contextgarden.net/t-degrade t-degrade] degrading JPEG images* [http://modules.contextgarden.net/fancybreak t-fancybreak] thought breaks* [http://modules.contextgarden.net/filter t-filter] run external programs on inline code* [http://modules.contextgarden.net/fixme t-fixme] like LaTeX fixme* [http://modules.contextgarden.net/t-french t-french]* [http://modules.contextgarden.net/fullpage t-fullpage]* [http://modules.contextgarden.net/games t-games] board games* [http://modules.contextgarden.net/gantt t-gantt] Gantt charts* [http://modules.contextgarden.net/gnuplot t-gnuplot] include GNUplot graphics* [http://modules.contextgarden.net/t-layout t-layout]* [http://modules.contextgarden.net/letter t-letter] formal letters* [http://modules.contextgarden.net/t-lettrine t-lettrine] decorative paragraph starts (initials)* [http://modules.contextgarden.net/t-lilypond t-lilypond] include musical scores with GNU LilyPond* [http://ctan.org/pkg/markdown t-markdown] render markdown documents* [http://modules.contextgarden.net/mathsets t-mathsets] mathematical sets, probabilities etc.* [http://modules.contextgarden.net/pararef t-pararef] {{todocmd|startParagraph|list link=no}}, for paragraphs as ‘thought blocks’ that may contain more than one 'TeX paragraph'. These paragraphs are numbered and can be referenced. See [[Paragraph Referencing]].* t-pgfplots* [http://modules or none .contextgarden.net/ruby t-ruby] Ruby markup (for Chinese, not programming language)* [http://modules.contextgarden.net/simplefonts t-simplefonts] simplified font mechanism* [http://modules.contextgarden.net/simpleslides t-simpleslides] presentations* [http://modules.contextgarden.net/typearea t-typearea] like LaTeX/KoMa typearea* [http://modules.contextgarden.net/typescripts t-typescripts] collection of them}}typescripts* [http://modules.contextgarden.net/urwgaramond t-urwgaramond]* [http://modules.contextgarden.net/urwgothic t-urwgothic]* [http://modules.contextgarden.net/vim t-vim] syntax highlighting using vim’s syntax files

While a module usually consists of one main file with a name like <tt>t-modulename.[tex|ctx|mkiv|mkxl]</tt>, there can be many more files, and there should be some documentation. Please sort adhere to the filename convention outlined in [#Usage]. Sort these files in into folders according to TDS (TeX directory structure) – just have a look at the distribution. BTW <tt>t-</tt> is for “third party” modules, that means everything that isn’t part of the distributionto understand what goes where.

* The filename should be <code>t-modulename-version.zip</code>, where the version is usually an a date like <tt>YYYY.MM.DD</tt> (but that’s up to you).

In order to avoid ''conflicting macros'' it is essential for a module that it adhere adheres

arguments that a macro accepted by macros defined in the module accepts. 

By default, this places a frame around the setup. If you want to get gray background, as in the context ConTeXt documentation, add the followinga setup like:

Apart from the existing XML files in the ConTeXt tree , there is little

[https://bitbucket.org/wolfs/simplefonts/src ''simplefonts'']module you first have to `chdir ` to the <tt>files</tt> subdirectory of

* Create a '''new module''' entry with a distinct name (e.g. prettyprinter“prettyprinter”) and fill in the metadata:

** Check Put “Put in download section section” (yes please, allows installation by rsync)** Check Put “Put in ConTeXt distribution distribution” (not sure if this works)** Check Synch “Synch with CTAN CTAN” (yes please, makes it visible)