Changes

Jump to navigation Jump to search
92 bytes added ,  10:29, 14 May 2023
some more hints, fixes, small chages
mtxrun --script install-modules --list
For the installation to work, you must change into the `tex` directory that contains the `texmf-*` trees.
mtxrun --script install-modules --install filter simpleslides
* s-modulename (ConTeXt style file)
* x-modulename (XML module)
* t-modulename ("Third third party" contributed module)
* modulename
* [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 lettersAKA correspondence
* [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](MkII)
* [http://modules.contextgarden.net/vim t-vim] syntax highlighting using vim’s syntax files
* [[Gnuplot]]: support for direct inclusion of Gnuplot graphs out of the source (the module has been removed from the main distribution and will be included into third party modules again when ready)
* [[Modules/Karnaugh|Karnaugh]]: draws Karnaugh maps
-->
* [[This Way - My Way#MyWay|My Way]], User documentation on ConTeXt
* `cgj` Articles for ConTeXt Journal (proceedings of ConTeXt meetings)
* [[Modules/Pracjourn|pracjourn]] Articles for [http://tug.org/pracjourn/ The PracTeX Journal]
* [[Modules/Maps|maps]] Articles for [http://www.ntg.nl/maps.html MAPS], the publication of NTG (Nederlandstalige TeX Gebruikersgroep or Netherlands TeX Group)
-->
=Module writing guidelines=
 
'''Please don’t publish font support modules any more!''' They’re usually unnecessary. Instead publish [[Typescript typescript]] in the wiki instead.
==Module requirements==
The same applies for git/SVN repositories containing ConTeXt modules.
VERSION and README files are important for publication on [[https://ctan.org CTAN]]. README is also displayed on git platforms like GitHub or Codeberg and should contain basic documentation. All top level files are ignored by the LMTX module installer.
=== Module main file ===
<texcode>
\usemodule[int-load] %Allow xml parsing
\loadsetups[mt-name-of-your-module.xml] % to load the file with definitions
\setup{nameofyourcommand}
</texcode>
* [[source:s-mod.ctx|<tt>s-mod.ctx</tt>]] for TeX files.
Thus, in order to generate the documentation for thehypothetical''simplefontssimple'' module you first have to `chdir` to the <tt>files</tt> subdirectory of
your checkout.
Next you run the pretty printer on its main file
<pre>
context --ctx=s-mod t-simplefontssimple.tex
</pre>
to get a <tt>t-simplefontssimple.pdf</tt> which contains the &ndash; sparse
&ndash; annotations in serif and the actual code as colorful listing.
* If you lost your password, please ask Taco or Mojca (via the mailing list if you don’t know them).
* Create a '''new module''' entry with a distinct name (e.g. “prettyprinter”“simple”) and fill in the metadata:** Title, e.g. “My Pretty Printer”“Simple” (This will get used in filenames!)
** Short and longer description (the short one gets published e.g. in CTAN updates).
** Home URL, if the module has a homepage, e.g. a wiki page.
** Keywords (for CTAN search)
** Type: Macro or font(Don’t publish font modules any more!)
** Works with Mk... (please check)
** License
** Check “Put in ConTeXt distribution” (not sure if this works)
** Check “Synch with CTAN” (yes please, makes it visible)
** CTAN location: e.g. “<tt>/macros/context/contrib/context-prettyprintersimple</tt>”
** Comment: for you or the server admins
* Create a '''new module version''' from a ZIP upload/download or checkout from SVN or git
** File upload / HTTP download URL: release file as ZIP, as outlined above
** SVN/GIT URL: repository checkout, structured like the ZIP, as outlined above
 
'''While a git repository URL ''should'' work and is the most elegant way, it doesn’t really work at the moment (2023-05), because it creates `.tar.gz` archives that the installer can’t handle.'''

Navigation menu