Hilfe:Wiki

Aus HL7 Austria MediaWiki
Version vom 23. April 2018, 13:09 Uhr von Lahnsteiner (Diskussion | Beiträge) (Einbetten von Websites)
Wechseln zu: Navigation, Suche


1 How to Wiki

  1. Navigation durch das Wiki
  2. Textformatierung
  3. Links
  4. Bilder
  5. Tabellen
  6. CSS Formatierung
  7. SEO
  8. Vorlagen
  9. Inhaltsverzeichnis


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 Hauptseite 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.2 Textformatierung

Beschreibung Wiki-Code Ausgabe
überall anwendbar
kursiver Text
''kursiv''
kursiv
fetter Text
'''fett'''
fett
fett und kursiv
'''''fett & kursiv'''''
fett & kursiv
roter Text
<span style="color:red">roter Text</span>
roter Text
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======

2 Ebene 1

2.1 Ebene 2

2.1.1 Ebene 3

2.1.1.1 Ebene 4

2.1.1.1.1 Ebene 5
2.1.1.1.1.1 Ebene 6
Horizontale Linie
Text
----
Mehr Text

Text


Mehr Text

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.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]
Externer Link ohne Namen auf dem gleichen Server [http://{{SERVERNAME}}/seitenname] [2]
Interwiki Link [[Wikipedia:MediaWiki]] Wikipedia:MediaWiki
Interwiki Link mit abweichendem Text [[Wikipedia:MediaWiki|Beschreibungstext]] Beschreibungstext
Interwiki Link (zur deutschsprachigen Wikipedia) [[Wikipedia:de:MediaWiki]] Wikipedia:de:MediaWiki
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

2.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)

[[File:Example.jpg|Sonnenblumen]]

Sonnenblumen

Link zu einer Bildseite

[[:File:Example.jpg]]
[[:File:Example.jpg|Sonnenblumen]]

File:Example.jpg
Sonnenblumen

direkter Link zur Bilddatei

[[Media:Example.jpg]]
[[Media:Example.jpg|Sonnenblumen]]

Media:Example.jpg
Sonnenblumen

Thumbnail
(zentriert, 100 Pixel
breite, mit Beschriftung)

[[File:Example.jpg|center|thumb|100px|Sonnenblumen]]

Datei:Example.jpg
Sonnenblumen

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]]

2.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:

  • 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.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:

2.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.

2.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.

2.6 Einfache Tabelle

2.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
{|
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis  
|}

2.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
{|
|  Orange    ||   Apfel   ||   more
|-
|   Brot    ||   Torte     ||   more
|-
|   Butter   || Eis ||  and more
|}

2.6.3 Mit HTML-Eigenschaften

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

2.6.3.1 border="1"

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

2.6.3.2 align="center" border="1"

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

2.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.

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
|}

2.6.3.4 cellspacing="0" border="1"

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

2.6.3.5 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.6.4 Mit HTML-Eigenschaften und CSS-Definitionen

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

2.6.4.1 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 
|}

2.6.4.2 class="wikitable"

Bitter Süß
Orange Apfel
Brot Torte
Butter Eis
{| class="wikitable"
!Bitter
!Süß
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

2.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.

2.7.1 Tabellenkopf

2.7.1.1 pro Spalte

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

2.7.1.2 Colspan="2"

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

2.7.2 seitliche Überschrift

2.7.2.1 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 
|}

2.7.2.2 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 
|}

2.8 Beschriftung

Eine Tabellenbeschriftung kann wie folgt über jeder Tabelle hinzugefügt werden:

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

Eigenschaften können der Beschriftung wie folgt zugewiesen werden:

Essenssachen
Orange Apfel
Brot Torte
Butter Eis
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Essenssachen''
|-
|Orange
|Apfel
|-
|Brot
|Torte
|-
|Butter
|Eis 
|}

2.9 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.9.1 Yummiest

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

2.10 CSS

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

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

2.11 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.

2.11.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.11.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.12 Vorlagen

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

2.12.1 Bekannte Vorlagen

2.12.1.1 YellowBox

Wird für themenbezogene Hinweise zur besonderen Beachtung verwendet.

Text

Code:
{{BeginYellowBox}}
Text
{{EndYellowBox}}

2.12.1.2 ILFBox

Wird als Hinweis auf andere Implementierungsleitfäden verwendet.

Text

Code:
{{BeginILFBox}}
Text
{{EndILFBox}}

2.12.1.3 OrangeBox

Wird für themenbezogene CDA-Beispiel-fragmente im XML Format verwendet.

Text

Code:
{{BeginOrangeBox}}
Text
{{EndOrangeBox}}

2.12.1.4 ValueSet Box

Verweist auf ELGA Value Sets.

Text

Code:
{{BeginValueSetBox}}
Text
{{EndValueSetBox}}

2.12.1.5 Informationsbox /Errata Box

Verweist auf bekannte Fehler und geplante Verbesserungen.

Info.png
Überschrift
Text
Code:
{{Informationsbox|Überschrift|Text}}


2.13 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;
}
}}

2.14 Reiter-Logo ändern

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

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

2.15 Einbetten von 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}}