Zuletzt bearbeitet vor einem Jahr
von Margit Link-Rodrigue

Handbuch:Vorlagen und Referenz:SubPageList: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
VisuellWikitext
Keine Bearbeitungszusammenfassung
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
<bookshelf src="Buch:Benutzerhandbuch" />
{{BSExtensionInfobox
==Was ist eine Vorlage?==
|desc=Erstellen und zählen von Unterseiten.
|status=stable
|developer=Jeroen De Dauw
|type=MediaWiki
|edition=BlueSpice free, BlueSpice pro, BlueSpice Farm, BlueSpice Cloud
|active=Yes
|compatible=MediaWiki
|category=Organisation
|license=GPL v2+
|docu=https://www.mediawiki.org/wiki/Extension:SubPageList
}}
Die Erweiterung '''SubPageList''' ermöglicht es, Unterseitenlisten zu erstellen. Es kann sowohl die Tag-Erweiterung <subpages /> als auch die Parserfunktion {{#subpages: }} verwendet werden. Diese nehmen dieselben Paramter an und verhalten sich identisch.


<section begin="training-intro" />


Eine Vorlage stellt im Wiki wiederverwendbaren Inhalt bereit. Dieser wird dann in zahlreiche Seiten des Wikis eingebunden. Die Vorlage kann inhaltsbasiert (Textvorlage) oder strukturbasiert (Layoutvorlage) oder eine Kombination aus beiden sein. 
===Beispiele===
Auflisten der Unterseiten der aktuellen Seite mit Standardeinstellungen:


Ein typisches Beispiel ist eine Infobox, die auf allen Seiten identisch aussieht formatiert ist. Auf den Wikiseiten wird dann der jeweilige Inhalt hinzugefügt. <section end="training-intro" />
<syntaxhighlight lang="text">{{#subpages:}}</syntaxhighlight>
[[Datei:Handbuch:vorlage.png|alternativtext=Beispiel einer Infobox-Vorlage|zentriert|mini|750x750px|Beispiel einer Infobox-Vorlage]]
Unterseiten für Seite "MyAwesomePage" auflisten:


<syntaxhighlight lang="text">{{#subpages:MyAwesomePage}}</syntaxhighlight>
Unterseiten als Aufzählungsliste auflisten:


Eine Vorlage kann auch als Quelle für eine [[Referenz:BlueSpicePageTemplates|Seitenvorlage]] verwendet werden.
<syntaxhighlight lang="text">{{#subpages:format=ol}}</syntaxhighlight>
Vollständige Seitennamen, die nicht verlinkt sind:


==Eigenschaften einer Vorlage==
<syntaxhighlight lang="text">{{#subpages:pathstyle=full|links=no}}</syntaxhighlight>
Merkmale einer Vorlage:<!-- Übertragen in Schulungsunterlagen! -->
<section begin="training" />
*[[Datei:Handbuch:vorlage-beispiel.png|alternativtext=Quelltextansicht einer eingebundenen Vorlage|mini|400x400px|Quelltextansicht einer eingebundenen Vorlage]]ermöglicht das Einfügen von wiederverwendbaren Inhalten mit einem Platzhalter (Transklusion)
*befindet sich normalerweise im Namensraum "Vorlage"
*kann Parameter haben
*enthält oft Logik
*wird verwendet, um ein "Look and Feel" beizubehalten
<section end="training" />
==Eine Vorlage erstellen und einbinden==
Eine neue Vorlage wird immer im Namensraum Vorlage erstellt.


Eine Vorlage wird in eine Seite eingefügt, indem der Name der Vorlage im Quelltext in zwei geschweifte Klammern gesetzt wird: <code><nowiki>{{NotificationBox}}</nowiki>.</code> Die Vorlage kann auch direkt über die Editorleiste eingefügt werden.


==Eine Vorlage bearbeiten==
Die Vollständige Benutzerdokumentation finden Sie auf: https://github.com/JeroenDeDauw/SubPageList/blob/master/doc/USAGE.md (Englisch)
Änderungen an einer Vorlage wirken sich auf alle Seiten aus, die diese Vorlage enthalten. Bevor Sie vorhandene Vorlagen ändern, sollten Sie überprüfen, auf welchen Seiten die Vorlage verwendet wird. Um diese Seiten zu finden, klicken Sie in den Seitenwerkzeugen auf <code>...alle Aktionen > Links auf diese Seite</code>.
{{translation}}
 
==Eingebaute Variablen==
Jedes MediaWiki hat eine Reihe von [[Handbuch:Erweiterung/BlueSpiceInsertMagic|eingebaute Variablen]], die keine Seiten im Namensraum "Vorlage" sind, aber dennoch als Vorlagen verwendet werden.
 
Beispielsweise gibt die Variable <tt><nowiki>{{CURRENTTIME}}</nowiki></tt> die aktuelle UTC-Zeit zurück.
 
==Parameter über TemplateData beschreiben==
Die MediaWiki-Erweiterung [[Handbuch:Erweiterung/TemplateData|TemplateData]] erlaubt es, die Vorlagen-Parameter so zu beschreiben, dass sie von Benutzern im Visual Editor leicht über ein Formular bearbeitet werden können.
 
==Vorlage formatieren==
Wenn eine Vorlage besonders formatiert werden soll, z.B. mit Hintergrundfarbe, Textabstand oder besonderer Schriftformatierung, kann dies über MediaWiki:Common.css erreicht werden. Die Formatierungen sind somit für andere Vorlagen mehrfach verwendbar. Sind die Formatierung speziell auf diese Vorlage beschränkt, werden sie über eine Unterseite der Vorlage über das Tag [[Handbuch:Erweiterung/TemplateStyles|TemplateStyles]] angelegt. Dies hat zum Vorteil, dass die Stilvorgaben zusammen mit der Vorlage leicht exportiert und in ein anderes Wiki importiert werden können.
 
==Weitere Hinweise==
 
*Die Verwendung einer Vorlage ist im Grunde eine [[mediawikiwiki:Transclusion/de|Transklusion]]. Es ist auch möglich, Seiten als Vorlagen zu verwenden, die sich nicht im Namensraum "Vorlage" befinden. Dies sollte jedoch mit Bedacht erfolgen, da einige Funktionen erfordern, dass sich die Seiten im Vorlagen-Namensraum befinden.
*Vorlagen können auch verwendet werden, um die Ausgabe von [https://www.semantic-mediawiki.org/wiki/Help:embedded_query semantic query] zu definieren. Weitere Informationen finden Sie unter [https://www.semantic-mediawiki.org/wiki/Help:Template_format Semantic MediaWiki]. (Dies ist ein Beispiel, bei dem sich die Seiten unbedingt im Vorlagen-Namensraum befinden müssen.)
*Die vollständige Liste aller Seiten des Wikis, die sich in diesem Namensraum befinden, finden Sie auf der Seite <code>Spezial:Vorlagen</code>.
{{Box_Links | Thema1 = https://meta.wikimedia.org/wiki/Help:Template| Thema2 = https://www.mediawiki.org/wiki/Help:Templates/de| Thema 3= https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions | Thema4 = }}
[[de: {{FULLPAGENAME}}]]
[[en: Manual:Templates]]
[[Category:Inhalt]]
[[Category:Organisation]]

Version vom 4. Juli 2022, 13:57 Uhr

Erweiterung: SubPageList

alle Erweiterungen

Übersicht
Beschreibung: Erstellen und zählen von Unterseiten.
Status: stable Abhängigkeit: MediaWiki
Entwickler: Jeroen De Dauw Lizenz: GPL v2+
Typ: MediaWiki Kategorie: Organisation„Organisation“ befindet sich nicht in der Liste (-, Administration, Buchfunktion, Kommunikation, Inhaltliche Strukturierung, Datenanalyse, Dokumentenmanagement, Editor, Export, Infrastruktur, ...) zulässiger Werte für das Attribut „BSExtensionInfoCategory“.
Edition: BlueSpice free, BlueSpice pro, BlueSpice Farm, BlueSpice Cloud Version:
Mehr Infos auf: Mediawiki.

Funktionen / Anwendung[Bearbeiten | Quelltext bearbeiten]

Die Erweiterung SubPageList ermöglicht es, Unterseitenlisten zu erstellen. Es kann sowohl die Tag-Erweiterung "" has no sub pages. als auch die Parserfunktion "" has no sub pages. verwendet werden. Diese nehmen dieselben Paramter an und verhalten sich identisch.


Beispiele[Bearbeiten | Quelltext bearbeiten]

Auflisten der Unterseiten der aktuellen Seite mit Standardeinstellungen: 

{{#subpages:}}

Unterseiten für Seite "MyAwesomePage" auflisten: 

{{#subpages:MyAwesomePage}}

Unterseiten als Aufzählungsliste auflisten: 

{{#subpages:format=ol}}

Vollständige Seitennamen, die nicht verlinkt sind: 

{{#subpages:pathstyle=full|links=no}}


Die Vollständige Benutzerdokumentation finden Sie auf: https://github.com/JeroenDeDauw/SubPageList/blob/master/doc/USAGE.md (Englisch)

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.



Feedback zur Dokumentation ist im Community-Forum möglich.

Abgerufen von „https://de.wiki.bluespice.com/w/index.php?title=Handbuch:Vorlagen&oldid=5012“

Diskussionen