Difference between revisions of "Modules"

From Wiki
Jump to navigation Jump to search
m (Special purpose modules)
m (→‎Special Purpose Modules: Added some details)
Line 49: Line 49:
 
These modules implement special formatting requirement for journals or magazines.
 
These modules implement special formatting requirement for journals or magazines.
  
* [[Modules/MyWay|MyWay]]
+
* [[Modules/MyWay|MyWay]] User documentation on ConTeXt
* [[Modules/Pracjourn|pracjourn]]
+
* [[Modules/Pracjourn|pracjourn]] Articles for [http://tug.org/pracjourn/ The PracTeX Journal]
* [[Modules/Maps|maps]]
+
* [[Modules/Map|map]] Articles for [http://www.ntg.nl/maps.html MAPS], the publication of NTG (Nederlandstalige TeX Gebruikersgroep or Netherlands TeX Group)
  
 
==Modules writing guidelines==
 
==Modules writing guidelines==

Revision as of 18:54, 25 December 2006

< The ConTeXt Way

Modules are extensions to ConTeXt's core functions.

There are not as many modules for ConTeXt as packages for LaTeX, because a lot of LaTeX package features are in ConTeXt's core.

Included modules:

Contributed modules:

For a list of contributed modules see the modules section on contextgarden.net.

File names of included modules start with "m-", but third party (contributed) modules should start with "t-".


Special Purpose Modules

These modules implement special formatting requirement for journals or magazines.

Modules writing guidelines

Prior to release 2005.05.25, ConTeXt silently truncated all file names in \usemodule 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.


TODO

Each module should have an associated specification file (as in /tex/context/interface/cont-en.xml). Probably one day this will become a part of texshow and will also be easy-to-edit.

When documenting your module, you can use

\usemodule[int-load] %Allow xml parsing 
\loadsetups[m-name-of-your-module.xml] % to load the file with definitions
\setup{nameofyourcommand}

An example:

\usemodule[int-load]
\loadsetups
\setup{externalfigure}

By default, this places a frame around the setup. If you want to get gray backgroud, as in context documentation, add the following

 \setupframedtexts
     [setuptext]
     [background=screen,
      frame=off]