Referenz

MagicWords
 

Einführung[Bearbeiten | Quelltext bearbeiten]

Magische Wörter („Magic Words“) sind ein zentrales Konzept in MediaWiki. Sie ermöglichen es, auf einfache Weise dynamische Inhalte, Metadaten oder Systeminformationen in Wiki‑Seiten einzubauen.

Sie werden in verschiedenen Formen verwendet:

  • Tags
  • Parserfunktionen
  • Variablen
  • Verhaltensumschalter
Verfügbarkeit von Tags und Parserfunktionen:Je nach Version und Wiki-Installation können verschiedene Tags und Parserfunktionen in Ihrem Wiki verfügbar sein. Prüfen Sie hierzu die Seite Spezial:Version in Ihrem Wiki. Die Tags und Parserfunktionen sind am Ende der Seite aufgelistet.


Präfix "bs"[Bearbeiten | Quelltext bearbeiten]

In älteren BlueSpice Versionen wurden Tags häufig mit Präfix bs eingebunden (z.B. <bs:tagcloud>). Diese Tags funktionieren noch, sind aber veraltet und fast immer ersetzt durch das Tag ohne Präfix (z.B. <tagcloud>).

Die folgende Dokumentation führt die Tags ohne Präfix auf, außer es existiert kein entsprechendes Tag.

MediaWiki Verhaltensschalter, Variablen und Parserfunktionen[Bearbeiten | Quelltext bearbeiten]

Eine Vielzahl von Verhaltensschaltern, Variablen und Parserfunktionen werden durch MediaWiki bereitgestellt.

Diese sind auf folgender Seite dokumentiert:

https://www.mediawiki.org/wiki/Help:Magic_words/de

Liste der Content-Droplets[Bearbeiten | Quelltext bearbeiten]

BlueSpice Content-Droplets werden entweder als Tags, Parserfunktionen oder Vorlagen eingebunden.

Erweiterung Content-Droplet Beschreibung Beispiel
Anhänge Anhangsbereich für referenzierte Dokumente
<attachments title="Attachments area">
* [[Media:Finanzbeispiel.xlsx]]
</attachments>
BlueSpiceCountThings Anzahl aller Benutzer <countusers />
BlueSpiceCountThings Anzahl aller Dateien Anzahl aller hochgeladenen Dateien <countfiles />
BlueSpiceCountThings Anzahl an Seiten Anzahl der Seiten im Wiki <countarticles />
BlueSpiceCountThings Anzahl an Zeichen Anzahl der Zeichen oder Wörter auf einer Wikiseite <countcharacters />
Anzahl angemeldeter Benutzer Anzahl der aktuell angemeldeten Benutzer <whoisonlinecount />
SimpleTasks Aufgabenbericht

  v4.4+

Übersicht von Aufgaben auf Wikiseiten
<taskreport user="" namespaces="0" status="unchecked"></taskreport>
SimpleTasks Aufgabenliste

  v4.4+

Aufgabe auf einer Wikiseite mit Benutzerzuweisung und optionalem Fälligkeitsdatum
 [ ] Aufgabe 1
 [ ] Aufgabe 2
 [x] Aufgabe 3
