Vorlage:Dokumentation: Unterschied zwischen den Versionen
wp>Entlinkt (Einfachere Formulierung ohne Klammer: „Metadaten“ war Oberbegriff für Kategorien und Interwikis, jetzt ist damit nichts anderes als Kategorien mehr gemeint) |
wp>Entlinkt (Abkopplung dieser Vorlage vom Personendaten- bzw. Metadaten-Gadget und Synchronisierung mit MediaWiki:Editnotice-10, vgl. https://de.wikipedia.org/w/index.php?title=Vorlage_Diskussion:Dokumentation&diff=153484553&oldid=153341011 + kleine Fixes) |
||
Zeile 1: | Zeile 1: | ||
<hr class="rulerdocumentation hintergrundfarbe6" style="height:.7ex; margin:1em 0;"> | <hr class="rulerdocumentation hintergrundfarbe6" style="height:.7ex; margin:1em 0;"> | ||
{{#ifeq:{{NAMESPACE}}|{{ns:0}}|<strong class="error">Achtung: Die {{Vorlage|Dokumentation}} wird im Artikelnamensraum verwendet. Wahrscheinlich fehlt <code><noinclude></code> in einer eingebundenen Vorlage oder die Kapselung ist fehlerhaft. Bitte {{Bearbeiten|text=entferne diesen Fehler}}.</strong>| | {{#ifeq:{{NAMESPACE}}|{{ns:0}}|<strong class="error">Achtung: Die Vorlage {{Vorlage|Dokumentation}} wird im Artikelnamensraum verwendet. Wahrscheinlich fehlt <code><noinclude></code> in einer eingebundenen Vorlage oder die Kapselung ist fehlerhaft. Bitte {{Bearbeiten|text=entferne diesen Fehler}}.</strong>| | ||
<div class="noviewer" style="clear:left; float:right;">[[Datei:Information icon.svg|rahmenlos|18px|link=#Dokumentation.Info|Informationen zu dieser Dokumentation|alt=]]</div> | <div class="noviewer" style="clear:left; float:right;">[[Datei:Information icon.svg|rahmenlos|18px|link=#Dokumentation.Info|Informationen zu dieser Dokumentation|alt=]]</div> | ||
{{Überschriftensimulation 4|1=Dokumentation<span class="mw-editsection">[ | {{Überschriftensimulation 4|1=Dokumentation<span class="mw-editsection plainlinks">[[{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} {{int:Editsection}}]]</span>}} | ||
{{#ifexist: {{SUBJECTPAGENAME}}/Doku| | {{#ifexist: {{SUBJECTPAGENAME}}/Doku| | ||
{{{{SUBJECTPAGENAME}}/Doku}} | {{{{SUBJECTPAGENAME}}/Doku}} | ||
Zeile 14: | Zeile 14: | ||
<ul> | <ul> | ||
<li>[{{fullurl:Spezial:Linkliste/{{FULLPAGENAME}}|hideredirs=1&hidelinks=1}} Verwendungen] dieser Vorlage</li> | <li>[{{fullurl:Spezial:Linkliste/{{FULLPAGENAME}}|hideredirs=1&hidelinks=1}} Verwendungen] dieser Vorlage</li> | ||
<li> Diese Dokumentation befindet sich [[{{SUBJECTPAGENAME}}/Doku|auf einer eingebundenen Unterseite]] | <li> Diese Dokumentation befindet sich [[{{SUBJECTPAGENAME}}/Doku|auf einer eingebundenen Unterseite]] ([{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit}} Bearbeiten]).</li> | ||
{{#ifexist: {{SUBJECTPAGENAME}}/Meta | {{#ifexist: {{SUBJECTPAGENAME}}/Meta | ||
| <li>Die [[Hilfe:Kategorien|Kategorien]] {{#ifeq:{{NAMESPACE}}|{{ns:2}} | | <li>Die [[Hilfe:Kategorien|Kategorien]] {{#ifeq:{{NAMESPACE}}|{{ns:2}} | ||
| in [[{{SUBJECTPAGENAME}}/Meta]] werden '''nicht''' eingebunden, weil sich die Vorlage im [[Hilfe:Benutzernamensraum|Benutzernamensraum]] befindet | | in [[{{SUBJECTPAGENAME}}/Meta]] werden '''nicht''' eingebunden, weil sich die Vorlage im [[Hilfe:Benutzernamensraum|Benutzernamensraum]] befindet | ||
| werden [[{{SUBJECTPAGENAME}}/Meta|von einer Unterseite eingebunden]] | | werden [[{{SUBJECTPAGENAME}}/Meta|von einer Unterseite eingebunden]] ([{{fullurl:{{SUBJECTPAGENAME}}/Meta|action=edit}} Bearbeiten]) | ||
}}.</li> | }}.</li> | ||
}} | }} | ||
{{#ifexist:{{SUBJECTPAGENAME}}/Wartung | {{#ifexist:{{SUBJECTPAGENAME}}/Wartung | ||
| <li>Für diese Vorlage existiert eine [[{{SUBJECTPAGENAME}}/Wartung|Wartungsseite]] | | <li>Für diese Vorlage existiert eine [[{{SUBJECTPAGENAME}}/Wartung|Wartungsseite]] ([{{fullurl:{{SUBJECTPAGENAME}}/Wartung|action=edit}} Bearbeiten]) zum Auffinden fehlerhafter Verwendungen.</li> | ||
| <li | | <li>[{{fullurl:{{SUBJECTPAGENAME}}/Wartung|action=edit&preload=Vorlage:Dokumentation/preload-wartung}} Wartungsseite erstellen].</li> | ||
}} | }} | ||
{{#ifexist:{{SUBJECTPAGENAME}}/XML | {{#ifexist:{{SUBJECTPAGENAME}}/XML | ||
| <li>Für diese Vorlage existiert eine [[{{SUBJECTPAGENAME}}/XML|XML-Beschreibung]] | | <li>Für diese Vorlage existiert eine [[{{SUBJECTPAGENAME}}/XML|XML-Beschreibung]] ([{{fullurl:{{SUBJECTPAGENAME}}/XML|action=edit}} Bearbeiten]) für den [[Wikipedia:Technik/Skin/Gadgets/Vorlagenmeister|Vorlagenmeister]].</li> | ||
}} | }} | ||
{{#ifexist:{{SUBJECTPAGENAME}}/Test | {{#ifexist:{{SUBJECTPAGENAME}}/Test | ||
| <li>Anwendungsbeispiele und Funktionalitätsprüfungen befinden sich auf der [[{{SUBJECTPAGENAME}}/Test|Testseite]] | | <li>Anwendungsbeispiele und Funktionalitätsprüfungen befinden sich auf der [[{{SUBJECTPAGENAME}}/Test|Testseite]] ([{{fullurl:{{SUBJECTPAGENAME}}/Test|action=edit}} Bearbeiten]).</li> | ||
| <li | | <li>[{{fullurl:{{SUBJECTPAGENAME}}/Test|action=edit&preload=Vorlage:Dokumentation/preload-test}} Test-/Beispielseite erstellen].</li> | ||
}} | }} | ||
{{#ifexist:{{SUBJECTPAGENAME}}/Editnotice | {{#ifexist:{{SUBJECTPAGENAME}}/Editnotice | ||
| <li>Es existiert ein [[{{SUBJECTPAGENAME}}/Editnotice|Bearbeitungshinweis]] | | <li>Es existiert ein [[{{SUBJECTPAGENAME}}/Editnotice|Bearbeitungshinweis]] ([{{fullurl:{{SUBJECTPAGENAME}}/Editnotice|action=edit}} Bearbeiten]), der beim Bearbeiten der Vorlage angezeigt wird.</li> | ||
}} | }} | ||
<li>[[Spezial:Präfixindex/{{SUBJECTPAGENAME}}/|Liste der Unterseiten]].</li> | <li>[[Spezial:Präfixindex/{{SUBJECTPAGENAME}}/|Liste der Unterseiten]].</li> | ||
</ul> | </ul> | ||
{{!}}} | {{!}}} | ||
|< | |<div class="plainlinks" style="font-size:150%;"> | ||
* [{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit&preload=Vorlage:Dokumentation/preload-doku}} Dokumentation erstellen] | * [{{fullurl:{{SUBJECTPAGENAME}}/Doku|action=edit&preload=Vorlage:Dokumentation/preload-doku}} Dokumentation erstellen] | ||
{{#ifexist:{{SUBJECTPAGENAME}}/Wartung|| | {{#ifexist:{{SUBJECTPAGENAME}}/Wartung|| | ||
Zeile 47: | Zeile 44: | ||
{{#ifexist:{{SUBJECTPAGENAME}}/Test|| | {{#ifexist:{{SUBJECTPAGENAME}}/Test|| | ||
* [{{fullurl:{{SUBJECTPAGENAME}}/Test|action=edit&preload=Vorlage:Dokumentation/preload-test}} Test-/Beispielseite erstellen]}} | * [{{fullurl:{{SUBJECTPAGENAME}}/Test|action=edit&preload=Vorlage:Dokumentation/preload-test}} Test-/Beispielseite erstellen]}} | ||
</ | </div>{{#ifeq:{{NAMESPACE}}|{{ns:10}}| | ||
[[Kategorie:Vorlage:nicht dokumentiert|{{PAGENAME}}]] | [[Kategorie:Vorlage:nicht dokumentiert|{{PAGENAME}}]] | ||
}} | }} |
Version vom 15. April 2016, 02:41 Uhr
Diese Vorlage zeigt eine Dokumentationsbox, wie du sie gerade siehst. Sie bindet den Text von der Unterseite [[<Seitenname>/Doku]]
ein.
Begründung
Die Trennung von Programmcode und Dokumentation macht den Quelltext übersichtlicher.
- Insbesondere führt eine kleine Änderung in der Dokumentation nicht dazu, dass Tausende einbindender Seiten neu generiert werden müssen.
- In der Versionsgeschichte der Programmierungsseite erscheinen nur noch Änderungen, die die wirksamen Einbindungen betreffen.
Benutzung
Diese Vorlage benötigt meist keine Parameter. Es reicht, wenn der programmierte Code in <onlyinclude>
sowie </onlyinclude>
eingeschlossen wird und dann {{Dokumentation}}
an das Ende einer Vorlage geschrieben wird; danach kann die Dokumentationsseite [[<Seitenname>/Doku]]
erstellt werden. Nach dem Generieren der Dokumentation werden Erstellungshilfen bereitgestellt (preload).
In den Unterseiten stellen folgende Codezeilen am Anfang der Seite den Rückbezug sicher:
- /Doku
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
- Am Ende der Seite werden die Kategorien von
<includeonly></includeonly>
eingeschlossen. - /Test
<noinclude>{{Dokumentation/Testseite}}</noinclude>
- /Unterseite
<noinclude>{{Dokumentation/Unterseite}}</noinclude>
- /Wartung
<noinclude>{{Dokumentation/Wartungsseite}}</noinclude>
- /styles
<noinclude>{{Dokumentation/styleSeite}}</noinclude>
- /Editnotice
<noinclude>{{Dokumentation/Editnoticeseite}}</noinclude>
- /Meta
- Diese Methode ist veraltet und wird nicht mehr unterstützt (integriert in /Doku).
Spezielle Unterseiten
/Test
- Eine Testunterseite enthält umfangreiche Beispiele zur Demonstration und Erprobung der korrekten Funktion.
- Nur wenige, kurze Beispiele sind besser direkt in der Dokumentationsseite aufgehoben.
/Wartung
- Sollte es eine Wartungsseite für die Vorlage geben, so wird ebenfalls ein Hinweis ausgegeben.
- Eine eigene Wartungsseite lohnt sich jedoch nur für umfangreiche Analysen. Ansonsten ist es besser, dies in die Doku-Unterseite zu integrieren, weil ansonsten nur sehr selten einmal ein zufälliger Besucher auch die Wartungsseite öffnet und nach anstehenden Aufgaben sucht.
/XML
- Wenn die Vorlage neben der Dokumentation noch eine XML-Beschreibung für den Vorlagenmeister hat, wird ein entsprechender Hinweis ausgegeben.
- /styles
- /styles.css
- Siehe TemplateStyles
/Editnotice
- Ein spezieller Hinweis, der beim Bearbeiten angezeigt wird.
/Meta
- Eine solche Unterseite war vor allem für vollgeschützte Seiten gedacht, die ansonsten nicht kategorisiert werden konnten, und sie sollte Interwiki-Bots das Beschreiben ermöglichen, ohne durch Halbschutz blockiert zu werden und auf den Beobachtungslisten zu stören. Diese Unterseite nahm auch Kategorisierungen auf.
- Interwiki-Links befinden sich inzwischen auf Wikidata.
- Es bleiben nur wenige Zeilen für die Kategorisierung, die inzwischen in
<includeonly>
eingeschlossen am Ende von/Doku
eingefügt werden. - Eine separate Unterseite lohnt nicht mehr und verkompliziert nur noch; Restbestände sind bis April 2018 aufgelöst worden.
- Siehe Hilfe:Vorlagendokumentation #Meta-Daten.
Unterseiten anlegen
Parameter
Zurzeit wird ein Parameter für Sonderfälle angeboten:
- TOC
- Vorgezogenes Inhaltsverzeichnis anzeigen.
- Für Vorlagendokumentationen, bei denen rechts eine hohe Tabelle erscheint (etwa Infoboxen), kann links oben der Sprung zur Dokumentation ermöglicht werden.
1
– Inhaltsverzeichnis vor dem Dokumentationsabschnitt
Interne Wartung
Fehlerhafte Einbindungen werden aufgelistet in der Kategorie:Regiowiki:Vorlagenfehler/Vorlage:Dokumentation – aktuell keine
(5. Juni 2024 17:22)
Weitere Informationen
Interne Hilfsvorlagen, einzeln für besondere Fälle nutzbar:
- Vorlage:Dokumentation/ruler – einheitliche Trennlinie
- Vorlage:Dokumentation/header – Große Überschrift
- Vorlage:Dokumentation/footer – Fußbereich mit standardisierten Zusatzinfos
Bei technischen Fragen zu dieser Vorlage kannst du dich an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. |
|