X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/890863679fea395172c247877579d391563c3b5e..bd958f91a2b71761e9aa20fa25a6702dab3b4b8d:/doc/plugins/contrib/sourcehighlight.mdwn diff --git a/doc/plugins/contrib/sourcehighlight.mdwn b/doc/plugins/contrib/sourcehighlight.mdwn index b34f41b3c..07ac2086f 100644 --- a/doc/plugins/contrib/sourcehighlight.mdwn +++ b/doc/plugins/contrib/sourcehighlight.mdwn @@ -1,13 +1,30 @@ +[[!template id=plugin name=sourcehighlight core=0 author="[[DavidBremner]]"]] + 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. -I have copied otl.pm and am wrapping source-highlight (why this instead of vim highlight, I dunno, I must be a real emacs guy). You can find more or less the latest -version on -[my wiki](http://www.cs.unb.ca/~bremner/wiki/software/sourcehighlight.pm) +I have implemented a simple wrapper around + [source-highlight](http://www.gnu.org/software/src-highlite/). You can find the latest version in +[git](http://pivot.cs.unb.ca/git?p=ikiplugins.git;a=blob_plain;f=IkiWiki/Plugin/sourcehighlight.pm;hb=HEAD). +You must specify `highlight_lang=>"foo,bar"` in your setup file. +where foo and bar are the (source-supported) languages you want to +highlight +### Issues + +- I would like to have a link to the raw source; using will_render() and then copying the file should work. + +> You might also like to look at the [[todo/source_link]] todo. -- [[Will]] + +- 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 + +> 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]] -In the tradition of publish early and often, this just supports java -at the moment. I will add more languages soon. -You can add more languages by cutting and pasting the hook line; I want to add a configuration option to allow the user to specify. +Note that [[Will]] wrote a plugin that uses source-highlight also. It's +available +[[here|todo/automatic_use_of_syntax_plugin_on_source_code_files/discussion]]. +--[[Joey]] -One outstanding problem is that I would like to have a link to the raw source; I'm not quite sure how to manage this at them moment. +To be honest, [[Will]]'s version of this looks more polished. I will try his +plugin and see if it can just replace mine. --[[DavidBremner]] +*Updated* Now uses keepextension so multiple extensions should be OK