====== sectiontoggle Plugin ======
~~stoggle_buttons~~
[[https://www.dokuwiki.org/plugin:sectiontoggle|sectiontoggle]] lastupdate : 2020-05-06:!:, compatible : ..., 2018-04-22 "Greebo" kompatibel =), 2020-07-29 "Hogfather" unbekannte Kompatibilität :?:

=== Requirements === 
This plugin requires jQuery and was originally designed for use with the DokuWiki Template. In its current form, it should work with any template.

=== Ähnliche Plugins ===
[[https://www.dokuwiki.org/plugin:folded|folded]], [[https://www.dokuwiki.org/plugin:outliner|outliner]], [[https://www.dokuwiki.org/plugin:togglewrap|togglewrap]]

=== Features ===
Wechseln Sie zwischen geöffneten und geschlossenen Abschnitten, indem Sie auf die Abschnittsüberschriften klicken; ändern Sie die Vorlagen, wo sie für Telefone und Tablets erforderlich sind.

=== Kommentar bzgl. Einsatz in iX-Wiki ===
Ein offensichtlicher Vorteil dieses Plugins ist, dass keine weitere Zeile zur Steuerung benötigt wird wie im folded-Plugin. Ein Schalter kann auf einer Seiten bei Bedarf generiert werden, um alle Abschnitte auf- oder zuzuklappen. Per Konfiguration kann die Ebenentiefe eingestellt werden, bis zu welcher automatisch eingeklappt wird. (Standard h1-h4)

=== Prüfung bzgl. Einsatz in iX-Wiki ===
  * Werden PDF ohne weiteres Zutun korrekt (mit ausgeklappten Inhalten) erzeugt? \\ => ja (**+**)
  * Ist das auch reversibel (Deinstallation ohne Datenmüll)? \\ => Ja, solange %%~~stoggle_buttons~~%% nicht in Seitentext geschrieben wird (Schaltereinblendung) (**+**)
  * Bleibt die sonstige Navigationsstruktur erhalten? \\ => leere Überschriften werden ebenfalls integriert. \\ => Die niedriger priorisierten Header werden fulltext angezeigt und nicht mit eingeklappt s. ''Test sectiontoggle Header h1''. Es sind Workarounds denkbar. (**-**)\\ => Überschriften leerer Sections (Überschrift mit direkt nachfolgender Überschrift) erscheinen ohne Symbol links eingerückt, da es hier nichts zu toggeln gibt. Sollte man leere Überschrift als typographischen Fehler betrachten?!
  * In Standardvariante keine Interaktion innerhalb **nodisp**-Klammer (beachte id und class-Konfiguration)(nodisp und folded klappt aber auch nicht). (**-**)
  * Alternativ zu folded? Nach Folded-Abschnitt bleibt der Block zu Überschrift dazügehörig, man kann also weiterschreiben. Wird stattdessen statt folded-Abschnitt eine Subüberschrift verwendet, beendet diese den durch die vorherige Überschrift angeführten Block! Kombinationen möglich, häufiger Wechsel typografisch fragwürdig.
  * Eine Besonderheit von Section Toggle sollte sein, dass auch eingeklappte Überschriften durch Links aufrufbar sein sollten, sodass diese augeklappt dargestellt werden: [[playground:todos#sammlung_stichpunkte|Testsprung zu Sammlung Stichpunkte]]\\ Funktionstest => klappt so noch nicht.  ggf. rtfm :?: (**-**)
  * Unterschriften wie hier ''weitere Themen'', die nur mit zwei == codiert sind, liegen in der aktuellen Konfiguration außerhalb des Toggle-Fokus (getestete Grenze: h5). Das führt dazu, dass solche Überschriften und nachfolgende Bereich bis zur nächsten getoggelten Überschrift nicht eingeklappt werden. => Problematisch bzgl. bisheriger Strukturen. (**-**)
  * In der Vorschau vom DokuWiki merkt man die Wirkung von Section Toggle noch nicht... (**-**)
  * Konfigurierbar ist, ob Section Toggle für die Struktur des TOC-Einklappungen beachten soll oder nicht: \\ Hab es mal dort deaktiviert, mal aktiviert => konnte noch keinen Unterschied erkennen (**-**).
  * Steht nach der Überschrift direkt eine neue Überschrift, gibt es also nichts zum Einklappen, setzt Section Toggle auch keine Einklappung für die übergeordnete Überschrift. (**+**)
  * Die Symboldateien für chevron up und chevron down sollten wir ggf. noch weiter anpassen. (**+/-**)\\ Ich habe ich schon ein Probesetting vor ein paar Wochen erstellt, was wohl nur noch integriert werden muss.
  * Alles aufklappen gibt es als Schalter: ~~stoggle_buttons~~ ...  (**+**)
  * Kombination Section Toggle-Überschrift und direkt nach Überschrift Plugin mit <nowiki>++++|</nowiki> ist typographisch nicht gut, alles Ein-/Ausklappen funktioniert aber auch in 'versteckt' getoggelten Bereichen -> klipp klapp ;-)  (**+/-**)  
<WRAP>
++++klipp klapp| 
====== Überschrift H0? ======
no toggle please!
===== Überschrift H1 =====
no toggle please?
=====test h2=====
dsfsdf
====test h3====
sfgsg
=== test h4 ===
sdfs
== h5 ==
oha
++++
</WRAP>
====== Test sectiontoggle Header h1 ======
Parameter beachten! ++Einstellungen im Adminbereich|h2-h4 toggled?!++
===== 1. first section h2=====
Lorem ipsum dolor sit amet, consetetur ''sadipscing'' elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. 
  - Choose register  ''Parameter'' .
  - Configure the parameters.
  - Click save-button or strg+s.

==== 1.1 Significance of the fields h3 empty ====
=== 1.1.1 subset h4 ===
Some text in a paragraph followed by at table.
^ Field ^ Description ^
| min | First number of selected range. |
| max | Last nunber of selected range. |
| dbegin | Date, picked from calendar or direct input ddmmyyyy.\\ Start of periods. |
| dend | Date, picked from calendar or direct input ddmmyyyy.\\ End of period. |

== minorsubset h5 ==
At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

===== 2. next section h2 =====
At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua.
  * Choose register  ''Parameter2'' .
  * Configure the additional parameters.
  * Click save-button or strg+s.

Absatz 2 At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua Absatz2 Ende.

==== 2.1 Significance of the fields===
=== 2.1.1 datarange ===
^ Field ^ Description ^
| template | number of template. |
| all | Checkbox\\ [x] All datasets will be used.\\ [ ] Dataset defined by ''nbegin'' - ''nend''|
| nbegin | Number of first dataset. |
| nend | Number of last dataset.|

===== 3. next section h2 =====
nix niente nada rien nothing ingen ting

== Mail an den Autor ==
++++|
//Hello,

I’m considering to use the sectiontoggle plugin in dokuwiki to compress the first view of pages in an operating instruction, because of a high number of subtitles. Using include-template I create pages with combined content. It first seemed to be the best tool to manage folded sections. But I found, that only the paragraphs after the heading are toggled up to the subordinated header. Is there any configuration to trigger sectiontoggle to fold the whole section in between up to the next header, that is triggered for sectiontoggle?

Maybe you can give me a hint for a solution?//
++++

Workarounds: 
++++| 
Anstatt
==lkjsldfj== 
**lkjsldfj**\\  Nachteil: nicht mit Link adressierbar - es sei denn man verwendet hiddenheader s. u.   


hiddenheader : => https://www.dokuwiki.org/plugin:hiddenheader

Mit diesem Plugin können Sie eine Abschnittsüberschrift erstellen, die nicht auf der Seite erscheint. Warum sollten Sie das jemals tun wollen? Hauptsächlich, um mit Plugins zu arbeiten, die Abschnitte betreffen. Sie können es auch verwenden, um den Seitentitel zu setzen, ohne eine sichtbare Überschrift zu haben, aber das Meta-Plugin macht das besser.

Ich habe dies als Ergänzung zum Include-Plugin gemacht. Mit Include können Sie eine Seite oder einen Abschnitt einfügen, aber es fehlt eine Funktion, die ich für sehr nützlich halte - die Möglichkeit, einen Ausschnitt aus einem großen Dokument einzufügen, der nicht mit Abschnittsüberschriften versehen ist. Übersetzt mit www.DeepL.com/Translator (kostenlose Version)

== Examples/Usage ==

Once the plugin is installed, you can create section headers with the special tag "%hide" in the title. The reference for the header is whatever comes after %hide. For example:

<nowiki>====%hide myhidden ====</nowiki>

In this case, the header will not show up in your page, but it will still be possible to link to pagename#myhidden (as with the [[https://www.dokuwiki.org/plugin:anchor|anchor plugin]]). Additionally, other plugins will recognize this as a section called "myhidden." For example, using the ''Include'' plugin, you can include the contents of this section as follows:

<nowiki>{{section>mypage#myhidden}}</nowiki>

Make sure to end the section, by starting a new section. This can be done with another hidden section, or with an empty section header: <nowiki>==== ====</nowiki>

Here's a complete example:
  This page is called "mypage."
  ====%hide myhidden====
  This text will show up if you use the include plugin on this section -- {{section>mypage#myhidden}}.
  ==== ====
  This text will not show up when using the include plugin.


== ==
This plug-in has one more use: Creating a title for a page that should not have a visible section header. For example, if you create the following as the first section in the page, wiki links to that page will show up with the header text as the title.

This: <nowiki>====%hide My Magic Page ====</nowiki>

in a page called somens:mypage causes this: <nowiki>[[somens:mypage]]</nowiki> to show up like this: My Magic Page.

Note that the [[https://www.dokuwiki.org/plugin:meta|meta plugin]] does this invisible-title thing better, but if you're already using this plugin and don't want to install meta, you might as well take advantage of the feature.
++++