X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/a784ee9ee3795a3cfbe93aa31ebf96a44e375afa..eeea1000233a352f1a3bee3122b37e2d9fafe0e0:/doc/plugins/contrib/syntax.mdwn diff --git a/doc/plugins/contrib/syntax.mdwn b/doc/plugins/contrib/syntax.mdwn index 8d91b921d..57c614a9d 100644 --- a/doc/plugins/contrib/syntax.mdwn +++ b/doc/plugins/contrib/syntax.mdwn @@ -1,6 +1,5 @@ [[template id=plugin name=syntax author="[[VictorMoral]]"]] -[[tag type/chrome slow]] -[[meta title="syntax (third-party plugin)"]] +[[tag type/chrome type/slow]] `syntax` is a plugin that add support to ikiwiki for syntax highlighting through the *vim* editor and its perl interface [[cpan Text::VimColor]], so it depends on a vim functional installation. @@ -10,23 +9,55 @@ The plugin inserts a fragment of HTML with special marks from a file or a string * **file**: Path to the source file. It must exist on every rebuild of the wiki. * **text**: Text string with the source. * **description** (optional): little description about the content. +* **linenumbers** (optional): enable the line numering of the source page. A value greater than zero is the first line number. The params *file* and *text* are mutually exclusive. +In the case of file parameter, `syntax` will build a html link for direct download. + Example: - \[[syntax type="perl" text=""" - #!/usr/bin/perl + \[[syntax type="perl" text=""" + #!/usr/bin/perl - my $a = "World"; - print "Hello, ${a}\n"; - """]] + my $a = "World"; + print "Hello, ${a}\n"; + """]] or - \\[[syntax file="hello.pl" description="My first perl program"]] + \[[syntax file="/examples/hello.pl" description="My first perl program"]] + +This plugin create the following CSS styles: -It can be downloaded from [here](http://taquiones.net/files/misc/Ikiwiki-plugin-syntax-0.5.tar.gz) or through my personal debian repository at . +* syntax +* synComment +* synConstant +* syncIdentifier +* synPreProc +* synType +* synSpecial +* synUnderlined +* synError +* synTodo +* synTitle + +It can be downloaded from [here](http://taquiones.net/files/misc/) or through my personal debian repository at . There is a page with examples: Any help, comments or critics are welcome at . +## version 0.9 + +- Add a force_subpage parameter for link build +- Fix a bug in syntax page link +- Documented a bug with markdown indented text +- Documented the syntax directive + +## version 0.7 + +- Version change to GPL +- Add *linenumbers* parameter +- The *file* parameter should be point to a ikiwiki source page. +- The *description* parameter will be converted on a URL if the *file* parameter exist. + +I need help for debugging this module. Thanks in advance.