This is a fork maintained by the followings:
- Kouhei Sutou [email protected]
This work is sponsored by Shimadzu Corporation.
You can find the original version here: https://github.com/ndl/wiki_external_filter
The original author is Alexander Tsvyashchenko. Here is the information for the original version from COPYRIGHT.txt:
Copyright (C) 2010 Alexander Tsvyashchenko, http://www.ndl.kiev.ua
- Based on wiki_latex_plugin by Nils Israel [email protected]
- Based on wiki_graphviz_plugin by tckz [email protected]
- Includes FlowPlayer flash player, see http://www.flowplayer.org
- Includes CSS Browser Selector, see http://rafael.adm.br/css_browser_selector/
- Thanks to Eike for his "Cross-Browser SVG Issues" article, http://e.metaclarity.org/52/cross-browser-svg-issues/
This fork picks useful improvements from the following forks:
- https://github.com/maxrossello/wiki_external_filter/
- https://github.com/simonswine/wiki_external_filter/
License is GPLv2 or later. See COPYING for details.
This plugin allows defining macros that process macro argument using external filter program and render its result in Redmine wiki.
For every filter two macros are defined: <macro> and <macro>_include. The first one directly processes its argument using filter, while the second one assumes its argument is wiki page name, so it reads that wiki page content and processes it using the filter.
Macros already bundled with current release are listed below, but adding new ones is typically as easy as adding several lines in plugin config file.
- 3.4
- 4.0
See CI result for details.
Download source and install required libraries:
% git clone https://github.com/clear-code/redmine_wiki_external_filter plugins/wiki_external_filter
% bundle installRestart your Redmine.
Then go to https://your-redmine/settings/plugin/wiki_external_filter and configure.
Specific filters installation instructions are below.
Tikz/PGF is based on description in http://www.hostedredmine.com/projects/alxa/wiki/PGF_TIKZ_Redmine and latextool.sh is taken from there. The actual latextool.sh which has been tested here is under plugins/wiki_external_filter/bin/latextool.sh
This part is unstable at the moment due to a lot of possiblities in tikz there only some pictures possible. You might need to adjust latextool.sh for loading libraries for specific tikz picture.
PlantUML is a tool to render UML diagrams from their textual representation. It's assumed that it can be invoked via wrapper /usr/bin/plantuml, here's its example content:
#!/bin/bash
/usr/bin/java -Djava.io.tmpdir=/var/tmp -jar /usr/share/plantuml/lib/plantuml.jar ${@}
Result is rendered as PNG file. SVG support seems to be under development for PlantUML but so far looks like it's still unusable.
Gentoo ebuild is attached.
Example of usage:
{{plantuml
Alice -> Bob: Authentication Request
alt successful case
Bob -> Alice: Authentication Accepted
else some kind of failure
Bob -> Alice: Authentication Failure
opt
loop 1000 times
Alice -> Bob: DNS Attack
end
end
else Another type of failure
Bob -> Alice: Please repeat
end
}}
Rendered output:
Graphviz is a tool for graph-like structures visualization. It's assumed that it can be called as /usr/bin/dot.
Result is rendered as SVG image or PNG fallback if SVG is not supported by your browser.
Example of usage DOT:
{{graphviz
digraph finite_state_machine {
rankdir=LR;
size="8.5"
node [shape = doublecircle]; LR_0 LR_3 LR_4 LR_8;
node [shape = circle];
LR_0 -> LR_2 [ label = "SS(B)" ];
LR_0 -> LR_1 [ label = "SS(S)" ];
LR_1 -> LR_3 [ label = "S($end)" ];
LR_2 -> LR_6 [ label = "SS(b)" ];
LR_2 -> LR_5 [ label = "SS(a)" ];
LR_2 -> LR_4 [ label = "S(A)" ];
LR_5 -> LR_7 [ label = "S(b)" ];
LR_5 -> LR_5 [ label = "S(a)" ];
LR_6 -> LR_6 [ label = "S(b)" ];
LR_6 -> LR_5 [ label = "S(a)" ];
LR_7 -> LR_8 [ label = "S(b)" ];
LR_7 -> LR_5 [ label = "S(a)" ];
LR_8 -> LR_6 [ label = "S(b)" ];
LR_8 -> LR_5 [ label = "S(a)" ];
}
}}
Usage of neato: {{gneato code like in graphviz }}
Rendered output:
Combination of Ritex: a Ruby WebTeX to MathML converter and SVGMath that takes WebTeX formula specification as input and produces SVG file as output.
Both ritex and SVGMath require some patches/wrappers.
Additionally working installation of xmllint from libxml2 with configured MathML catalog is required: for Gentoo use this ebuild.
Gentoo ebuilds for ritex and svgmath are attached.
Example of usage:
{{ritex
G(y) = \left\{\array{ 1 - e^{-\lambda x} & \text{ if } y \geq 0 \\ 0 & \text{ if } y < 0 }\right.
}}
Rendered output:
These macros use ffmpeg to convert any supported video file to FLV format and display it on wiki using FlowPlayer flash player. video macro takes file path on server as its input, as well as attachments names from current wiki page, while video_url expects full URL to the video to convert & show.
Splash images for videos are generated automatically from the first frame of the video.
Multiple videos per page are supported, player instance is attached to the selected video as in this example.
Required packages installed:
- ffmpeg
- RMagick
- wget - for video_url only.
Example of usage:
{{video
video_attachment_name.avi
}}
or
{{video
/full/path/to/the/file/on/the/server/video.avi
}}
or
{{video_url
http://www.example.com/video.avi
}}
Rendered output (before player is embedded by clicking on the image, using Flowplayer video demo file):
Fortune is a simple program that displays a random message from a database of quotations.
Not strictly a filter on its own (as it does not require any input), but it plays nice with external filtering approach and is fun to use, hence it's here ;-)
Example of usage:
{{fortune}}
Rendered output:
New macros can easily be added via wiki_external_filter.yml config file.
Every macro may have multiple commands processing the same input - for example for video macro two commands are used: first one extracts thumbnail and second one converts the video.
Commands use standard Unix approach for filtering: input is fed
to the command via stdin and output is read on stdout. If command return
status is zero, content type is assumed to be of content_type specified in
config, otherwise it's assumed to be plain error text together with stderr content.
You can use prolog/epilog config parameters to add standard text before/after
actual macro content passed to filter.
Additionally, cache_seconds parameter specifies the number of seconds commands
output result should be cached, use zero to disable caching for this macro.
The way filter output is visualized is controlled via
app/views/wiki_external_filter/_macro_*.html.erb files. The view to use is selected by template macro option in config. The view can use all commands outputs for particular macro.
replace_attachments tells plugin that it should parse the text passed to the macro and replace all occurrences of strings matching attachments names with their physical paths on disk.
Macro argument is de-escaped via CGI.unescapeHTML call prior to being fed to
filter.
- SVG support is more complex it should have been if all browsers had played by the rules - currently quite some trickery with different XHTML elements/CSS tricks is used to show SVGs properly in major browsers. Of course, there's not that much that can be done for IE as it does not support SVG at all, but now at least the plugin substitutes raster fall-back image for IE if it is available.
- For formula support, theoretically ritex alone is sufficient if you have MathML-capable browser, however in practice there are too many issues with this approach: for example Firefox (actually the onlt MathML-capable browser so far, it seems) requires specific DOCTYPE additions that Redmine currently lacks; additionally, Redmine emits text/html, while Firefox expects text/xml in order to parse MathML. Changing content type alone is not sufficient as Redmine HTML output does not pass more strict checks required for XML output. Hence, the double conversion (WebTeX to MathML and then MathML to SVG) is necessary. Once (if ever?) MathML support matures in other browser, possibly this can be revisited.
- SVGs could have been embedded into HTML page directly (thus allowing to use redmine links there) but I'm afraid there are similar problems as with MathML embedding attempts.
- RoR caching support is a mess: no way to expire old files from file-based cache??? Are you joking???
- Somewhat similar plugins (although with narrower scope) are graphviz plugin and latex plugin. Graphviz functionality is mostly covered by current version of wiki_external_filter. Latex is not, but only due to the fact I do not have latex installed nor currently have a need in that: adding macro that performs latex filtering should be trivial.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent