Merge branch 'master' of ssh://git.kitenet.net/srv/git/ikiwiki.info

[ikiwiki.git] / doc / plugins / contrib / sourcehighlight.mdwn

diff --git a/doc/plugins/contrib/sourcehighlight.mdwn b/doc/plugins/contrib/sourcehighlight.mdwn
index 8f302b7f638e561381a9b4e37559d704d4cfa110..2cf0ca5638a75007279fb778af8cb511a5af910f 100644 (file)
--- a/doc/plugins/contrib/sourcehighlight.mdwn
+++ b/doc/plugins/contrib/sourcehighlight.mdwn
@@ -2,15 +2,19 @@ I noticed several places in the wiki talking about similar ideas, so I decided t
 
 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)
-
-you must specify a highlight_lang=>"foo,bar" in your setup file.
+[my wiki](http://www.cs.unb.ca/~bremner/wiki/software/ikiwiki/sourcehighlight.pm).
+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; I'm not quite sure how to manage this at them moment.  
+- I would like to have a link to the raw source; using will_render() and then copying the file 
+may work. 
+The discussion in [[plugins/contrib/texinfo]] seems relevant.
 
 - the common case of foo.c and foo.h breaks
-because they both generate page working/dir/foo. Is there some way to change the default output name?
+because they both generate page working/dir/foo. 
+It looks to me like ikiwiki is hardcoded to strip the extension in `pagename()` (IkiWiki.pm).
+This problem with sourcehighlight needs to be fixed before it is very useful.
 
+[[DavidBremner]]