]> sipb.mit.edu Git - ikiwiki.git/blob - IkiWiki/Plugin/rst.pm
fixes
[ikiwiki.git] / IkiWiki / Plugin / rst.pm
1 #!/usr/bin/perl
2 # Very simple reStructuredText processor.
3 #
4 # This plugin calls python and requires python-docutils to transform the text
5 # into html.
6 #
7 # Its main problem is that it does not support ikiwiki's WikiLinks nor
8 # Preprocessor Directives.
9 #
10 # Probably Wikilinks and Preprocessor Directives should support a list of
11 # extensions to process (i.e. the linkify function could be transformed into
12 # reStructuredText instead of HTML using a hook on rst.py instead of the
13 # current linkify function)
14 #
15 # by Sergio Talens-Oliag <sto@debian.org>
16
17 package IkiWiki::Plugin::rst;
18
19 use warnings;
20 use strict;
21 use IkiWiki;
22 use IPC::Open2;
23
24 # Simple python script, maybe it should be implemented using an external script.
25 # The settings_overrides are given to avoid potential security risks when
26 # reading external files or if raw html is included on rst pages.
27 my $pyCmnd = "
28 from docutils.core import publish_string;
29 from sys import stdin;
30 html = publish_string(stdin.read(), writer_name='html', 
31        settings_overrides = { 'halt_level': 6, 
32                               'file_insertion_enabled': 0,
33                               'raw_enabled': 0 }
34 );
35 print html[html.find('<body>')+6:html.find('</body>')].strip();
36 ";
37
38 sub import { #{{{
39         IkiWiki::hook(type => "htmlize", id => "rst", call => \&htmlize);
40 } # }}}
41
42 sub htmlize ($) { #{{{
43         my $content=shift;
44
45         my $tries=10;
46         while (1) {
47                 eval {
48                         # Try to call python and run our command
49                         open2(*IN, *OUT, "python", "-c",  $pyCmnd)
50                                 or return $content;
51                 };
52                 last unless $@;
53                 $tries--;
54                 if ($tries < 1) {
55                         IkiWiki::debug("failed to run python to convert rst: $@");
56                         return $content;
57                 }
58         }
59         # open2 doesn't respect "use open ':utf8'"
60         binmode (IN, ':utf8');
61         binmode (OUT, ':utf8');
62         
63         print OUT $content;
64         close OUT;
65         local $/ = undef;
66         return <IN>;
67 } # }}}
68
69 1