aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/syntax.mdwn
blob: 56130471a228257ca0a8271de4651e6c486d682d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
[[template id=plugin name=syntax author="[[VictorMoral]]"]]
[[tag type/chrome type/slow]]
[[meta title="syntax (third-party plugin)"]]

`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.

The plugin inserts a fragment of HTML with special marks from a file or a string text. It accepts the following parameters:

* **type** (optional): this is the file type for vim syntax highlighthing. It can be omitted if the param *file* exists.
* **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.

The params *file* and *text* are mutually exclusive.

Example:

       \[[syntax type="perl" text="""  
       #!/usr/bin/perl

       my $a = "World";
       print "Hello, ${a}\n";
       """]]

or 

       \[[syntax file="hello.pl" description="My first perl program"]]

This plugin create the following CSS styles:

* syntax
* synComment
* synConstant
* syncIdentifier
* synPreProc
* synType
* synSpecial
* synUnderlined
* synError
* synTodo
* synTitle

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 <http://taquiones.net/files/debian/>. There is a page with examples: <http://taquiones.net/software/syntax-examples.html>

Any help, comments or critics are welcome at <victor@taquiones.net>.