]> sipb.mit.edu Git - ikiwiki.git/blob - doc/plugins/contrib/sourcehighlight.mdwn
Merge branch 'master' into darcs
[ikiwiki.git] / doc / plugins / contrib / sourcehighlight.mdwn
1 [[!template id=plugin name=sourcehighlight core=0 author="[[DavidBremner]]"]]
2
3 I noticed several places in the wiki talking about similar ideas, so I decided to put a page here to point to what I am working on.
4
5 I have implemented a simple wrapper around
6  [source-highlight](http://www.gnu.org/software/src-highlite/).  You can find the latest version in 
7 [git](http://pivot.cs.unb.ca/git?p=ikiplugins.git;a=blob_plain;f=IkiWiki/Plugin/sourcehighlight.pm;hb=HEAD).
8 You must specify `highlight_lang=>"foo,bar"` in your setup file.
9 where foo and bar are the (source-supported) languages you want to
10 highlight
11 ### Issues
12
13 - I would like to have a link to the raw source; using will_render() and then copying the file should work. 
14
15 - the common case of foo.c and foo.h breaks
16 because they both generate page working/dir/foo. 
17 It looks to me like ikiwiki is hardcoded to strip the extension in `pagename()` (IkiWiki.pm).
18 This problem with sourcehighlight needs to be fixed before it is very useful.
19
20 - Is there a way to configure the colors used by source-highlight (other than editing the globally installed "default.style" file)? It would help if I could pass the command arbitrary command-line arguments; then I could configure which config file it's supposed to use. For instance, I'm not a fan of hard-coding the colors into the HTML output. IMHO, css-style formatting should be preferred. All that can be set via the command line ... --Peter
21
22 > I don't really have time right now, but it should be easy to add, if you look at how src-lang is handled.  Patches are welcome :-) --[[DavidBremner]]