#format wiki #language en #pragma section-numbers off #acl IanRiley:read,write,delete,revert,admin All:read #pragma supplementation-page on <> = genstat = == Background and rationale == !GenStat is a versatile computer program for statistical analysis. Analyses can be preformed using a menu-driven user interface. During these interactive sessions an input stream of !GenStat code is created, which can be saved as a record or for reuse with or without modification. Saved !GenStat code can be submitted as batch jobs. Flow control directives can be incorporated into these jobs, as !GenStat is a feature-rich scripting language. !GenStat code can also be written directly and run without using the interactive interface. Although the !GenStat interactive interface provides code highlighting, there is no simple way to enhance the presentation of code from saved input streams or in batch jobs incorporated into reports or teaching materials. Pygments provides a simple way to highlight code files on systems running Python. The highlighted code can be saved in a number of formats, including HTML, RTF, LaTeX and ANSI sequences. MoinMoin provides a parser called `highlight` that uses [[http://pygments.org/|Pygments]] internally. This can be used to display highlight !GenStat code either in a parser section or embedded attachments. == Description == A [[http://pygments.org/|Pygments]] highlighting lexer for !GenStat Release 10. == Usage == As parser section {{{{ {{{#!highlight genstat JOB "Example GenStat code" UNIT [NVALUES=3] Plot READ [PRINT=data,errors] Plot,RootWt,ShootWt 2 23.4 34.5 1 43.2 54.3 3 34.2 45.3: CALC [s] MeanPlantWt = vmean(RootWt+ShootWt) PRINT MeanPlotMean STOP }}} }}}} renders as: {{{#!highlight genstat JOB "Example GenStat code" UNIT [NVALUES=3] Plot READ [PRINT=data,errors] Plot,RootWt,ShootWt 2 23.4 34.5 1 43.2 54.3 3 34.2 45.3: CALC [s] MeanPlantWt = vmean(RootWt+ShootWt) PRINT MeanPlotMean STOP }}} As embedded attachment The MoinMoin configuration file `wikiconfig.py` must include: {{{#!highlight python import mimetypes mimetypes.add_type("text/x-genstat", ".gen", True) }}} Attachments must be named `*.gen`. See under Example below. == Download & Release Notes == || Download || Release Version || Moin Version || Release Notes || || [[attachment:genstat.py]] || 1.0 || 1.9.2 || || == Installation == The lexer file `genstat.py` needs to be copied to: /lib/python2.4/site-packages/MoinMoin/support/pygments/lexers or your equivalent. Alternatively, the content of the lexer file `genstat.py` can be copied into a builtin lexer, such as `other.py`, in the same location. The script `_mapping.py` needs to be run in that location to map in the new lexer before MoinMoin can find it. The !GenStat lexer has not been submitted to [[http://pygments.org/|Pygments]] yet. This will be considered after further testing, and if so, in future it might ship with installations of Pygments and MoinMoin. == Example == {{attachment:Example.gen}} == History == Version 1.0 - 25.03.2011: initial version == Copyright == . @copyright: 2011 Ian Riley == License == GNU GPL, see COPYING for details. == Known issues and limitations == * !GenStat Release 13 was issued in March 2010 with new directives, functions and procedures that are not parsed in this version. * MoinMoin does not provide for different highlighting of the full range of token types supported by Pygments. See [[http://moinmo.in/ParserMarket/Pygments]] for more ideas about this. == Possible improvements == * Recognition and specific highlighting of in-line data following a READ statement could be useful, especially for text or factor structures that happen to use words that coincided with directive, procedure or function names. * An option to allow selection of normalisation (capitalising and expanding of all keywords) could be useful. ----- Hits:: <>