aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAntoine Beaupré <anarcat@debian.org>2016-04-15 09:57:53 -0400
committerAntoine Beaupré <anarcat@debian.org>2016-04-15 09:57:53 -0400
commit54f71deab5479b939593a80a663aae01dd557a4e (patch)
tree7fa61d561975bdf3ad38b2720d5df9fbc50b061a /doc
parent8eb3a06f1e21878a19fa634f3c6521f008659977 (diff)
downloadikiwiki-54f71deab5479b939593a80a663aae01dd557a4e.tar
ikiwiki-54f71deab5479b939593a80a663aae01dd557a4e.tar.gz
admonitions proposal
Diffstat (limited to 'doc')
-rw-r--r--doc/todo/admonitions.mdwn25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/todo/admonitions.mdwn b/doc/todo/admonitions.mdwn
new file mode 100644
index 000000000..3d5b7f107
--- /dev/null
+++ b/doc/todo/admonitions.mdwn
@@ -0,0 +1,25 @@
+In the [MoinMoin wiki][], there is this neat little hack called
+[Admonitions][] that basically create a `<div>` block with a specific
+style out of a certain section of the text.
+
+I couldn't find a way to do this easily in Ikiwiki. On the one hand,
+there is no easy way to create div blocks with arbitrary styles (which
+is basically what MoinMoin admonitions are). On the other hand, there
+are no neat little logos in stylesheets like there are in Moinmoin
+either.
+
+It would be great to see this implemented in Ikiwiki. Now, I know I
+can make a `<div>` myself, but I am not sure we should encourage users
+to inject arbitrary HTML in ikiwiki pages. And even then, we should
+add adminition CSS classes to make that easier to use.
+
+Ideally, Ikiwiki would support Pandoc or Github-style fenced blocks
+and could abuse those to allow arbitrary styles (and markup!) to kick
+in. The [[ikiwiki/directive/format]] directive could also be used, I
+guess, but I dislike how it requires all those brackets and quotes and
+bangs and all...
+
+-- [[anarcat]]
+
+[MoinMoin wiki]: https://moinmo.in/
+[Admonitions]: https://moinmo.in/HelpOnAdmonitions