From: Amitai Schlair <schmonz-web-ikiwiki@schmonz.com>
Date: Sat, 20 Feb 2016 07:59:49 +0000 (-0500)
Subject: Document pretty decent Remark.js integration.
X-Git-Tag: 3.20160506~75
X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/7c847499b7922983453455b6d00faf8f472f3e91

Document pretty decent Remark.js integration.
---

diff --git a/doc/plugins/contrib/remark.mdwn b/doc/plugins/contrib/remark.mdwn
new file mode 100644
index 000000000..f35740153
--- /dev/null
+++ b/doc/plugins/contrib/remark.mdwn
@@ -0,0 +1,31 @@
+[[!template id=plugin name=remark author="[[schmonz]]"]]
+[[!template id=gitbranch branch=schmonz/remark author="[[schmonz]]"]]
+[[!tag type/format]]
+
+[Remark.js](http://remarkjs.com) makes web slides from Markdown. This
+plugin integrates Remark into ikiwiki. Simply write `your_slides.remark`
+instead of `your_blog_post.mdwn`, separating slides with `---`.
+
+To set shared styles across all presentations on your site, put them in
+a top-level `remarklocal.css`. To set per-presentation styles, use the
+[[localstyle]] plugin as usual.
+
+## Problem: `inline`
+
+Web slides are sort of a regular web page, but not exactly: no action
+links, and almost none of the other accoutrements of `page.tmpl`. The
+branch's current behavior is that Remark slides are naively inlined like
+any other page, which -- because the Markdown is deliberately not being
+rendered by ikiwiki -- results in the slide source being displayed (and
+not elegantly). Clicking through to the slides works right, of course.
+
+Should [[inline]] (and more generally [[ikiwiki/PageSpec]]) understand
+that web slides are not exactly regular pages? And/or should this plugin
+detect when slides are being inlined and allow ikiwiki to process the
+Markdown as a sort of "preview"?
+
+## Concern: safety of web-editing
+
+Even though `remarkpage.tmpl` has no action links, is it still possible
+for someone to trick their way into web-editing a slide deck? And if
+they do, is that dangerous?