X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/7493b4015bce9a907db81b133162c05faeac3b02..3a04e96389def78bcb873a4487b85f4d75653199:/doc/todo/admonitions.mdwn?ds=sidebyside diff --git a/doc/todo/admonitions.mdwn b/doc/todo/admonitions.mdwn index 752eec336..50f62bf3d 100644 --- a/doc/todo/admonitions.mdwn +++ b/doc/todo/admonitions.mdwn @@ -56,4 +56,70 @@ bangs and all... > might use the right one?) could interpret an ad-hoc syntax and > turn it into a `
` either before or after `htmlize` processing. > However, that would be adding an extra layer of syntax for your -> users to keep track of. --[[smcv]] +> users to keep track of. +> +> [[templates|ikiwiki/directive/template]] are another way this could +> work: +> +> \[[!template id=warning text="Do as I say, not as I do."]] +> +> There's a "note" template bundled with ikiwiki already. +> +> --[[smcv]] + +>> I think you mean the `htmlize` hook, as I cannot find any `htmlize` +>> plugin.. That said, yeah, i understand the limitations of Ikiwiki +>> here. I guess that the [[ikiwiki/directive/template]] directive is a +>> good workaround, but it's not really shorter to write: +>> +>> \[[!template id=warning text="Do as I say, not as I do."]] +>> +>> than to write: +>> +>> [[!format txt """
Do as I say, not as I do.
"""]] +>> +>> ... in fact, it's actually longer. So short of allowing arbitrary +>> classes *and* fenced blocks, I don't think this can go much +>> further. +>> +>> We *could*, however, import the admonition styles from MoinMoin +>> directly. It would involve importing 5 icons from MoinMoin and +>> creating associated styles. Is that something you would be open to? +>> +>> --[[anarcat]] + +>> Looking more at the MoinMoin images, the source (and license!) for +>> them is not quite clear, so they don't make such great targets for +>> inclusion. They are, nevertheless, included in Debian so presumably +>> they are DFSG-friendly? The copyright file marks them as "UNKNOWN" +>> which is worrisome... I have found the following results about them: +>> +>> * [admon-warning.png][] seems to be [public domain according to this sketchy site][] +>> * [admon-note.png][] seems to have a [source in XFCE][], as part of +>> the notes plugin +>> * [admon-tip.png][] is used in the Debian release notes, so is +>presumably fine as well [source there](https://www.debian.org/releases/testing/amd64/release-notes/images/note.png) +>> * [admon-important.png][], same, [important.png](https://www.debian.org/releases/testing/amd64/release-notes/images/important.png) +>> * [admon-caution.png][] can be found in Mediawiki as well, which is +>> a good source of icons. According to Debian, some are public domain, +>> some are LGPL (!?). In MediaWiki itself, the source of that file is +>> lost in the mists of time. +>> +>> Even though there is some confusion about the source of those +>> images, I think, in good faith, that they can be generally be +>> considered reusable. --[[anarcat]] + +[public domain according to this sketchy site]: http://all-free-download.com/free-vector/download/tango_process_stop_115912.html +[source in XFCE]: http://git.xfce.org/panel-plugins/xfce4-notes-plugin/tree/data/icons/scalable/xfce4-notes-plugin.svg +[admon-warning.png]: https://moinmo.in/moin_static19/modernized/img/admon-warning.png +[admon-note.png]: https://moinmo.in/moin_static19/modernized/img/admon-note.png +[admon-tip.png]: https://moinmo.in/moin_static19/modernized/img/admon-tip.png +[admon-important.png]: https://moinmo.in/moin_static19/modernized/img/admon-important.png +[admon-caution.png]: https://moinmo.in/moin_static19/modernized/img/admon-caution.png + +Update: I have made a [[plugins/contrib/admonition]] plugin for this +purpose, as a patch. Hopefully it will be mergeable here? Here's a +screenshot of what the help page would look like, to give you an idea +of the results: + +