3.869
Bearbeitungen
Änderungen
keine Bearbeitungszusammenfassung
{{#customtitle:HilfeLeitfaden erstellen mit Mediawiki -> Kann gelöscht werden}}==Neue Seite anlegen==Von einer bestehenden Seite aus kann mit folgender Syntax Mit dem Wiki Portal von HL7 Austria wird das Ziel verfolgt, alle Implementierungsleitfäden und dazugehörigen Dokumente, Terminologien, Templates und sonstiges im Wiki verfügbar zu machen. Um einen Leitfaden zu veröffentlichen, ist eine neue Seite angelegt Reihe von Schritten durchzuführen. Die Leifäden bzw. die zugehörigen Teildokumente müssen nach bestimmten Kriterien erstellt werden, um als Leitfäden oder als Teil davon erkannt zu werden: <pre>[[NeueSeite]]</pre><br/>Sollen sich der Text des Links und der Seitenname unterscheiden muss folgender Code benutzt werden: <pre>[[NeueSeite | Sichtbarer Text]]</pre>die Extraktionsmöglichkeit als PDF-Dokument zu ermöglichen.
=Workflow=Erforderlicher Code zu BeginnDie Einbindung eines neuen Leitfadens folgt einem vorgegebenen Prozess, dieser ist ersichtlich unter[[Hilfe:Flagged_Revisions#Benutzung_von_Flagged_Revisions|Workflow]]. =Wiki-Hilfe=Die Wiki Hilfe bietet eine Einführung, wie grundsätzlich mit einem Wiki gearbeitet wird und welche Markups zur Verfügung stehen: [[Hilfe:Wiki|How-to-Wiki]]. =Leitfaden im Wiki erstellen= =Benutzerdefinierter Titel=Aufbau eines Implementierungsleitfadens==Ermöglicht 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:* eine [[#Infobox |Infobox ]]* die Hinweis, dass sich der Leitfaden [[#In_Bearbeitung.2FUnderConstruction|in Bearbeitung]] befindet * [[#Formatierungen|Formatierung]] von Strukturbeispielen und dem Inhaltsverzeichnis* die [[#Kapitelstruktur|trankludierten separat angelegten Abschnitte]] und [[#Namespace|Namespaces]] Optional stehen folgende Funktion bereit:* Vergabe eines [[#Benutzerdefinierter_Titel|benutzerdefinierten Titels]]* [[#SEO|Suchmaschinenoptimierung]] 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 Ändern des Seitentitels mittelsHauptdokument 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 sogenannten 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: <br/><pre>{{#customtitleILF:Neuer TitelDanksagung}}</pre> ===Teildokument===Die Teildokumente enthalten den wiederverwendbare Textteile und müssen ebenfalls dem Namensbereich "ILF" zugeordnet werden. ===Typische Gliederung eines Dokuments===In der Governance zur Erstellung von Leitfadenerstellung wird die [[ART-DECOR_Governance#Typische_Gliederung_eines_Dokuments|Typische Gliederung eines Dokuments]] vorgegeben.
===SEOVollständiges Beispiel eines Implementierungsleitfadens===[[Hilfe:Wiki#SEO|SEO]] ist eine Maßnahme, um das Ranking in Suchmaschinen zu optimieren. <br/>CodeBeispiel:
<pre>
{{#seo:
|title=LOINCEntlassungsbrief (Ärztlich)
|titlemode=append
|keywords= Entlassungsbrief,Entlassungsbrief Ärztlich,Ärztlicher Entlassungsbrief,CDA, Leitfaden, Leitfäden, LOINC, ELGASpezielle Leitfäden, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten|description=Dieser Leitfaden erklärt das Vorgehen beim „Mapping“, Ein Entlassungsdokument enthält die medizinisch relevanten Teile der korrekten Zuordnung von lokalen Laborcodes zu Geschichte eines Patienten und ist für den standardisierten Codes für ELGAInformationsaustausch zwischen Gesundheitsdienstleistern bestimmt.
}}
{{Underconstruction}}
</pre!-- Implementierungsleitfaden "Entlassungsbrief (Ärztlich)" >
{{#css:
@media screen{
}
}}
{{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}}
.
.
.
</pre>
===Benutzerdefinierter Titel===
Ermöglicht das Ändern des Seitentitels mittels:
<pre>
{{#customtitle:Neuer Titel}}
</pre>
===Vorkehrung SEO===[[Hilfe:Wiki#SEO|SEO]] ist eine Maßnahme, um das Ranking in Suchmaschinen zu optimieren. <br/>Code:<pre>{{#seo:|title=LOINC|titlemode=append|keywords= Leitfaden, Leitfäden, LOINC, ELGA, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten|description=Dieser Leitfaden erklärt das Vorgehen beim „Mapping“, der korrekten Zuordnung von lokalen Laborcodes zu den standardisierten Codes für PDF DruckELGA}}</pre> ===In Bearbeitung/UnderConstruction===Ebenso 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:<pre>{{Underconstruction}}</pre> === Strukturbeispiele === Für die [[Hilfe:Wiki#Bekannte_Vorlagen|Strukturbeispiele]] bitte die jeweils entsprechenden Vorlagen verwenden. === Inhaltsverzeichnis === Damit das Inhaltsverzeichnis richtig dargestellt wird, die Vorlage [[Hilfe:Wiki#Rechtsausgerichtetes_Inhaltsverzeichnis|ILF-TOC limit]] einbinden: <pre>{{ILF-TOC limit}}</pre> ===Infobox===Jeder Leitfaden hat eine Infobox eingefügt werden, da die eingetragenen Inhalte bei alle zur Erstellung der Umwandlung Druckversion im PDF Format notwendigen Informationen enthält. Sie ist in ein PDFder Online-Dokument erforderlich sindVersion nicht sichtbar.
<pre>
{{Infobox Dokument
}}
</pre>
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.
===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.
<pre>
</pre>
===Versionierung===
Die Versionierung der Leitfäden erfolgt über den Namespace und [[Hilfe:Flagged Revisions|Flagged Revision]].
Wird eine neue Version eines Leitfadens erarbeitet, so muss
* die alte Version im Wiki vor Änderungen gesperrt werden
* der neue Namespace für diese Version angelegt werden
* die Seiten der alten Version, die unverändert bleiben, können so inkludiert werden
* die Seiten, die geändert werden müssen, müssen neu angelegt werden
=== 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 <code>[#Abschnitt|alternativer Text]</code> 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. <code><nowiki>[[ILF:Allgemeiner Implementierungsleitfaden 2020#Wichtige unterstützende Materialien|alternativer Text]]</nowiki></code>).
** 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 <code>[[</code> 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).
==Art-Decor Templates einbinden==
Die Templates für den Leitfaden werden in ArtDecor modelliert (http://art-decor.org/art-decor/decor-project--elga-) und 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:<br/>1. Einbinden eines [[Hilfe:Art-Decor-Tabellen_verstehen|Art-Decor ]] Templates '''dynamisch (letztes aktuelles ''' <br/>Die dynamische Möglichkeit stellt sicher, dass immer das Template wird bezogen)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:
<pre>
{{:OID-NR/dynamic}}
</pre>
{{:1.2.40.0.34.11.2.2.26/dynamic}}
<pre>
{{:1.2.40.0.3410.111.24.23.264.1.1.1/dynamicstatic-2013-12-16T000000}}
</pre>