Vorlage:Link2CmdRef: Unterschied zwischen den Versionen

Aus FHEMWiki
K (→‎Benutzung: Generische Bildung von Ankernamen in der commandref - leider keine Einheitlichkeit)
(Bei fehlendem Label und angegebenen ANKER wird als Default Label "commandref#ANKER" verwendet)
Zeile 1: Zeile 1:
<includeonly>[https://fhem.de/commandref{{#ifeq: {{{Lang|}}}|de|_DE}}.html#{{{Anker|#}}} {{{Label|commandref}}}]</includeonly><noinclude>
<includeonly>[https://fhem.de/commandref{{#ifeq: {{{Lang|}}}|de|_DE}}.html#{{{Anker|#}}} {{{Label|commandref{{#if:{{{Anker|}}}|#{{{Anker}}}}}}}}]</includeonly><noinclude>
'''Dokumentation'''
'''Dokumentation'''
__TOC__
__TOC__

Version vom 25. April 2018, 10:29 Uhr

Dokumentation

Gegenstand

Diese Vorlage generiert einen Link auf einen Abschnitt der englischen (Standard) oder der deutschen commandref.

Benutzung

{{Link2CmdRef|Anker=Beispiel-Modul|Lang=de|Label=Modul Beispiel-Modul}}

Anker (optional)
Name des FHEM-Moduls wie in der commandref - jeder andere (vorher zu ermittelnde) Ankername (Befehle, Geräte-Spezifikationen, spezielle Attribute oder andere Abschnitte) in der commandref funktioniert auch...; fehlt der Parameter oder wird
Anker=#
verwendet, geht der Link auf die gesamte commandref bzw. deren Anfang
typische Modulanker sind:
Modul = Die Modul-Dokumentation selbst
Modulset = Der Abschnitt Set des Moduls
Modulget = Der Abschnitt Get des Moduls
Modulattr = Der Abschnitt Attribute des Moduls
Moduldefine = Der Abschnitt Define des Moduls
Mitunter sind die Ankernamen der Unterabschnitte in der commandref auch in der Form Modul_Schlüsselwort (mit einem zusätzlichen trennenden Unterstrich) benannt worden!
Ebenso werden zum Teil Grossbuchstaben am Beginn der Schlüsselworte (Set, Get, Define, ...) verwendet
Also: immer besser testen!
Lang (optional)
Wert de (für deutsche commandref) wird erkannt, alle anderen Werte ignoriert; bei fehlendem Parameter wird en (default) angenommen
Label (optional)
Text, der verlinkt angezeigt wird; fehlt der Parameter, wird als Standard-Text commandref eingesetzt.

Beispiele

  • {{Link2CmdRef|Anker=PRESENCE|Label=Modul PRESENCE}}
    Modul PRESENCE
    Link auf die englische Modulbeschreibung von PRESENCE
  • {{Link2CmdRef|Anker=PRESENCE|Lang=de|Label=Modul PRESENCE}}
    Modul PRESENCE
    Link auf die deutsche Modulbeschreibung von PRESENCE
  • {{Link2CmdRef}}
    commandref
    Link auf die gesamte englische commandref (deren Anfang)
  • {{Link2CmdRef|Lang=de}}
    commandref
    Link auf die gesamte deutsche commandref (deren Anfang)