UserProfile Benutzerprofil Einbettung der Benutzerprofilinfo auf einer Wikiseite
<user-profile user="WikiSysop" framed="false" orientation="horizontal" fields="" />
BlueSpiceWatchList Beobachtungsliste Liste der Letzten Änderungen an Seiten, die in der Beobachtungsliste enthalten sind <watchlist count="5" maxtitlelength="20" order="time" />
BlueSpiceCountThings Besuchte Seiten Liste mit besuchten Seiten <pagesvisited count="7" maxtitlelength="40" order="time" />
ExternalContent Bitbucket Datei   v5.2+ Inhalte einer Bitbucket-Datei an (wenn nach der Domain der Pfad mit /projects/ beginnt). {{#bitbucket:http://bitbucket.tree-it.de/projects/...|lang=|showLines=|lineNumbers}}
(Vorlage) Buch PDF-Link  v4.4+ Ein Link, um ein Buch als PDF herunterzuladen {{BookPDFLink|book=Testbook|template=BlueSpice%20Book|label=Book PDF Link}}
Buch-Inhaltsverzeichnis

  v4.4+

Liste aller oder einzelner Kapitel eines Buches <booknav book="Admin-Handbuch" chapter="1" />
Bücherliste Bücherliste, gefiltert auf einen Metadatenwert <booklist filter="Author:WikiSysop" />
Chemische Formel Anzeige chemischer Formeln <chem>H2O</chem>
SyntaxHighlight Code Hervorgehobener Codeblock <syntaxhighlight lang="css">

.hi {background:blue;}

</syntaxhighlight>

(Vorlage) Datenabfrage Einfache Abfragen über Semantic MediaWiki {{SMWReport|count=10}}
Datum Formatiertes Datum mit Kalendersymbol <datetime>2023-12-21</datetime>
DrawioEditor Diagramm Draw.io Diagramm zur Erstellung von Fließdiagrammen und anderen Diagrammen <drawio filename="Mydiagram">
(Vorlage) Eingekreiste Zahl Eingekreiste Zahl mit anpassbarer Farbgebung {{CircledNumber|bgColor=black|fgColor=yellow|number=180}}
(Vorlage) Entscheidung Farbiger Block für eine Entscheidung, die als Seiteneigenschaft gespeichert wird {{Decision|decision=Produktübernahme}}
Entscheidungsübersicht

  v4.4+

Übersicht aller Entscheidungen, die über das Droplet "Entscheidung" im Wiki existieren <decisionoverview namespaces="0"></decisionoverview>
(Vorlage) Erfolgsmeldung Farbiger Block zur Texthervorhebung {{Textbox|boxtype=success|header=Erfolg!|text=Es funktioniert|icon=yes}}
ExternalContent Externer Inhalt  v5.2+ Einbetten externer Inhalte wie Markdown-Dateien
BlueSpiceStatistics Fortschritt Visualisiert den Fortschritt anhand vorgegebener Messvariablen <bs:statistics:progress basecount="2" progressitem="OK" width="150" baseitem="Status:" />
(mediawiki) Galerie Zeigt Bilder im Gallerieformat an <gallery>

File:test1.png

File:test.pdf

</gallery>

IssueTrackerLinks GitHub Issue Link   v5.2+ Vorformatierte Link-Schaltfläche zu einem GitHub Issue. {{#embed:https://github.com/../extension.json|lang

|showLines=10}}

IssueTrackerLinks GitLab Issue Link   v5.2+ Vorformatierte Link-Schaltfläche zu einem GitLab Issue. {{#embed:https://gitlab.com/../extension.json|lang

|showLines=10}}

ChatIntegration Google Meet Link  v5.2+ Grafischer Link zu Google Meet <linktogooglemeet url="https://meet.google.com/..."</code>

icon-size="16" show-icon="true" />

In einem Buch suchen Erlaubt es, in einem Buch zu suchen. <searchinbook placeholder="Platzhalter für den Suchtext" book="Buchname" />
Inhalt im PDF ausschließen Inhalte in diesem Abschnitt sind vom PDF-Export ausgeschlossen <pdfexcludestart />Diesen Text nicht exportieren<pdfexcludeend />
ContainerFilter Inhaltsfilter Erlaubt es, Tabellen oder Listen zu filtern. <containerfilter />
IssueTrackerLinks Jira Issue Link  v5.2+ Vorformatierte Link-Schaltfläche zu einem Jira Issue. <issue type="jirapublic" params="repo:akeles;id:PIST-22" />
Karte Orte können auf einer Karte angezeigt werden {{Map|Munich ~ Hallo!|Munich, Germany}}
CategoryTree Kategorienbaum Kategorien werden als Baum angezeigt <categorytree>TestCat</categorytree>
BlueSpiceChecklist Kontrolliste Auswahlmenü, das im Ansichtsmodus aktiviert wird <bs:checklist type="list" checked="true" list="Template:Status" value="Select status" />
BlueSpiceSmartList Letzte Änderungen Liste der zuletzt geänderten Seiten <recentchanges count="6" period="-" sort="time" showns="0" />
BlueSpiceWhoIsOnline Liste angemeldeter Besucher Pop-up Inhalt, der die eingeloggten Benutzer anzeigt <bs:whoisonlinepopup />
Math Mathematische Formel Anzeige von mathematischen Formeln <math>\tfrac{2}{4}</math>
ChatIntegration Matrix Link   v5.2+ Grafischer Link zu einem Matrix-Chat <linktomatrix url="https://matrixurl...." icon-size="16" show-icon="true" />
BlueSpiceSmartList Meistbesuchte Seiten Liste der am meisten aufgerufenen Wikiseiten <bs:toplist count="3" period="-" />
(Vorlage) Meldung Farbiger Block zur Texthervorhebung {{Textbox|boxtype=neutral|header=|text=Beispieltext|icon=no}}
Mitgliederliste Liste aller Benutzer in einer Wiki-Gruppe <bs:userlist groups="sysop" count="6" />
(Vorlage) Modal-Button Konfigurierbare Schaltfläche, die einen anpassbaren modalen Dialog öffnet {{ModalDialog|title=I am a dialog|btnLabel=Klick mich!|body=Das ist der Text|footer=Hallo Welt}}
MS-Teams Link   v5.2+ Grafischer Link zu einem MS-Teams-Chat <code><linktomsteams url=""https://teamsurl...." icon-size="16" show-icon="true" /></code>
Neue Benutzer Liste der neuen Benutzer im Wiki <bs:newbies count="4" />
(Vorlage) Notiz Farbiger Block zur Texthervorhebung {{Textbox|boxtype=note|header=Hinweis:|text=Beispieltext|icon=yes}}
PDFCreator PDF Link Link, der eine andere Wiki-Seite als PDF herunterlädt {{PDFLink|page=Hauptseite|template=BlueSpice|label=PDF Link}}
PDFCreator PDF Seitenumbruch Erzwingt beim PDF-Export einen Seitenumbruch an der festgelegten Position <pdfpagebreak />
PDFCreator PDF-Vorschau Vorschau einer PDF-Datei auf der Wikiseite einbinden <pdf>Datei:Geschäftsbericht.pdf</pdf>
(Vorlage) Pro und Kontra Tabelle zum Vergleich von Vor- und Nachteilen {{ProConList|title-advantages=Advantages|title-disadvantages=Disadvantages|advantages=* Es ist günstig|disadvantages=* Es ist ausverkauft}}
CognitiveProcessDesigner Prozess Einbettung neuer oder vorhandener BPMN-Diagramme <bpmn process="Prozessname" height="300" toolbar="true" />
BlueSpiceQRCode QR Code Fügt einen QR-Code in eine Wikiseite ein <qrcode page="Main Page" size="80" />
Rocket.Chat Link  v5.2+ Grafischer Link zu einem Rocket.Chat-Chat <linktorocketchat url=""https://rocketchaturl...." icon-size="16" show-icon="true" />
(Vorlage) Schaltfläche Als Schaltfläche formatierter Link {{ButtonLink|target=Hauptseite|label=Klick mich!|format=blue}}
Inputbox Seite erstellen Eingabefeld zur Seitenerstellung {{CreateInput|alignment=left|buttonlabel=Create}}
BlueSpicePageAccess Seitenzugriffsberechtigung Beschränkt den Zugriff auf die Seite auf die angegebenen Gruppen <bs:pageaccess groups="sysop" />
ChatIntegration Slack Link

  v5.2+

Grafischer Link zu einem Slack-Chat <linktoslack url=""https://zoomurl...." icon-size="16" show-icon="true" />
BlueSpiceTagSearch Suchfeld Fügt dem Seiteninhalt ein Suchfeld hinzu <bs:tagsearch type="wikipage" namespace="QM" />
(Vorlage) Symbol Fügt ein Symbol ein {{Icon|bi bi-arrow-left-circle}}
(Vorlage) Tipp Fügt ein farbiges Feld für einen Tipp hinzu {{Textbox|boxtype=tip|header=Tip|text=Beispiel text|icon=yes}}
BlueSpiceSignHere Unterschrift Eine Schaltfläche zum Hinzufügen von Signaturen im Ansichtsmodus <bs:signhere />
(Vorlage) Unterseiten Liste der Unterseiten einer Wiki-Seite {{Subpages|parentpage=Meineseite}}
BlueSpiceSmartList Verlinkungen auf diese Seite Liste von Seiten, die auf die aktuelle Seite verlinken <whatlinkshere period="-" sort="time" showns="0" />
EmbedVideo (fork) Video Integriert Videos von verschiedenen Plattformen <embedvideo service="youtube">JILEkPu61Ao</embedvideo>
(Vorlage) Warnmeldung Farbiger Block zur Texthervorhebung {{Textbox|boxtype=warning|header=Achtung!|text=Text der Meldung|icon=yes}}
(Vorlage) Wichtige Meldung Farbiger Block zur Texthervorhebung {{Textbox|boxtype=important|header=Wichtig!|text=Text der Meldung|icon=yes}}
BlueSpiceTagCloud Wortwolke Tag-Cloud basierend auf Kategorien oder Suchanfragen <bs:tagcloud renderer="list" store="category" />
ChatIntegration Zoom Link

  v5.2+

Grafischer Link zu einem Zoom-Chat <linktozoom url=""https://zoomurl...." icon-size="16" show-icon="true" />

Weitere Tags[Bearbeiten | Quelltext bearbeiten]

Diese Tags können direkt im Quelltext eingefügt werden. Es existieren keine Content-Droplets.

Deprecated tags:Tags followed by a (d) annotation are deprecated. They are only used to maintain compatibility with older versions of BlueSpice.
Erweiterung Tags Beschreibung Beispiel
BlueSpiceBookshelf <bookmeta> Tag um beliebige Meta Information zu eine Buchartikel zu speichern. Werden in das Buch mitaufgenommen
<bookmeta someMeta="Some Value" anotherMeta="Another Value"/>
<bookshelf> Wird in BlueSpice 5 nicht mehr benötigt und kann von Seiten gelöscht werden, falls diese das Tag noch beinhalten. Das Tag hat ursprünglich das Buch angezeigt, mit dem die Seite verknüpft war. Seiten können nun in mehreren Büchern existieren. -
BlueSpiceSmartList <infobox> (d), <smartlist> (d) Anzeige der zuletzt geänderten Seiten.
<recentchanges count="5" ns="2" showtext="false" trim="30" trimtext="50" showns="false" sort="time" meta="true" period="-" minor="false" new="false" />
EmbedVideo (fork) <aparat>, <archiveorg>, <bandcamp>, <bilibili>, <ccc>, <dailymotion>, <deezeralbum>, <deezerartist>, <deezerepisode>, <deezerplaylist>, <deezershow>, <deezertrack>,<embedvideo>, <evlplayer>,  <externalvideo>, <kakaotv>, <navertv>,  <niconico>, <podbean>, <sharepoint>, <soundcloud>, <spotifyalbum>, <spotifyartist>, <spotifyepisode>, <spotifyplaylist>, <spotifyshow>, <spotifytrack>, <substack>, <takhtesefid>, <tidalalbum>, <tidalmix>, <tidaltrack>, <tidalvideo>, <twitch>, <twitchclip>, <twitchvod>, <twitchclip>, <twitchvod><videolink>, <vimeo>, <vk>, <vplayer>, <wistia>, <youku>, <youtube>, <youtubeoembed>, <youtubeplaylist>, <youtubevideolist> DSGVO-orientierte Video-Einbettung. Unterstützt unter anderem YouTube, Twitch, Spotify und SoundCloud.
<youtube>https://www.youtube.com/watch?v=eAORm-8b1Eg</youtube>
<embedvideo service="YouTube" alignment="left" title="What's new in BlueSpice 5" description="BlueSpice Lunchtalk" cover="Bild2.png">https://www.youtube.com/watch?v=z3K4A9NPT_c</embedvideo>
<universalexport:exclude>, <bs:universalexport:exclude> (d) Alias für <bs:universalexport:noexport></bs:universalexport:noexport>
<bs:universalexport:excludearticle> Dieses Tag ist nur für den systeminternen Gebrauch bestimmt. Derzeit besitzt es keine Wirksamkeit.
<universalexport:excludearticle>
<bs:universalexport:hidetitle> Unterdrückt die Ausgabe der Artikelüberschrift im Export <bs:uehidetitle />
<universalexport:hidetitle>
<bs:universalexport:meta> Erlaubt die Angabe von beliebigen Meta-Daten, welche, abhängig von der verwendeten Export-Vorlage, im Export-Dokument erscheinen. Abhängig vom Export-Backend werden diese Daten auch in die Meta-Daten des Export-Dokuments übernommen. Wird derzeit hauptsächlich systemintern verwendet. <bs:universalexport:meta Abteilung="Finanzen" Sicherheitslevel="5" />
<universalexport:meta>
<bs:uemeta body-class=Klassenname-hier-einfügen /> Erlaubt die Definition von CSS-Klassen, die nur im PDF-Export angewandt werden. <bs:uemeta body-class=bg-grey no-header-image />
<bs:universalexport:noexport> spart den durch dieses Tag markierten Bereich/Inhalt beim Exportaus <bs:uenoexport>Not included in export</bs:uenoexport>
<universalexport:noexport>
<bs:universalexport:pagebreak> erzwingt einen Seitenumbruch an der Stelle des Tags <bs:uepagebreak />
<universalexport:pagebreak>
<bs:universalexport:params> Ähnlich wie<bs:universalexport:meta></bs:universalexport:meta>, die dort getroffenen Daten beeinflußen aber den Export selbst. Dort kann z.b. ein Export-Template gewählt werden. Auch dieses Tag ist derzeit hauptsächlich für den Systeminternen gebrauch bestimmt. <bs:universalexport:params template="BlueSpice Landscape" />
<universalexport:params>
<bs:wantedarticle> Nachdem Sie einen Artikel vorgeschlagen haben, wird diese auf die Liste der Gewünschten Seiten aufgenommen. Die Liste mit den Gewünschten Seiten können Sie sich über die Spezialseite Gewünschte Seiten anzeigen lassen. Einbinden über den Vorlagen-Mechnismus:

{{WantedArticles}} Es ist auch ein Tag verfügbar, mit sich die Ausgabe konfigurieren lässt:

<nowiki></nowiki>

<bs:wantedarticles>
<bs:wishlist>
<wantedarticle>
<wantedarticles>
<wishlist>
<bs:watchlist> Die Beobachtungsliste ermöglicht es, sich eine komfortable Übersicht über die Änderungen an individuell ausgewählten Seiten anzeigen zu lassen. Beobachtungsliste
<watchlist>
<dynamicpagelist> Erzeugt dynamisch eine Seitenliste. Parameter auf Linksseite auf dieser Seite http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia)
<imagemap> Bild mit anklickbaren Links <imagemap><br /> Bild:Startseite_Wiki.JPG|650px<br /> rect 7 37 186 215 [[Hauptseite|Logo des Wikis]]<br /> rect 11 249 190 365 [[Hilfe:Wiki-Aufbau|Navigationsleiste]]<br /> rect 11 539 192 726 [[Hilfe:Wiki-Aufbau|Werkzeuge.]]<br /> rect 931 4 1070 27 [[Hilfe:Wiki-Aufbau|Suchfeld]]<br /> rect 884 3 917 32 [[Hilfe:Wiki-Aufbau|An- und Abmeldung]]<br /> default [[Hauptseite]]<br /> desc bottom-right<br /> </imagemap>
<nopdf> Der eingegebene Text taucht nicht im PDF-Doument auf. <nopdf>Dieser Text taucht nicht im PDF-Dokument auf.</nopdf>
<nowiki></nowiki> keine Wiki-Formatierung kein Beispiel
<pagetemplates> Seitenvorlagen sind vorgefertigte Muster, die das Erstellen von neuen Seiten erleichtern. Wenn Sie in die Bearbeitungsansicht einer neuen Seite kommen, werden Ihnen die zur Verfügung stehenden Vorlagen als Links aufgelistet. ==Protokoll der Sitzung vom ... ==

* Anwesend: * Abwesend: * Entschuldigt…

<pdfexcludepage> Alias für <bs:universalexport:excludearticle></bs:universalexport:excludearticle>
BlueSpiceHideTitle <pdfhidetitle> Text, der zwischen dem Tag liegt, wird nicht angezeigt
__HIDETITLE__
Cite <ref> Erstellen von Fußnoten
Cite <references> Auflistung der Fußnoten mit Erklärungen
SyntaxHighlight <source> (d)

(vgl. Content-Droplet "Code")

Formatierung von Quellcode-Beispielen
<syntaxhighlight lang="python">
...
</syntaxhighlight>