Version vom 10. März 2026, 12:43 Uhr von Margit Link-Rodrigue (Diskussion | Beiträge)
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}}
|
| BlueSpiceBookshelf | Buch-Inhaltsverzeichnis
v4.4+ |
Liste aller oder einzelner Kapitel eines Buches |
<booknav book="Admin-Handbuch" chapter="1" /> |
| BlueSpiceBookshelf | Bücherliste | Bücherliste, gefiltert auf einen Metadatenwert |
<booklist filter="Author:WikiSysop" /> |
| Math | 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 | |
| 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>Administration</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 |
<toplist count="3" period="-" /> |
| ContentDroplets | Meldung | Farbiger Block zur Texthervorhebung |
{{Textbox|boxtype=neutral|header=|text=Beispieltext|icon=no}}
|
| UserFunctions | Mitgliederliste | Liste aller Benutzer in einer Wiki-Gruppe |
<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}}
|
| ChatIntegration | MS-Teams Link v5.2+ | Grafischer Link zu einem MS-Teams-Chat | |
| BlueSpiceSmartList | Neue Benutzer | Liste der neuen Benutzer im Wiki |
<newbies count="4" /> |
| ContentDroplets | 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 eines vorhandenen BPMN-Diagramms |
<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" /> |
| ChatIntegration | 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 |
<tagsearch type="wikipage" namespace="QM" /> |
| ContentDroplets | Symbol | Fügt ein Symbol ein |
{{Icon|bi bi-arrow-left-circle}}
|
| ContentDroplets | 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 |
<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> |
| ContentDroplets | Warnmeldung | Farbiger Block zur Texthervorhebung |
{{Textbox|boxtype=warning|header=Achtung!|text=Text der Meldung|icon=yes}}
|
| ContentDroplets | 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. |
<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> |
