Leitfaden erstellen mit Mediawiki

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Die folgende Hilfeseite bietet Wiki-Einsteigern Informationen über das Arbeiten mit Wiki.
Hier ein Überblick über die verschiedenen Themen:

1 Einführung

HL7 Austria setzt sich zum Ziel in diesem Wiki alle relevanten Themen bezüglich eHealth Standards im österreichischen Gesundheitswesen der Gemeinschaft bereitzustellen. Da diese Themen Fachkenntnisse erfordern, hat man sich entschieden, den Betrachtern der Seite die Ansichtsversion zur Verfügung zu stellen, jedoch nicht die Bearbeitungsfunktion.

Um Beiträge bearbeiten zu können, ist es erforderlich ein Benutzerkonto zu beantragen: Benutzerkonto beantragen

Werden die Kriterien erfüllt, wird das Benutzerkonto bestätigt.

Um Art-Decor Templates bearbeiten zu können, wenden Sie sich bitte an: office@hl7.at

1.1 Navigation durch das Wiki

Die Sidebar auf der linken Seite des Browsers ist die Werkzeugleiste des Wiki. Hier finden sich schnelle Links zu verschiedenen Themen.

Weiters bietet die Startseite einen Überblick über alle Themen.

1.1.1 Sidebar anpassen

Anpassungen können nur eingeloggte Admins vornehmen. Zum Ändern der Sidebar navigieren Sie auf die Seite MediaWiki:Sidebar und gehen Sie in den Bearbeitungsmodus.

Überschriften werden erstellt mit einem vorangestelltem * Stern. Diese sind nicht verlinkt und dienen nur der Übersicht.

Links erstellen Sie auf der zweiten Ebene mit zwei vorangestellten ** Sternen.

1.1.2 Reiter-Logo ändern

In der LocalSetting.php ist in folgender Zeile die Bilddatei zu ändern:

$wgLogo = $wgScriptPath . '/images/4/47/mylogo.png';

2 Mediawiki Grundlagen

2.1 Neue Wiki-Seite erstellen

