Modul:DokuTools/Doku
Dies ist die Dokumentationsseite für Modul:DokuTools
Zweck[Quelltext bearbeiten]
Das Modul stellt kleine Hilfsfunktionen für Dokumentationsseiten bereit. Aktuell enthält es eine Funktion, um Links zur Cirrus-Suche zu erzeugen, die alle Seiten anzeigt, welche die aktuelle Vorlage/Seite transkludieren.
Dies ist vor allem in Dokumentations- oder Wartungskontexten nützlich, z. B. vor Änderungen an Vorlagen oder Modulen.
Verfügbare Funktionen[Quelltext bearbeiten]
transcludesUrl()- Gibt die reine URL zur Cirrus-Suche zurück.
- Ergebnis kann direkt in Vorlagen oder Modulen weiterverwendet werden.
transcludesLink- Gibt einen formatierter Link zurück.
- Eignet sich für die direkte Einbindung in Dokumentations- und Footerboxen.
Nutzung[Quelltext bearbeiten]
Das Modul unterstützt sowohl die Ausgabe als einen kompletten, anpassbaren Link, als auch die Ausgabe der eigentlichen „Helferfunktion“ um nur die URL — zum Beispiel für die Weiterverwendung in einem Button oder komplexeren Vorlagen zu ermöglichen.
Ausgabe eines Links[Quelltext bearbeiten]
{{#invoke:DokuTools|transcludesLink}}
Das Standardlabel „Einbindungen suchen“ wird gesetzt.
Optional kann das Label angepasst werden:
{{#invoke:DokuTools|transcludesLink|label=Verwendungen anzeigen}}
Nutzung ohne Link (nur URL)[Quelltext bearbeiten]
{{#invoke:DokuTools|transcludesUrl}}
Technische Hinweise[Quelltext bearbeiten]
- Wenn die Dokumentationsseite den Suffix
/Dokuträgt, wird dieser automatisch entfernt. - Die Namensraumbezeichnung wird berücksichtigt (z. B.
Vorlage:Name,Modul:Name). - Die erzeugte Cirrus-Suchanfrage nutzt
hastemplate:.
Siehe auch
- Modul:Dokumentation – Hauptmodul für Dokumentationen
- Vorlage:Dokumentation – Vorlage zur Verwendung des Dokumentationsmoduls