How to Wiki
Die folgende Hilfeseite bietet Wiki-Einsteigern Informationen über das Arbeiten mit MediaWiki.
Hier ein Überblick über die verschiedenen Themen:
Einstieg
1 Beiträge bearbeiten
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:
Werden die Kriterien erfüllt, wird das Benutzerkonto bestätigt.
Um Art-Decor Templates bearbeiten zu können, wenden Sie sich bitte an: stefan.sabutsch@elga.gv.at
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.
2.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.
3 Inhaltsverzeichnis
Um das Inhaltsverzeichnis auszublenden folgenden Code verwenden:__NOTOC__
Um das Inhaltsverzeichnis auf der rechten Seite des Bildschirms anzeigen zu lassen:
{{#css:
.toc{
width: 20%;
float: right !important;
margin: 10px 0px 10px 30px !important;
border: 1px solid #AAA;
background-color: #F9F9F9;
display: table;
padding: 7px !important;
}
}}
4 Benutzerdefinierter Titel
Ermöglicht das Ändern des Seitentitels mittels:
{{#customtitle:Neuer Titel}}
5 Kategorien
Um eine Seite zu einer Kategorie hinzuzufügen, bearbeite die Seite und füge den folgenden Text ein:
[[Kategorie:Name]]
Am Ende der Seite wreden 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.
6 Textformatierung
| 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'' | |
| nur am Beginn einer neuen Zeile anwendbar | |||
| Überschriften in verschiedenen Grössen |
=Ebene 1= ==Ebene 2== ===Ebene 3=== ====Ebene 4==== =====Ebene 5===== ======Ebene 6====== |
7 Ebene 17.1 Ebene 27.1.1 Ebene 37.1.1.1 Ebene 47.1.1.1.1 Ebene 57.1.1.1.1.1 Ebene 6 | |
| ungeordnete Liste |
* 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 |
| |
| Definitionsliste |
;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;
}
| |
7.2 Links
In der MediaWiki gibt es verschiedene Arten von Links. Es gibt interne Links, externe Links zu anderen Webseiten und InterWiki Links in andere Wikis oder andere Sprachbereiche eines Wikis.
Um einen internen Link zu erstellen, muss das zu verlinkende Wort (Wörter) in doppelte eckige Klammern gesetzt werden. 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.
| 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 |
| Umleitung auf eine andere Seite | #REDIRECT [[Hauptseite]]
|
→ Hauptseite |
7.3 Bilder
Normalerweise würdest Du erst ein Bild in das Wiki hochladen bevor Du den folgenden Wikitext verwendest, um das Bild im Artikel einzubinden. Alternative zu File: kann auch Datei: verwendet werden.
| Beschreibung | Wiki Code | Ausgabe |
|---|---|---|
| Eingebettetes Bild (mit alt Text) |
|
|
| Link zu einer Bildseite |
|
|
| direkter Link zur Bilddatei |
|
|
| Thumbnail (zentriert, 100 Pixel breite, mit Beschriftung) |
|
Um ein Bild oder eine andere Datei einbinden zu können, die hochgeladen wurde, verwende:
[[File:Example.jpg]]
Wenn du einen Hochstrich (|) und etwas Text nach dem Dateinamen eingibst, 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]]
7.3.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:
thumboderthumbnail,frame: steuert wie ein Bild formatiert wirdleft,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.
7.3.2 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 File:Example.jpg|''italic caption'' </gallery>
wie folgt ausgegeben:
- Example.jpg
Item 1
- Example.jpg
a link to Help:Links
- Example.jpg
- Example.jpg
- Example.jpg
italic caption
7.4 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.
7.5 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.
7.6 Einfache Tabelle
7.6.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
|}
|
7.6.2 Alternative
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
|}
|
7.6.3 Mit HTML-Eigenschaften
Durch das Hinzufügen von HTML-Eigenschaften lässt sich das Aussehen der Tabelle verändern.
7.6.3.1 border="1"
|
{| border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.6.3.2 align="center" border="1"
|
{| align="center" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.6.3.3 align="right" border="1"
Eigenschaften lassen sich auch auf individuelle Zellen anwenden. Zahlen zum Beispiel sehen besser aus, wenn sie rechtsbündig stehen.
|
{| 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.
|
{| 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
|}
|
7.6.3.4 cellspacing="0" border="1"
|
{| cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.6.3.5 cellpadding="20" cellspacing="0" border="1"
|
{| cellpadding="20" cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.6.4 Mit HTML-Eigenschaften und CSS-Definitionen
CSS-Angaben können in Kombination mit oder ohne HTML-Eigenschaften verwendet werden.
7.6.4.1 style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.6.4.2 class="wikitable"
|
{| class="wikitable"
!Bitter
!Süß
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.7 Table mit TH-Kopfzeile
TH (HTML-Tabellenkopf) kann mit einem ! vor dem | erstellt werden. Diese Kopfzeile erscheint für gewöhnlich in fett und zentriert.
7.7.1 Tabellenkopf
7.7.1.1 pro Spalte
|
{| border="1" cellpadding="20" cellspacing="0"
!lecker
!leckerer
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
|
7.7.1.2 Colspan="2"
|
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|leckerer
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
| ||||||||
7.7.2 seitliche Überschrift
7.7.2.1 standardmäßig
|
{| border="1" cellpadding="20" cellspacing="0"
!Obst
|Orange
|Apfel
|-
!Hauptspeise
|Brot
|Torte
|-
!Zutaten
|Butter
|Eis
|}
|
7.7.2.2 rechtsbündig
Seitliche Überschriften können wie folgt rechtbündig angeordnet werden:
|
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Obst
|Orange
|Apfel
|-
!align="right" |Hauptspeise
|Brot
|Torte
|-
!align="right" |Zutaten
|Butter
|Eis
|}
|
7.8 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.
|
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===Yummiest===
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis
|}
| ||||||||
7.9 Vorlagen
Unter folgendem Link findest du alle existierenden Vorlagen: https://wiki.hl7.at/index.php?title=Spezial%3APr%C3%A4fixindex&prefix=&namespace=10
7.9.1 Bekannte Vorlagen
7.9.1.1 YellowBox
Wird für themenbezogene Hinweise zur besonderen Beachtung verwendet.
|
|
|
7.9.1.2 ILFBox
Wird als Hinweis auf andere Implementierungsleitfäden verwendet.
|
|
|
7.9.1.3 OrangeBox
Wird für themenbezogene CDA-Beispiel-fragmente im XML Format verwendet.
|
|
|
7.9.1.4 ValueSet Box
Verweist auf ELGA Value Sets.
|
|
|
7.9.1.5 Informationsbox /Errata Box
Verweist auf bekannte Fehler und geplante Verbesserungen.
|
|
|
7.10 CSS
Um benutzerdefinierte Formatierungen ins Wiki einzubinden, kann dies mittels folgenden Code realisiert werden:
{{#css:
//Hier kann der CSS Code eingefügt werden
}}
7.11 Strukturbespiel einfügen
Folgender Code ist als CSS einzufügen:
{{#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%;
}
}
}}
Dann im gewünschten Bereich einfügen:
<pre class=“orange“> //Strukturbeispiel </pre>
7.12 SEO
Metadaten sind Informationen im Quelltext Ihrer Website, die an Suchmaschinen und Social Media übermittelt werden. Sie sind oftmals nicht direkt in den Inhalten Ihrer Website sichtbar, werden dafür aber als Vorschau Ihrer 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.
7.12.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.
}}
7.12.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!
7.13 Reiter-Logo ändern
In der LocalSetting.php ist in folgender Zeile die Bilddatei zu ändern:
$wgLogo = $wgScriptPath . '/images/4/47/mylogo.png';
7.14 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}}