Um eine neue Wiki-Seite zu erstellen, muss auf einer bestehenden Seite ein interner Link erstellt werden (siehe auch nächstes Kapitel #Webseiten_verlinken).

[[NeueSeite]]

Sollen sich der Text des Links und der Seitenname unterscheiden, muss folgender Code benutzt werden:
[[NeueSeite | Sichtbarer Text]]

Nach dem Speichern des Artikels wird der Link auf der Seite angezeigt. Existiert die verlinkte Seite schon, erscheint der Link in blauer Schrift. Gibt es die Seite nicht, wird der Text in rot dargestellt. Links auf die selben Artikel werden fett dargestellt aber nicht als Link.

Der erste Buchstabe des Links wird automatisch großgeschrieben. Leerzeichen werden in einen Unterstrich (_) umgewandelt. Man kann den Unterstrich auch selbst einsetzen, dieses wird aber nicht empfohlen.

2.1.1 Verwendung von Namespaces

Wenn die Seite noch nicht angelegt wurde, kann von einer bestehenden Seite aus mit folgender Syntax eine Seite in einem Namespace (siehe nächstes Kapitel) angelegt werden:

//Neue Seite wird im Namespace ILF angelegt
[[ILF:NeueSeite]]

Wenn die Seite bereits erstellt wurde, kann die Seite unter dem Reiter "Mehr" mit "Verschieben" in den gewünscht Namespace verschoben werden. Einfach (statt Artikel) den gewünschten Namespace auswählen und bestätigen.

2.2 Namespace/Namensraum

Jeder Leitfaden gehört zu einem Namespace, z.B. elga-cdaps-2.06.2 für das Patient Summary. Darüberhinaus gibt es auch den allgemeinen Namespace ILF (Implementierungsleitfäden), der alle Leitfäden vereint. Wenn eine Seite in eine Hauptseite eingebunden werden soll, muss die Unterseite einem Namensraum zugehören.

Weitere Namespaces müssen im LocalSettings.php angelegt werden.

Der Namespace Name darf keine Bindestriche enthalten, der Titel aber schon!

// Define constants for additional namespaces.
define("NS_ILF", 3000); // This MUST be even.
define("NS_ILF_DISKUSSION", 3001); // This MUST be the following odd integer.
define("NS_elga_cdaps2062", 3002); // This MUST be even.
define("NS_elga_cdaps2062_DISKUSSION", 3003); // This MUST be the following odd integer.
// Add namespaces.
$wgExtraNamespaces[NS_ILF] = "ILF";
$wgExtraNamespaces[NS_ILF_DISKUSSION] = "ILF_Diskussion";
$wgExtraNamespaces[NS_ elga_cdaps2062] = " elga-cdaps-2.06.2";
$wgExtraNamespaces[NS_ elga_cdaps2062_DISKUSSION] = " elga-cdaps-2.06.2_Diskussion";

Im Generellen ist die Struktur der Namensräume folgendermaßen aufgebaut:

elga-cda | Abkürzung des Titels des Leitfadens | Version

Jeder Leitfaden gehört zu seinem eigenen Namespace und zum Namespace ILF. z.B. der Leitfaden für das Patient Summary gehört auch zu elga-cdaps-2.06.2 und ILF

Alle Seiten zu allgemeinen Kapiteln, die für alle Leitfäden gleich sind, gehören zum Namespace ILF.

Alle Seiten zu spezifischen Kapiteln, die nur für diesen Leitfaden gelten, gehören zum Namespace des spezifischen Leitfadens z.B. elga-cdaps-2.06.2.

Werden Seiten zu Kapitel aus anderen Leitfäden übernommen, so gehören sie zum Namespace des anderen Leitfadens.

2.2.1 Neuen Namespace anlegen

Um weitere Namensräume anzulegen, müssen diese in den LocalSettings.php definiert und eingefügt werden.

// Define constants for additional namespaces.
define("NS_ILF", 3000); // This MUST be even.
define("NS_ILF_DISKUSSION", 3001); // This MUST be the following odd integer.
odd integer.
// Add namespaces.
$wgExtraNamespaces[NS_ILF] = "ILF";
$wgExtraNamespaces[NS_ILF_DISKUSSION] = "ILF_Diskussion";

Der neue Namensraum muss in der FlaggedRevs.php (Verzeichnis: extensions/FlaggedRevs/FlaggedRevs.php) eingefügt werden, ansonsten kann man Seiten, die diesem Namensraum angehören, nicht flaggen. Hierfür die FlaggedRevs.php öffnen und die Zahl, die für den Namespace vergeben wurde, nach an letzter Stelle des Arrays einfügen:

# Allowed namespaces of reviewable pages
$wgFlaggedRevsNamespaces = [ NS_MAIN, NS_FILE, NS_TEMPLATE, 3000, 3002, 3004, 3006, 3008, 3010, 3012, 3014, 3016, 3018, 3020, 3030, 3032, 3034, 3036, 3038, 3040, 3042, 3044, 3046, 3048, 3050];

2.3 Benutzerdefinierter Seitentitel

Ermöglicht das Ändern des Seitentitels mittels:

{{#customtitle:Neuer Titel}}

2.4 Kategorien

Um eine Seite zu einer Kategorie hinzuzufügen, bearbeiten Sie die Seite und fügen den folgenden Text ein:

[[Kategorie:Name]]

Am Ende der Seite werden Links generiert, welche zu einer Übersicht über alle Seiten der gleichen Kategorie führen.
Kategorien existieren, auch wenn deren Seite noch nicht erstellt wurde.

Kategorien ermöglichen eine einfache Durchsuchung von verwandten Artikeln.

Um Unterseiten wieder zu finden sollten sie einer Kategorie zugeordnet werden.

2.5 Webseiten verlinken

In der MediaWiki gibt es verschiedene Arten Webseiten zu verlinken. Es gibt interne Links, externe Links zu anderen Webseiten und InterWiki Links in andere Wikis oder andere Sprachbereiche eines Wikis.

Beschreibung Wiki Code Ausgabe
Interner Link [[Seitenname]] Seitenname
Interner Link mit abweichendem Text [[Seitenname|Beschreibungstext]] Beschreibungstext
Interner Link mit Sprungmarke
(Sprungmarken oder Anker werden automatisch für alle Überschriften und den Seitenanfang #top angelegt)
[[Help:Links#Internal links|Beschreibung auf Englisch]] Beschreibung auf Englisch
Externer Link http://mediawiki.org http://mediawiki.org
Externer Link mit abweichendem Text [http://mediawiki.org MediaWiki] MediaWiki
Externer Link ohne Namen [http://mediawiki.org] [1]
Interwiki Link [[Wikipedia:MediaWiki]] Wikipedia:MediaWiki
Interwiki Link mit abweichendem Text [[Wikipedia:MediaWiki|Beschreibungstext]] Beschreibungstext
Link zu einer Kategorie [[:Kategorie:Kategoriename]] Kategorie:Kategoriename
Link zu einer Kategorie mit abweichendem Text [[:Kategorie:Kategoriename|Beschreibungstext]] Beschreibungstext
Interner Link zu einer Bilddatei [[Bild:Beispiel.jpg]] Datei:Beispiel.jpg
Interner Link zu einer Bilddatei mit abweichendem Text [[Bild:Beispiel.jpg|Beschreibungstext]] Beschreibungstext
Interner Link zu einer PDF Datei [[Media:Beispiel.pdf]] Media:Beispiel.pdf
Interner Link zu einer PDF Datei mit abweichendem Text [[Media:Beispiel.pdf|Beschreibungstext]] Beschreibungstext
Mailto-Link [mailto:info@example.org email me] email me
Umleitung auf eine andere Seite #REDIRECT [[Hauptseite]] Hauptseite

2.6 Einbetten von externen Websites

Über die Extention IDisplay werden externe Seiten in die Wikiseite eingebettet.

Code:

{{#iDisplay:URL|WIDTH|HEIGHT|SAFE}} 
Beispielcode:
{{#iDisplay:https://www.hl7.at|1000px|1300px}} 


2.7 Inhaltsverzeichnis

2.7.1 Inhaltsverzeichnis ausblenden

Um das Inhaltsverzeichnis auszublenden, folgenden Code verwenden:
__NOTOC__

2.7.2 Inhaltsverzeichnis einschränken

Um den Umfang eines Inhaltsverzeichnisses einzuschränken, können die darin angezeigten Überschriften auf eine bestimmte Tiefe eingeschränkt werden.

Beispiel: Anzeige aller Überschriften bis Ebene 3 (im Quelltext dargestellt mit === Überschrift ===):

{{TOC limit|4}}

Voraussetzung ist, dass eine entsprechende Vorlage existiert. Ist dies nicht der Fall muss diese erstellt werden:

  • Im Suchfenster: „TOC limit“ eingeben und neue Seite erstellen.
  • Den folgenden Text in den Quelltext der Seite kopieren (Vorlagen sind auch normale Seiten):
<div class="toclimit-{{{1|{{{limit|3}}}}}}">__TOC__</div>

Weiters muss die Common.css Datei entsprechend angepasst worden sein. Hierzu „MediaWiki:Common.css“ in die Suchmaske eingeben und den folgenden Text hinzufügen:

/* Allow limiting of which header levels are shown in a TOC;  
<div class="toclimit-3">, for instance, will limit to
 showing ==headings== and ===headings=== but no further.
 */
 .toclimit-2 .toclevel-2,
 .toclimit-3 .toclevel-3,
 .toclimit-4 .toclevel-4,
 .toclimit-5 .toclevel-5,
 .toclimit-6 .toclevel-6,
 .toclimit-7 .toclevel-7 { display: none; }

Um das Ergebnis zu testen, muss das Wiki neu geladen werden (STRG+F5).

2.7.3 Rechtsausgerichtetes Inhaltsverzeichnis

Das Inhaltsverzeichnis kann auf der rechten Seite des Bildschirms angezeigt werden. Dazu einfach folgenden Code in der Seite einbinden:

{{ILF-TOC limit}}

Es kann ebenso wie mit TOC limit die Tiefe des Inhaltsverzeichnisses eingeschränkt werden.

Beispiel: Anzeige aller Überschriften bis Ebene 2 (im Quelltext dargestellt mit == Überschrift ==):

{{ILF-TOC limit|3}}

Wird die Vorlage ILF-TOC limit ohne Parameter verwendet, werden standardmäßig die ersten 3 Ebenen des Inhaltsverzeichnisses dargestellt.

Voraussetzung ist, dass eine entsprechende Vorlage existiert. Ist dies nicht der Fall muss diese erstellt werden:

  • Im Suchfenster: „ILF-TOC limit“ eingeben und neue Seite erstellen.
  • Den folgenden Text in den Quelltext der Seite kopieren (Vorlagen sind auch normale Seiten):
{{#css:
@media screen {
  .toc {
    width: 20%;
    float: right !important;
    margin: 10px 0px 10px 30px !important;
    border: 1px solid #AAA;
    background-color: #F9F9F9;
    display: table;
    padding: 7px !important;
  }
}
}}

{{TOC limit|{{{1|4}}}}}

2.8 PDF-Generierung

Für die Generierung eines PDF-Dokuments aus einer Wikiseite wird das Tool

PRINCE 11 , free for non-commercial use (https://www.princexml.com/download/)

verwendet. Die Version wird lokal auf dem Benutzerrechner gespeichert und das EXE-File aus dem Filesystem heraus aufgerufen.

Die Quelle für das Dokument ist immer das Wiki.

Es kommen drei Stylesheets zur Anwendung:

= Stylesheet für das Aussehen des MediaWikis am Bildschirm
= elgaspezifisches Stylesheet

Alle nötigen Parameter können beim Programmstart via Skript mitgegeben werden.

Inhalt eines Beispiel-Batchfiles (.bat) für Wiki-Druck des Allgemeinen Leitfadens 2020 (abgenommene Version / "stable Version" / "Lese-Ansicht"): (die Pfade sind entsprechend anzupassen):
"C:\Program Files (x86)\Prince\engine\bin\prince" "https://wiki.hl7.at/index.php?title=ILF:Allgemeiner_Implementierungsleitfaden_2020" -v --javascript -o "C:\Users\User_x\Downloads\ILF_ALF_2020.pdf" -s "http://wiki.hl7.at/index.php?title=MediaWiki:Common.css&usemsgcache=yes&ctype=text%2Fcss&smaxage=18000&action=raw&maxage=18000" -s "http://wiki.hl7.at/index.php?title=-&action=raw&maxage=18000&gen=css" -s "http://wiki.hl7.at/index.php? title=MediaWiki:Geshi.css&usemsgcache=yes&action=raw&ctype=text/css&smaxage=18000" -s "https://wiki.hl7.at/extensions/ELGA-Prince/elga.css"

Beispiel-Skript für Wiki-Druck den des Allgemeinen Leitfadens 2020 - Revisions-Version (die Pfade sind entsprechend anzupassen, hier muss zusätzlich zu dem Leitfaden-Link "&stable=0" angegeben werden):
"C:\Program Files (x86)\Prince\engine\bin\prince" "https://wiki.hl7.at/index.php?title=ILF:Ambulanzbefund&stable=0" -v --javascript -o "C:\Users\User_x\Downloads\ILF_AMB_2020.1_Revsion.pdf" -s "http://wiki.hl7.at/index.php?title=MediaWiki:Common.css&usemsgcache=yes&ctype=text%2Fcss&smaxage=18000&action=raw&maxage=18000" -s "http://wiki.hl7.at/index.php?title=-&action=raw&maxage=18000&gen=css" -s "http://wiki.hl7.at/index.php? title=MediaWiki:Geshi.css&usemsgcache=yes&action=raw&ctype=text/css&smaxage=18000" -s "https://wiki.hl7.at/extensions/ELGA-Prince/elga.css"

2.8.1 Seitenumbruch (PDF)

Ein Seitenumbruch für eine PDF-Version/Prince kann eingefügt werden über

<p style="page-break-before: always"></p>

2.8.2 Seitenausrichtung (PDF)

Die Ausrichtung einer Seite kann im PDF auf quer geändert werden durch

<div class="landscape"> ... </div>

Optionen: "landscape" | "portrait"

2.9 Suchmaschinenoptimierung

Metadaten sind Informationen im Quelltext einer Website, die an Suchmaschinen und Social Media übermittelt werden. Sie sind oftmals nicht direkt in den Inhalten der Website sichtbar, werden dafür aber als Vorschau der Website in Google, Bing, Facebook und Twitter dargestellt.

Da die Metadaten auch Rankingfaktoren zur Suchmaschinenoptimierung sind, ist es wichtig, für Seitenbetreiber und Firmeninhaber diese zu optimieren und optimierte Daten zu identifizieren.

2.9.1 Code

{{#seo:
|title=Entlassungsbrief (Ärztlich)
|titlemode=append
|keywords=Entlassungsbrief, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten
|description=Ein Entlassungsdokument enthält die medizinisch relevanten Teile der Geschichte eines Patienten und ist für den Informationsaustausch zwischen Gesundheitsdienstleistern bestimmt. 
}}

2.9.2 Regeln

  • Meta Titel
    • ist das wichtigste Element
    • Länge in der Regel: 55 Zeichen
  • Meta Description
    • ist eine kurze Vorschau oder Einleitung zu Ihrer Website
    • wird auf Google bei dem Suchergebnis abgebildet
    • Länge 155 Zeichen
  • Doppelte Metadaten vermeiden!

2.10 Versionierung von Wiki-Seiten

Die Versionierung erfolgt über Flagged Revisions und Namespaces. Dies ermöglicht es, Seitenversionen zu markieren sowie eine stabile (Reiter "Lesen") und current Seitenversion (Reiter "Revision") festzulegen. Die Seiten werden abschließend von so genannten Sichtern freigegeben.

2.11 Formatierungen

2.11.1 Text

Beschreibung Wiki-Code Ausgabe
überall anwendbar
kursiver Text
''kursiv''
kursiv
fetter Text
'''fett'''
fett
fett und kursiv
'''''fett & kursiv'''''
fett & kursiv
Unterbinden des Wiki-Markup
<nowiki>kein ''Markup''</nowiki>
kein ''Markup''
Markieren von Text als Quelltext, Dateiname, Pfad, Kommando
<code>Quelltext</code>
Quelltext
nur am Beginn einer neuen Zeile anwendbar
Überschriften

in verschiedenen Grössen

=Ebene 1=
==Ebene 2==
===Ebene 3===
====Ebene 4====
=====Ebene 5=====
======Ebene 6======
Ebenen.PNG
ungeordnete Liste
* erste Zeile
* zweite Zeile
* dritte Zeile
**  dritte Zeile, erster Unterpunkt
**  dritte Zeile, zweiter Unterpunkt
  • erste Zeile
  • zweite Zeile
  • dritte Zeile
    • dritte Zeile, erster Unterpunkt
    • dritte Zeile, zweiter Unterpunkt
geordnete Liste
# erste Zeile
# zweite Zeile
# dritte Zeile
## dritte Zeile, erster Unterpunkt
## dritte Zeile, zweiter Unterpunkt
  1. erste Zeile
  2. zweite Zeile
  3. dritte Zeile
    1. dritte Zeile, erster Unterpunkt
    2. dritte Zeile, zweiter Unterpunkt
Definitionsliste
;Definition
:Beschreibung 1
:Beschreibung 2
Definition
Beschreibung 1
Beschreibung 2
Vorformatierter Text
 ein Leerzeichen am
 Anfang einer Zeile
 erstellt ein solches
 Textfeld
ein Leerzeichen am
Anfang einer Zeile
erstellt ein solches
Textfeld
Vorformatierter Textblock
 <nowiki>
Ein Leerzeichen vor dem Tag <nowiki> stellt
den Text so dar, wie er getippt wurde.
Ideal für Codeblöcke:
  void power (double d) {
    return d * d;
  }
</nowiki>
   Ein Leerzeichen vor dem Tag <nowiki> stellt
   den Text so dar, wie er getippt wurde.
   Ideal für Codeblöcke:
     void power (double d) {
       return d * d;
     }
   

2.11.2 Bilder

Normalerweise würde man erst ein Bild in das Wiki hochladen bevor man folgenden Wikitext verwendet, um das Bild im Artikel einzubinden. Alternativ zu File: kann auch Datei: verwendet werden.

Beschreibung Wiki Code Ausgabe
Eingebettetes Bild
(mit alt Text)

[[File:Under construction icon-blue.png|Sonnenblumen]]

Sonnenblumen

Link zu einer Bildseite

[[:File:Under construction icon-blue.png]]
[[:File:Under construction icon-blue.png|Sonnenblumen]]

File:Under construction icon-blue.png
Sonnenblumen

direkter Link zur Bilddatei

[[Media:Under construction icon-blue.png]]
[[Media:Under construction icon-blue.png|Sonnenblumen]]

Media:Under construction icon-blue.png
Sonnenblumen

Thumbnail
(zentriert, 100 Pixel
breite, mit Beschriftung)

[[File:Under construction icon-blue.png|center|thumb|100px|Sonnenblumen]]

Sonnenblumen

Um ein Bild oder eine andere Datei einbinden zu können, die hochgeladen wurde, verwenden Sie:

  • [[File:Example.jpg]]

Wenn Sie einen Hochstrich (|) und Text nach dem Dateinamen eingeben, wird der Text als alternativer Text für nur Text Browser verwendet. Notwendig ist diese Angabe jedoch auch für ein barrierefreies Internet zum Beispiel für Menschen mit Sehbehinderung.

  • [[File:Example.jpg|alternative Text]]

Falls das Bild nicht angezeigt werden soll, kann ein direkter Link auf die Bildbeschreibungsseite, durch Hinzufügen eines Doppelpunktes, erfolgen.

  • [[:File:Example.jpg]]

Um die Bild Beschreibungsseite zu umgehen und direkt zu der Datei zu verlinken, muss der Pseudo Namespace "Media" verwendet werden.

  • [[Media:Example.jpg]]

Alternativ kann auch ein abweichender Text angezeigt werden.

  • [[:File:Example.jpg|link text]]
  • [[Media:Example.jpg|link text]]

2.11.2.1 Erweiterte Optionen

Die komplette Syntax um ein Bild anzuzeigen ist:

[[File:{name}|{options}]]

Optionen müssen nicht gewählt werden. Bei mehreren müssen diese mit vertikalen Strichen getrennt werden:

  • thumb oder thumbnail, frame: steuert wie ein Bild formatiert wird
  • left, right, center, none: steuert die Ausrichtung eines Bildes auf der Seite
  • {width}px: passt die Grösse entsprechend der gegebenen Breite an (Beispiel: [[Bild:logo.jpg|80px]])
  • {caption text}

Die Optionen können in jeder beliebigen Reihenfolge stehen. Wenn eine eingegebene Option nicht mit den aufgeführten übereinstimmt, wird diese als Untertitel verwendet. Untertitel können Links oder andere Formatierungen enthalten.

2.11.3 Abbildungsverzeichnis einfügen

Das Bild wird mit folgendem Code zur Referenzgruppe Abbildung hinzgefügt:

  • [[Datei:Beispiel.png| 400px|Beispiel für Abbildungsverzeichnis]]
  • <ref group="Abbildung">Beispielbild</ref>

Im Anhang ein Kapitel Abbilung erstellen mit:

  • ==Abbildungen==
  • <references group="Abbildung"/>

2.11.4 Literaturverzeichnis einfügen

Beispiel, wenn die Quelle das erste Mal eingefügt werden soll:

  • [... ]Er enthält alle aktuellen, nationalen Impfempfehlungen und den damit verbunden Impfintervallen und Impfschemata, als auch die Liste an Impfungen, die ins kostenlose Kinderimpfkonzept <ref name=Kinderimpfkonzept> Bundesministerium Arbeit, Soziales, Gesundheit und Konsumentenschutz [Online Juli 2018]: https://www.sozialministerium.at/site/Gesundheit/Krankheiten_und_Impfen/Impfen/Kostenloses_Kinderimpfkonzept. </ref>fallen. [...]

Bei jedem weiteren Mal kann die Quelle so angegeben werden:

  • [... ]Das kostenlose Kinderimpfkonzept <ref name=Kinderimpfkonzept/> hat zum Ziel, allen in Österreich lebenden Kindern bis zum 15. Lebensjahr Zugang ...

Im Anhang ein Kapitel Literaturverzeichnis erstellen mit:

  • ==Literaturverzeichnis==
  • <references/>

2.11.5 Galerie mit Bildern

Es ist recht einfach eine Bildergalerie mit Miniaturansichten zu erstellen. Die Syntax hierfür lautet: <gallery> File:{dateiname}|{Beschreibung} File:{dateiname}|{Beschreibung} {...} </gallery>

Zum Beispiel wird

 <gallery>
    File:Example.jpg|Item 1
    File:Example.jpg|a link to [[Help:Contents]]
    File:Example.jpg
    File:Example.jpg|''italic caption''
    </gallery>

wie folgt ausgegeben:


Weitere Informationen unter Wikipedia Hilfe Bilder

2.11.6 Tabellen

Tabellen können in Media Wiki Seiten entweder direkt mit HTML Tabellenelementen geschrieben werden oder mit dem Wikicode. HTML Tabellenelemente und ihr Gebrauch werden auf verschiedenen Webseiten beschrieben und deshalb hier nicht besprochen. Der Wikicode nutzt Buchstabensymbole um die Tabellenstruktur im Artikel zu bilden, die in der Ansicht durch HTML Tabellenelemente ersetzt werden.

Generell sollte man die Verwendung von Tabellen vermeiden, außer es geht wirklich nicht anders. Der Tabellenaufbau verkompliziert meist das Bearbeiten von Seiten.

2.11.6.1 Zusammenfassung Wiki-Tabellen-Code

Wiki Code vgl. HTML- Code Beschreibung
{| <table> Tabellenanfang
|+   Tabellenüberschrift, optional; nur einmal pro Tabelle zwischen Tabellenanfang und erster Zeile definierbar
|- <tr> neue Tabellenzeile
! <th> Tabellenkopfzelle, optional. Aufeinanderfolgende Kopfzellen können, durch doppelte Ausrufezeichen (!!) getrennt, in der gleichen Zeile folgen oder mit einfachen Ausrufezeichen (!) auf einer neuen Zeile beginnen.
| <td> Tabellenzelle, Pflicht! Aufeinanderfolgende Zellen können, durch doppelte Striche (||) getrennt, in der gleichen Zeile folgen oder mit einfachem Strich (|) auf einer neuen Zeile beginnen.
|} </table> Tabellenende
  • Die angegebenen Zeichen müssen am Zeilenanfang stehen, ausgenommen die Doppelten || und !! für optional aufeinanderfolgende Zellen in einer Zeile.
  • XHTML - Eigenschaften. Jede Markierung, außer das Tabellenende, kann optional eine oder mehrere XHTML-Eigenschaften haben. Die Eigenschaften müssen in der gleichen Zeile eingegeben werden, für die sie auch gültig sind. Mehrere Eingaben müssen mit einem Leerzeichen getrennt eingegeben werden.
    • Der Inhalt von Zellen und Überschriften (| oder ||, ! oder !!, und |+) muss von der Formatierung mit einen Strich (|) getrennt sein und kann in der gleichen und folgenden Zeilen stehen.
    • Tabellen, Spalten und reihen ({| und |-) die nicht direkt einen Inhalt haben können, dürfen auch keinen Strich (|) nach den Attributen haben. Falls doch einer gesetzt wird entfernt der Parser diese und das letzte Attribut, falls zwischen ihm und dem Strich kein Leerzeichen ist.
  • Inhalt kann (a) nach seiner Zellenmarkierung nach den optionalen XHTML-Eigenschaften in der gleichen Reihe stehen oder (b) unter der Zellenmarkierung. Inhalt, welcher Wiki Formatierung (wie Überschriften, Aufzählungen usw.) nutzt, muss am Anfang einer neuen Zeile stehen.

2.11.6.2 Beispiele für Tabellen

2.11.6.2.1 Einfache Form

Die folgende Tabelle hat keine Ränder oder gute Leerräume. Sie zeigt aber den einfachen Wiki Code für eine Tabellenstruktur

Anzeige in Wiki Wiki Code
Orange Apfel
Brot Torte
Butter Eis
{|
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis  
|}
  • Alternative Form

Für ein mehr tabellarisches Aussehen können im Wiki Markup die Zellen in einer Zeile aufgeführt werden. Die einzelnen Spalten müssen dabei mit || getrennt werden. Jedoch nimmt die Übersichtlichtkeit mit steigendem Textinhalt ab.

Leerzeichen können hier helfen, um den Text optisch einfacher auszurichten. Diese haben später keinen Einfluss auf die erstellten Seiten.

HTML Angaben können bei dieser Art genauso hinzugefügt werden wie in anderen Tabellen.

Orange Apfel more
Brot Torte more
Butter Eis and more
{|
|  Orange    ||   Apfel   ||   more
|-
|   Brot    ||   Torte     ||   more
|-
|   Butter   || Eis ||  and more
|}
2.11.6.2.2 Tabelle mit HTML-Eigenschaften

Durch das Hinzufügen von HTML-Eigenschaften lässt sich das Aussehen der Tabelle verändern.

border="1"

Orange Apfel
Brot Torte
Butter Eis
{| border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

align="center" border="1"

Orange Apfel
Brot Torte
Butter Eis
{| align="center" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

align="right" border="1"

Eigenschaften lassen sich auch auf individuelle Zellen anwenden. Zahlen zum Beispiel sehen besser aus, wenn sie rechtsbündig stehen.

Orange Apfel 12,333.00
Brot Torte 500.00
Butter Eis 1.00
{| border="1"
|Orange
|Apfel
|align="right"|12,333.00
|-
|Brot
|Torte
|align="right"|500.00
|-
|Butter
|Eis
|align="right"|1.00
|}

Man kann Eigenschaften auch auf nur bestimmte Zeilen anwenden.

Orange Apfel 12,333.00
Brot Torte 500.00
Butter Eis 1.00
{| border="1"
|Orange
|Apfel
|align="right"|12,333.00
|-
|Brot
|Torte
|align="right"|500.00
|- style="font-style:italic;color:green;"
|Butter
|Eis
|align="right"|1.00
|}

cellspacing="0" border="1"

Orange Apfel
Brot Torte
Butter Eis
{| cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

cellpadding="20" cellspacing="0" border="1"

Orange Apfel
Brot Torte
Butter Eis
{| cellpadding="20" cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}
2.11.6.2.3 Tabelle mit HTML-Eigenschaften und CSS-Definitionen

CSS-Angaben können in Kombination mit oder ohne HTML-Eigenschaften verwendet werden.

style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"

Orange Apfel
Brot Torte
Butter Eis
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

class="wikitable"

Bitter Süß
Orange Apfel
Brot Torte
Butter Eis
{| class="wikitable"
!Bitter
!Süß
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}
2.11.6.2.4 Tablenüberschriften
  • TH-Kopfzeile

TH (HTML-Tabellenkopf) kann mit einem ! vor dem | erstellt werden. Diese Kopfzeile erscheint für gewöhnlich in fett und zentriert. Tabellenkopf pro Spalte

lecker leckerer
Orange Apfel
Brot Torte
Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
!lecker
!leckerer
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

Colspan="2"

leckerer
Orange Apfel
Brot Torte
Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|leckerer
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

seitliche Überschrift (standardmäßig)

Obst Orange Apfel
Hauptspeise Brot Torte
Zutaten Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
!Obst
|Orange
|Apfel
|-
!Hauptspeise
|Brot
|Torte
|-
!Zutaten
|Butter
|Eis 
|}

rechtsbündig

Seitliche Überschriften können wie folgt rechtbündig angeordnet werden:

Obst Orange Apfel
Hauptspeise Brot Torte
Zutaten Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Obst
|Orange
|Apfel
|-
!align="right" |Hauptspeise
|Brot
|Torte
|-
!align="right" |Zutaten
|Butter
|Eis 
|}
  • Tabellen mit H1, H2, H3 usw. Überschriften

Überschriften mit dem HTML-Tag H1, H2, H3, H4 usw. können auch in Tabellen mit dem üblichen ==Wiki Markup== erstellt werden. Diese müssen dann in einer Zeile mit dem Text stehen.

Hier ist die Vorschau sehr von Vorteil! da mit jeder Kopfzeile ein neuer Abschnitt beginnt, der später editierbar sein wird. Jedoch werden dann Teile der Tabelle beim Bearbeiten fehlen, da diese in einem anderen Abschnitt stehen.

Auch muss die Struktur eingehalten werden, da die Überschriften genauso wie andere Überschriften in das Inhaltsverzeichnis eingehen.

2.11.6.2.5 Yummiest
Orange Apfel
Brot Torte
Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===Yummiest===
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

2.11.7 Vorlagen

Unter folgendem Link finden Sie alle existierenden Vorlagen: https://wiki.hl7.at/index.php?title=Spezial%3APr%C3%A4fixindex&prefix=&namespace=10

2.11.7.1 YellowBox

Wird für themenbezogene Hinweise zur besonderen Beachtung verwendet.

Text

Code:

{{BeginYellowBox}}
Text
{{EndYellowBox}}

2.11.7.2 ILFBox

Wird als Hinweis auf andere Implementierungsleitfäden verwendet.

Text

Code:

{{BeginILFBox}}
Text
{{EndILFBox}}

2.11.7.3 Code-Beispiele

Wird für korrekte CDA-Beispielfragmente im XML Format verwendet.

Text

Code:

<pre class="ilfbox_code">
Text
</pre>

2.11.7.4 ValueSet Box

Verweist auf ELGA Value Sets.

Text

Code:

{{BeginValueSetBox}}
Text
{{EndValueSetBox}}

2.11.7.5 Informationsbox /Errata Box

Verweist auf bekannte Fehler und geplante Verbesserungen.

Info.png
Überschrift
Text

Code:

{{Informationsbox|Überschrift|Text}}

2.11.8 CSS

Um benutzerdefinierte Formatierungen ins Wiki einzubinden, kann dies mittels folgendem Code realisiert werden:

{{#css:
//Hier kann der CSS Code eingefügt werden
}}

3 Leitfaden erstellen mit Mediawiki

3.1 Aufbau eines Implementierungsleitfadens

Ein Implementierungsleitfaden teilt sich in einen technischen und einen textlichen Teil auf. Der technische Teil ist für den Leser nicht sichtbar und beinhaltet folgende Angaben:

Optional stehen folgende Funktion bereit:

Der textliche Teil eines Wiki Leitfadens, beinhaltet den eigentlichen Inhalt(/Beschreibung) eines Implementierungsleitfaden. Implementierungsleitfäden sind sehr lange Dokumente und umfassen meist mehrere Hundert A4-Seiten. Deshalb kann es sinnvoll sein, das Hauptdokument in Teildokumente zu unterteilen. Die Summe der Teildokumente ergibt somit einen Leitfaden.

Hauptdokument Das Hauptdokument bildet den eigentlichen Leitfaden im Wiki ab und ist in verschiedene Abschnitte eingeteilt. Diese Abschnitte sind im Wiki sogenannte Teildokumente die in Summe den gesamten Leitfaden abbilden. Um die Teildokumente in das richtige Hauptdokument zu transkludieren, müssen dies ebenfalls dem Namensbereich "ILF" zugeordnet sein. Teildokumente werden im Hauptdokument folgendermaßen eingebunden:

{{ILF:Danksagung}}

Teildokument Die Teildokumente enthalten den wiederverwendbare Textteile und müssen ebenfalls dem Namensbereich "ILF" zugeordnet werden.

3.1.1 Infobox

Jeder Leitfaden hat eine Infobox, die alle zur Erstellung der Druckversion im PDF Format notwendigen Informationen enthält. Sie ist in der Online-Version nicht sichtbar.

{{Infobox Dokument
|Group     = ELGA GmbH<br/>Leitfaden zur Verwendung von LOINC<sup>®</sup>
|Title     = im ELGA CDA<sup>®</sup> R2 Laborbefund
|Subtitle  = Zur Anwendung im österreichischen<br/>Gesundheitswesen [1.2.40.0.34.10.1]
|Short     = Leitfaden zur Verwendung von LOINC 
|Namespace = elga-loinc-1.03
|Type      = Implementierungsleitfaden
|Version   = 1.03
|Submitted = HL7 Austria
|Date      = 07. Februar 2017
|Copyright = 2017-2021
|Status    = Gültig
|Period    = n.a.
|OID       = n.n.
|Realm     = Österreich
}}

Für die Erstellung des PDF-Dokuments werden die Werte für Group, Title, Subtitle, Date, Version und Status übernommen. Die anderen Felder werden zurzeit nicht genutzt.

3.1.2 In Bearbeitung/UnderConstruction

Um den Leser darauf hinzuweisen, dass dieser Leitfaden noch in Bearbeitung ist, muss die Vorlage „Underconstruction“ verwendet werden. Damit wird die Wiki-Seite visuell als „In Bearbeitung“ gekennzeichnet:

{{Underconstruction}}

3.1.3 Strukturbeispiele

Für die Strukturbeispiele bitte die jeweils entsprechenden Vorlagen verwenden.

3.1.4 Vollständiges Beispiel eines Implementierungsleitfadens

Beispiel:

{{#seo:
|title=Entlassungsbrief (Ärztlich)
|titlemode=append
|keywords= Entlassungsbrief,Entlassungsbrief Ärztlich,Ärztlicher Entlassungsbrief,CDA, Leitfaden, Leitfäden, Spezielle Leitfäden, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten
|description=Ein Entlassungsdokument enthält die medizinisch relevanten Teile der Geschichte eines Patienten und ist für den Informationsaustausch zwischen Gesundheitsdienstleistern bestimmt. 
}}
{{#customtitle:Entlassungsbrief (Ärztlich)}}

{{Underconstruction}}
 <!--

         Implementierungsleitfaden "Entlassungsbrief (Ärztlich)"
 >

{{#css:
@media screen{
.orange{
   border: thin black solid;
   background-color:#F4C789;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.violet{
   border: thin black solid;
   background-color:#E5D0EE;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.toc{
    width: 20%;
    float: right !important;
    margin: 10px 0px 10px 30px !important;
    border: 1px solid #AAA;
    background-color: #F9F9F9;
    display: table;
    padding: 7px !important;
}
}
}}

{{Infobox Dokument
|Group     = ELGA CDA<br/>Implementierungsleitfäden
|Title     = HL7 Implementation Guide for CDA<sup>®</sup> R2:<br/>Entlassungsbrief (Ärztlich)
|Subtitle  = Zur Anwendung im österreichischen<br/>Gesundheitswesen [1.2.40.0.34.7.1.6.2]
|Short     = Entlassungsbrief (Ärztlich) 
|Namespace = elga-cdaea-2.06.2
|Type      = Implementierungsleitfaden
|Version   = 2.06.2
|Submitted = HL7 Austria
|Date      = 20. März 2017
|Copyright = 2017-2021
|Status    = Entwurf
|Period    = n.a.
|OID       = n.n.
|Realm     = Österreich
}}

 <!--
{{Infobox Contributors Begin}}
{{Contributor | Logo = Logo.jpg | Name = Abc | Location = Hürth }}
{{Infobox Contributors End}}
 >

=Informationen über dieses Dokument=
{{ILF:Allgemeines}}
{{ILF:Verbindlichkeit}}
{{ILF:Zielgruppe}}
{{ILF:Hinweis auf verwendete Grundlagen}}
{{ILF:Danksagung}}
{{ILF:Hinweise zur Nutzung des Leitfadens}}
.
.
.

3.2 Versionierung von Leitfäden

Die Versionierung der Leitfäden erfolgt über den Namespace und Flagged Revision.

3.3 Verlinkung von Leitfäden

Innerhalb der Leitfäden werden häufig Abschnitte desselben oder von anderen Leitfäden verlinkt. Dabei müssen folgende Regeln eingehalten werden:

  • Links, die zu Abschnitten innerhalb desselben Leitfadens führen, müssen in dem Format [#Abschnitt|alternativer Text] angegeben werden. Dadurch ist es für eine neue Hauptversion möglich, den Wiki-Quelltext einfach in eine neue Seite zu kopieren, ohne die Links zu den Abschnitten anpassen zu müssen.
  • Links zu anderen Leitfäden müssen auf die entsprechende Hauptversion gesetzt werden (z.B. [[ILF:Allgemeiner Implementierungsleitfaden 2020#Wichtige unterstützende Materialien|alternativer Text]]).
    • Grundsätzlich sollte darauf geachtet werden, dass sich Leitfäden nicht gegenseitig referenzieren. Dh. eine Kette/Hierarchie wäre zulässig, zirkuläre Referenzen nicht.
  • Eine Überprüfung der Links für jeden Leitfaden sollte vor der Veröffentlichung vorgenommen werden (z.B. kann im Wiki-Quelltext nach [[ gesucht werden). Alternative Vorschläge dafür sind gerne willkommen.

Zu beachten: jede neue Hauptversion erhält eine eigene neue Wiki-Seite (z.B. Allgemeiner_Implementierungsleitfaden_2020 bzw. die nächste Hauptversion Allgemeiner_Implementierungsleitfaden_2022).

3.4 Art-Decor Templates einbinden

Die Templates für den Leitfaden werden in ArtDecor modelliert (https://art-decor.org/art-decor/decor-templates--at-cda-bbr-?section=templates bzw. im entsprechenden Art-Decor-Projektrepository), mittels eines Bots ins Wiki übertragen und in den Leitfaden transkludiert. Die Identifizierung der Templates erfolgt über ihre OID, über die sie auch als Wikiseite aufgerufen werden können.

Für die Transklusion gibt es zwei Möglichkeiten:
1. Einbinden eines Art-Decor Templates dynamisch
Die dynamische Möglichkeit stellt sicher, dass immer das Template der letzten Version eingebunden ist. Somit werden Änderungen im Art-Decor im Wiki Leitfaden automatisch mittels eines Bots nachgezogen. Eingebunden können Templates bei dynamischer Verwendung durch folgenden Code:

{{:OID-NR/dynamic}}
Beispiel Rehabilitationsziele:
{{:1.2.40.0.34.11.2.2.26/dynamic}}

2. Einbinden eines Art-Decor Templates statisch (Zeitstempel): Die statische Möglichkeit sieht vor eine bestimmten Version des Templates anhand des Zeitstempels einzubinden. Der Code hierfür lautet:

{{:OID-NR/static-Datum-Zeit}}
Beispiel eMedikationRezept:
{{:1.2.40.0.10.1.4.3.4.1.1.1/static-2013-12-16T000000}}

Jedes Template besteht also sozusagen aus verschiedenen Versionen (Static Versionen) und über einen redirect (dynamic) wird auf die aktuellste Version des Templates verwiesen.