Changes

==Installation==

===Basics===

===Installation by hand===

===ConTeXt minimals=standalone==

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

first-setup.sh --extrasmodules="t-simpleslides"

first-setup.sh --extrasmodules="t-simpleslides,t-french"

The complete list of availables modules in minimals standalone is:

* [http://modules.contextgarden.net/account t-urwgaramondaccount] draw T-accounts* [http://modules.contextgarden.net/algorithmic t-accountalgorithmic] like LaTeX algorithmic* [http://modules.contextgarden.net/animation t-animation] create animations* [http://modules.contextgarden.net/annotation t-algorithmicannotation] 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-frencht-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-pgfplotstable* [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-urwgaramondtypescripts] collection of typescripts* [http://modules.contextgarden.net/urwgaramond t-vimurwgaramond]* type[http://modules.contextgarden.net/urwgothic t-urwgothic]* type[http://modules.contextgarden.net/vim t-urwgaramondvim] syntax highlighting using vim’s syntax files (some of these are obsolete...) ==ConTeXt LMTX==

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 ${{Note | description required}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' which is created if it doesn't exist. rsync -rltv --del rsync://contextgarden.net/minimals/current/modules/ modules # Create the union of all modules in tex/texmf-modules (the directory is created if it doesn't exist). # If you have personal modules in tex/texmf-modules, they won't be modified. rsync -rlt --exclude=/VERSION --del modules/*/ tex/texmf-modules # You may delete the 'module's directory to reclaim some space or keep it to speed up the next update. # rm -rf modules # Update the ConTeXt LMTX distribution. Alternatively, if you do not # want to do that, you have to run mtxrun --generate. sh ./install.sh  ==TeX Live== TeX Live is a large TeX distribution for most Linux and BSD based operating systems. It provides binaries and many other files necessary to run TeX and its flavors. Many ConTeXt modules are included.

==Usage==

==Included modules:=Modules= * [[source:t{{code|bibl-bib.texlua}} ({{src|tbibl-bib]].mkiv}}): [[Bibliography]] (maintained by Taco)* [[source:{{code|m-arabtex.tex}} ({{src|m-arabtex]].mkii}}): loading of Lagally's [[Arabian and Hebrew|ArabTeX]]* [[source{{code|m-barcodes}} ({{src|m-barcodes.mkiv}}):generate barcodes using PStricks. You should probably use m-zint instead.* {{code|m-chart}} ({{src|m-chart.texlua}} {{src|m-chart.mkii}} {{src|m-chart]].mkvi}}): [[Flow Charts]]* [[source:{{code|m-chemic}} ({{src|m-chemic.texmkii}} {{src|m-chemic]].mkiv}}): [[Chemistry|PPCHTeX]] (chemical structure formulae)* [[source:{{code|m-cweb.tex}} ({{src|m-cweb]].tex}}): [[CWEB]] pretty printing* [[source:{{code|m-database}} ({{src|m-database.lua}} {{src|m-database.texmkii}} {{src|m-database]].mkiv}}): creating simple tables (or forwarding data to user-defined commands) using [[mM-database|comma/space/tab-separated values]]. Wiki: [[M-database]].* {{code|m-datastrc}} ({{src|m-datastrc.tex}}):* [[source{{code|m-directives}} ({{src|m-directives.mkiv}}):* {{code|m-dratex}} ({{src|m-dratex]].mkii}}): loading of DraTeX* [[source:{{code|m-edtsnc.tex}} ({{src|m-edtsnc]].mkii}}): support for editor synchronization, will replace m-pdfsync* [[source:{{code|m-educat.tex}} ({{src|m-educat]].tex}}): educational additions (for settings school tests or questionaires)* {{code|m-fields}} ({{src|m-fields.mkiv}}):* {{code|m-format}} ({{src|m-format.tex}}):* <strike>[[source:m-gamma.tex|m-gamma]]: [[Aleph|Omega]] support</strike>* [[source:{{code|m-graph}} ({{src|m-graph.texmkii}} {{src|m-graph]].mkiv}}): support for [[MetaPost]] graph module* [[source{{code|m-ipsum}} ({{src|m-ipsum.mkiv}}):lorem ipsum filler text* {{code|m-layout.tex}} ({{src|m-layout]].tex}}): defines some [[Layout]] presets* [[source:{{code|m-level.tex}} ({{src|m-level]].mkii}}): module for catching nesting errors* [[source{{code|m-logcategories}} ({{src|m-logcategories.mkiv}}):* {{code|m-markdown}} ({{src|m-markdown.lua}} {{src|m-markdown.mkiv}}):* {{code|m-mathcrap}} ({{src|m-mathcrap.mkiv}}):* {{code|m-mkii}} ({{src|m-mkii.mkiv}}):* {{code|m-mkivhacks}} ({{src|m-mkivhacks.mkiv}}):* {{code|m-morse}} ({{src|m-morse.mkvi}}):* {{code|m-narrowtt.tex}} ({{src|m-narrowtt]].tex}}): using a narrower [[Latin Modern]] font for verbatim* [[source:{{code|m-newmat.tex}} ({{src|m-newmat]].tex}}): support for some AMSmath features, is loaded by [[Math with amsl|amsl]], see [[Math with newmat]]* [[source{{code|m-ntb-to-xtb}} ({{src|m-ntb-to-xtb.mkiv}}):* {{code|m-obsolete}} ({{src|m-obsolete.mkii}} {{src|m-obsolete.mkiv}}):* {{code|m-oldfun}} ({{src|m-oldfun.mkiv}}):* {{code|m-oldnum}} ({{src|m-oldnum.mkiv}}):* {{code|m-pdfsnc.tex}} ({{src|m-pdfsnc]].mkii}}): editor/PDF synchronization support (used by iTeXMac and TeXShop)* [[source:{{code|m-pictex.tex}} ({{src|m-pictex]].tex}}): needed for [[PicTeX]] without eTeX* <strike>[[source:m-plus.tex|m-plus]]: loads some extra features (currently empty)</strike>* {{code|m-pstricks}} ({{src|m-pstricks.lua}} {{src|m-pstricks.mkii}} {{src|m-pstricks.mkiv}}):* {{code|m-punk}} ({{src|m-punk.mkiv}}):* <strike>[[source:m-pstricquest.tex|m-pstricquest]]: connection macros module for [[PSTricks]] fill-in forms* (PostScript tricksdutch only)</strike>* [[source:{{code|m-r.tex}} ({{src|m-r]].tex}}): typing and executing [http://www.r-project.org/ R] scripts* [[source:{{code|m-spreadsheet}} ({{src|m-questspreadsheet.texlua}} {{src|m-quest]]spreadsheet.mkiv}}): module for fill* {{code|m-in forms steps}} (dutch only)* [[source:{{src|m-steps.lua}} {{src|m-steps.texmkii}} {{src|m-steps]].mkvi}}): Step Charts, see [[XML]] step charts* [[source:{{code|m-streams.tex}} ({{src|m-streams]].tex}}): Synchronised typesetting from different sources* [[source:{{code|m-subsub.tex}} ({{src|m-subsub]].tex}}): Defines 5 extra sectioning levels* [[source:{{code|m-tex4ht.tex}} ({{src|m-tex4ht]].mkii}}): convert a ConTeXt document to html, more about it on [[tex4ht]]* [[source{{code|m-timing}} ({{src|m-timing.mkiv}}):* {{code|m-tryouttrackers}} ({{src|m-trackers.texmkiv}}):* {{code|m-translate}} ({{src|m-tryout]]translate.mkiv}}): Contains temporary functions for testing* [[source:{{code|m-units}} ({{src|m-units.texmkii}} {{src|m-units]].mkiv}}): Structured input of values with [[units]]* [[source:{{code|m-visual}} ({{src|m-visual.texmkii}} {{src|m-visual]].mkiv}}): [[Visual Debugging]] (described in [[This WayThis_Way_-_My_Way#ThisWay|ThisWay]] no.7 [[magazine:0007|Faking Text and More]])* {{code|m-zint}} ({{src|m-zint.mkiv}}): Generate barcodes using [http://www.zint.org.uk zint.exe]

==Contributed modules:=Modules=

* [[Gantt chartsModules/Karnaugh|Karnaugh]] (drawing Gantt charts): draws Karnaugh maps

==Special Purpose Modules==

* [[Modules/This Way - My Way#MyWay|MyWayMy Way]] , User documentation on ConTeXt

==Modules writing guidelines==

===Module requirements===

There is a [[module Module template]] available to help setting up that header correctly.

===XML Interface file===

[background=screencolor, backgroundcolor=lightgray,

the [[ConTeXt_Mailing_ListsMailing list|mailing list]]. ==Self-documenting source code==Source files are supposed to contain explanatory comments that documentimplementation details and other peculiarities the reader should beaware of.In <tt>.tex</tt> files (and other files containing primarily TeX code, e.g.<tt>.mki[iv]</tt>) any line beginning with the comment leader <tt>%D</tt>will be treated as such a docstring.Formatting is done via ordinary TeX commands.In Lua files (e.g. <tt>.cld</tt>) multi-line comments start with<tt>--[[ldx--</tt> and end with <tt>--ldx]]--</tt>.Text inside those delimiters can be formatted using basic ''HTML'' tags.Ordinary comments are still treated as part of the source and thereforethey will be typeset inside the listing. Docstrings, though they appear to the [Lua]TeX interpreter as ordinarycomments, allow for pretty printing source code when used with twodedicated modules:* [[source:x-ldx.ctx|<tt>x-ldx.ctx</tt>]] for Lua files, and* [[source:s-mod.ctx|<tt>s-mod.ctx</tt>]] for TeX files.Thus, in order to generate the documentation for the[https://bitbucket.org/wolfs/simplefonts/src ''simplefonts'']module you first have to chdir to the <tt>files</tt> subdirectory ofyour checkout.Next you run the pretty printer on its main file<pre>context --ctx=s-mod t-simplefonts.tex</pre>to get a <tt>t-simplefonts.pdf</tt> which contains the &ndash; sparse&ndash; annotations in serif and the actual code as colorful listing.Likewise the processing of Lua code, e.g. <tt>[[source:font-def.lua|font-def.lua]]</tt> fromthe main ConTeXt tree:<pre>context --ctx=x-ldx font-def.lua</pre>Which should generate a font-def.pdf in your current directory. (The autogenerated documentation of all ConTeXt sources has beenmade available by Luigi at [http://foundry.supelec.fr/gf/project/modules/].Go there for examples of the output.)

===Legacy modules disclaimer===

Prior to release ''2005.05.25'', ConTeXt silently truncated all file names in <{{cmd>|usemodule</cmd> }} commands to 8 characters long and lowercased them to "prevent cross platform problems with filenames". Thus, module files that are to be used with older versions of ConTeXt must have filenames that fit those restrictions, or they will (somewhat cryptically) not be found.