path: root/ikiwiki
diff options
authorzweistein <zweistein@web>2020-03-07 13:40:40 +0000
committerIkiWiki <>2020-03-07 13:40:40 +0000
commit43f0e1a630a923aaec6b37a002ada067ef1e854a (patch)
tree145d82bb0b474ed97d6abe8b6ad9095b376d9b72 /ikiwiki
parent0eb991d7d73292120ff04913dfbef42f3ccaf685 (diff)
Diffstat (limited to 'ikiwiki')
1 files changed, 39 insertions, 0 deletions
diff --git a/ikiwiki/directive/toggle.mdwn b/ikiwiki/directive/toggle.mdwn
new file mode 100644
index 00000000..82f110b0
--- /dev/null
+++ b/ikiwiki/directive/toggle.mdwn
@@ -0,0 +1,39 @@
+[[!if test="enabled(toggle)"
+ then="In diesem Wiki ist die Direktive: toggle **aktiviert**."
+ else="In diesem Wiki ist die Direktive: toggle **nicht aktiv**; falls dies gew├╝nscht wird, den Admin benachrichtigen."]]
+The `toggle` and `toggleable` directives are supplied by the [[!iki plugins/toggle desc=toggle]] plugin.
+With these directives you can create links on pages that, when clicked, toggle
+display of other parts of the page.
+It uses javascript to accomplish this; browsers without javascript will
+always see the full page content.
+Example use:
+ \[[!toggle id="ipsum" text="show"]]
+ \[[!toggleable id="ipsum" text="""
+ Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
+ eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim
+ ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+ aliquip ex ea commodo consequat.
+ [[!toggle id="ipsum" text="hide"]]
+ """]]
+Note that you can include wiki markup in the toggleable text,
+including even additional toggles, as shown in the above example.
+Also, the toggle and the togglable definitions do not need to be next to
+each other, but can be located anywhere on the page. There can also be
+mutiple toggles that all toggle a single togglable.
+The id has a default value of "default", so can be omitted in simple cases.
+If you'd like a toggleable to be displayed by default, and toggle to
+hidden, then pass a parameter "open=yes" when setting up the toggleable.
+[[!meta robots="noindex, follow"]]