#
# Produce a hyerarchical map of links.
#
-#
By Alessandro Dotti Contra <alessandro@hyboria.org>
+#
by Alessandro Dotti Contra <alessandro@hyboria.org>
#
# Revision: 0.2
package IkiWiki::Plugin::map;
# (default)
# table: produces a table with the number of backlinks for each page
#
-# By Enrico Zini.
+# by Enrico Zini
package IkiWiki::Plugin::pagestats;
use warnings;
--- /dev/null
+#!/usr/bin/perl
+# Very simple reStructuredText processor.
+#
+# This plugin calls python and requires python-docutils to transform the text
+# into html.
+#
+# Its main problem is that it does not support ikiwiki's WikiLinks nor
+# Preprocessor Directives.
+#
+# Probably Wikilinks and Preprocessor Directives should support a list of
+# extensions to process (i.e. the linkify function could be transformed into
+# reStructuredText instead of HTML using a hook on rst.py instead of the
+# current linkify function)
+#
+# by Sergio Talens-Oliag <sto@debian.org>
+
+package IkiWiki::Plugin::rst;
+
+use warnings;
+use strict;
+use IkiWiki;
+use IPC::Open2;
+
+# Simple python script, maybe it should be implemented using an external script.
+# The settings_overrides are given to avoid potential security risks when
+# reading external files or if raw html is included on rst pages.
+my $pyCmnd = "
+from docutils.core import publish_string;
+from sys import stdin;
+html = publish_string(stdin.read(), writer_name='html',
+ settings_overrides = { 'halt_level': 6,
+ 'file_insertion_enabled': 0,
+ 'raw_enabled': 0 }
+);
+print html[html.find('<body>')+6:html.find('</body>')].strip();
+";
+
+sub import { #{{{
+ IkiWiki::hook(type => "htmlize", id => "rst", call => \&htmlize);
+} # }}}
+
+sub htmlize ($) { #{{{
+ my $content=shift;
+
+ my $tries=10;
+ while (1) {
+ eval {
+ # Try to call python and run our command
+ open2(*IN, *OUT, "python", "-c", $pyCmnd)
+ or return $content;
+ };
+ last unless $@;
+ $tries--;
+ if ($tries < 1) {
+ IkiWiki::debug("failed to run python to convert rst: $@");
+ return $content;
+ }
+ }
+ # open2 doesn't respect "use open ':utf8'"
+ binmode (IN, ':utf8');
+ binmode (OUT, ':utf8');
+
+ print OUT $content;
+ close OUT;
+ local $/ = undef;
+ return <IN>;
+} # }}}
+
+1
* Add a map plugin contributed by Alessandro Dotti Contra.
* Add otl format plugin, which handles files as created by vimoutliner.
* Fix ikiwiki-mass-rebuild to work in the way the postinst uses it.
+ * Add first draft at a Restructured Text (rst) plugin, by Sergio
+ Talens-Oliag. Note that this has many known issues -- see the caveats on
+ the plugin's page.
+ * Credit everyone who wrote a plugin on the plugins' wiki pages.
- -- Joey Hess <joeyh@debian.org> Fri, 18 Aug 2006 22:54:08 -0400
+ -- Joey Hess <joeyh@debian.org> Sat, 19 Aug 2006 00:56:32 -0400
ikiwiki (1.20) unstable; urgency=low
# To add plugins, list them here.
#add_plugins => [qw{meta tag pagecount brokenlinks search smiley
# wikitext camelcase pagestats htmltidy fortune
- # sidebar map}],
+ # sidebar map rst}],
# If you want to disable any of the default plugins, list them here.
#disable_plugins => [qw{inline htmlscrubber}],
}
+++ /dev/null
-This is a whole lot better than nothing, but it's a shame it forks python
-every page. Anyone want to get [this](http://search.cpan.org/~nodine/Text-Restructured-0.003016/) into Debian and use it instead?
---[[Joey]]
-
-Actually, if someone adds support for it to ikiwiki, I would be glad to get
-the package into Debian myself --[[Joey]]
-
- #!/usr/bin/perl
- # Very simple reStructuredText processor.
- #
- # This plugin calls python and requires python-docutils to transform the text
- # into html.
- #
- # It's main problem is that it does not support ikiwiki's WikiLinks nor
- # Preprocessor Directives (in fact the same problem applies to the current
- # Wikitext processor, although in that case the output looks less worse ;)
- #
- # Probably Wikilinks and Preprocessor Directives should support a list of
- # extensions to process (i.e. the linkify function could be transformed into
- # reStructuredText instead of HTML using a hook on rst.py instead of the
- # current linkify function)
- #
- # by Sergio Talens-Oliag <sto@debian.org>
-
- package IkiWiki::Plugin::rst;
-
- use warnings;
- use strict;
- use IkiWiki;
- use IPC::Open2;
-
- # Simple python script, maybe it should be implemented using an external script.
- # The settings_overrides are given to avoid potential security risks when
- # reading external files or if raw html is included on rst pages.
- my $pyCmnd = "
- from docutils.core import publish_string;
- from sys import stdin;
- html = publish_string(stdin.read(), writer_name='html',
- settings_overrides = { 'halt_level': 6,
- 'file_insertion_enabled': 0,
- 'raw_enabled': 0 }
- );
- print html[html.find('<body>')+6:html.find('</body>')].strip();
- ";
-
- sub import { #{{{
- IkiWiki::hook(type => "htmlize", id => "rst", call => \&htmlize);
- } # }}}
-
- sub htmlize ($) { #{{{
- my $content = shift;
-
- # Try to call python and run our command
- open2(*IN, *OUT, "python", "-c", "$pyCmnd") or return $content;
-
- # open2 doesn't respect "use open ':utf8'"
- binmode (IN, ':utf8');
- binmode (OUT, ':utf8');
-
- print OUT $content;
- close OUT;
- local $/ = undef;
- return <IN>;
- } # }}}
-
- 1
even if users enter suboptimal html, your wiki generates valid html.
This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Faidon Liambotis.
[[tag type/html]]
use a [[PageSpec]] like this: `pages="* and !*/*/*"`
This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Alessandro Dotti Contra.
If this plugin is enabled, here is a page map for the plugins section
of this wiki:
\[[pagestats style="table"]]
This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Enrico Zini
[[tag type/meta type/tags]]
including `symbol="text"` in the directive.
This plugin is included in ikiwiki, but not enabled by default.
+It was contributed by Enrico Zini.
----
--- /dev/null
+This plugin lets ikwiki convert files with names ending in ".rst" to html.
+It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
+markup syntax. You need to have the python-docutils module installed to use
+it.
+
+Note that this plugin does not interoperate very well with the rest of
+ikiwiki. Limitations include:
+
+* reStructuredText does not allow raw html to be inserted into
+ documents, but ikiwiki does so in many cases, including
+ [[WikiLinks|WikiLink]] and many
+ [[PreprocessorDirectives|PreprocessorDirective]].
+* It's slow; it forks a copy of python for each page. While there is a
+ perl version of the reStructuredText processor, it is not being kept in
+ sync with the standard version, so is not used.
+
+So while you may find this useful for importing old files into your wiki,
+using this as your main markup language in ikiwiki isn't recommended at
+this time.
+
+This plugin is included in ikiwiki, but not enabled by default.
+It was contributed by Sergio Talens-Oliag.
+
+[[tag type/format]]
the sidebar altogether.
This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Tuomo Valkonen.
[[tag type/chrome]]
quickly grow to support them all.. See [[about_rcs_backends]]
_(status: supports git in tree)_
* Support for one other markup language, probably restructured text.
- _(status: done, but need a few more in tree)_
+ _(status: done, but the rst plugin needs improvement)_
* No serious known [[bugs]]
* No severe-to-moderate known [[security]] issues.