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