Inhalt

sectiontoggle Plugin
Test sectiontoggle Header h1

sectiontoggle Plugin

~~stoggle_buttons~~ 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.

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: 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 ++++| ist typographisch nicht gut, alles Ein-/Ausklappen funktioniert aber auch in 'versteckt' getoggelten Bereichen → klipp klapp (+/-)

klipp klapp

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

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:

====%hide myhidden ====

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 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:

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: ==== ====

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: ====%hide My Magic Page ====

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

Note that the 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.