FHEMWiki:Über FHEMWiki: Unterschied zwischen den Versionen

Aus FHEMWiki
(→‎Vorlagen: Link2Forum eingefügt)
(Liste der Wiki-Baustellen eingefügt; Überarbeitung der Kopiervorlage für neue Seiten; diverse Korrekturen)
Zeile 1: Zeile 1:
Administratives zum und '''über FHEMWiki'''.
Administratives zum und '''über FHEMWiki'''.
{{Randnotiz|RNTyp=y|RNText='''Aktuelle Wiki-Baustellen'''
* Konsolidierung von Kopiervorlagen (Hardware)<br />([[FHEMWiki  Diskussion:Über FHEMWiki#Beispiel Neuer Artikel versus Infobox Hardware|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Ph1959de|Peter]])
* Kategoriestruktur: Angleichung an Forum, etc.<br />([[FHEMWiki Diskussion:Über FHEMWiki#Vorschlag zu Kategorienstruktur auf Projektseite|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Krikan|Christian]])
* Bereinigung [[FHEM Command Beispiele]]: Ausgliederung in eigene Artikel<br />([[Diskussion:Update|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Ph1959de|Peter]])
* Kategorie(n) für Hardware-Eigenentwicklungen<br />([[Benutzer Diskussion:Tobias.faust#Unterkategorie(n) "Eigenentwicklung"|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Tobias.faust|Tobias]])
<hr />
''Änderungen im Wiki, die an den verlinkten Stellen diskutiert / angeregt wurden''
}}


== Administratives ==
== Administratives ==
=== Begrüßung neuer Mitschreiber ===
=== Begrüßung neuer Mitschreiber ===
<div id="Begrüßung" style="float:right; width:400px;">
{{Randnotiz|RNText=Begrüßungstext
{| cellspacing="5" cellpadding="5" style="width:100%;font-size:100%;border:2px solid #EE7F00;background-color:#eeeeee;position:relative;{{{style|{{{1|}}}}}}"
| Begrüßungstext
* Wünsche
* Wünsche
* Hinweis auf Administratives (also hierher)
* Hinweis auf Administratives (also hierher)
* Bitte um Einarbeitung in Wiki-Mitarbeit
* Bitte um Einarbeitung in Wiki-Mitarbeit
* Erste / nächste Schritte
* Erste / nächste Schritte
|}
}}
</div>
Neu angemeldete Benutzer können mit in etwa folgendem Text auf ihrer Benutzer-Diskussionsseite begrüßt werden:
Neu angemeldete Benutzer können mit in etwa folgendem Text auf ihrer Benutzer-Diskussionsseite begrüßt werden:


Zeile 17: Zeile 23:


=== Administratoren ===
=== Administratoren ===
Zur Vermeidung von Spam und Vandalismus im Wiki, muss die Einrichtung eines Benutzerkontos über E-Mail an einen der [[FHEMWiki:Administratoren|Administratoren]] beantragt werden.
Zur Vermeidung von Spam und Vandalismus im Wiki gibt es generelle Schreibberechtigung für anonyme Benutzer. Wer mitarbeiten will, muss die Einrichtung eines Benutzerkontos über E-Mail an einen der [[FHEMWiki:Administratoren|Administratoren]] beantragen.


== Empfehlungen und Regeln ==
== Empfehlungen und Regeln ==
Zeile 48: Zeile 54:
|-  
|-  
| <nowiki><pre>...</pre></nowiki>
| <nowiki><pre>...</pre></nowiki>
| benutzen, um "vorformatierten" Text (Code, .cfg-Ausschnitte, etc.) darzustellen. Alternativ kann auch jede Zeile mit einem Leerzeichen begonnen werden. Passagen im laufenden Text können/sollten mit <nowiki><code></nowiki><code>Text</code><nowiki></code></nowiki> formatiert werden. Attribute für den Bereich können beispielsweise so spezifiziert werden: <nowiki><pre style="width:50%;"></nowiki>
| benutzen, um "vorformatierten" Text (Code, .cfg-Ausschnitte, etc.) darzustellen. Alternativ kann auch jede Zeile mit einem Leerzeichen begonnen werden. Passagen im laufenden Text können/sollten mit <nowiki><code></nowiki><code>Text</code><nowiki></code></nowiki> formatiert werden. Attribute für den Bereich können beispielsweise so spezifiziert werden: <nowiki><pre style="width:50%;"></nowiki> (mit diesem Zusatz würde beispielsweise der Kasten um den vorformatierten Text nur die (linke) Hälfte der Seite einnehmen).
| <nowiki><nowiki>... &lt;/nowiki&gt;</nowiki>
| <nowiki><nowiki>... &lt;/nowiki&gt;</nowiki>
| sollte nur dann verwendet werden, wenn der Text Wiki-Syntax enthält, die nicht aufgelöst werden soll (wie hier in den Formatierungsbeispielen).  
| sollte nur dann verwendet werden, wenn der Text Wiki-Syntax enthält, die nicht aufgelöst werden soll (wie hier in den Formatierungsbeispielen).  
Zeile 54: Zeile 60:
| <nowiki>[[Lemma]]</nowiki>
| <nowiki>[[Lemma]]</nowiki>
| für die Verlinkung auf andere Fhem-Wikiseiten verwenden
| für die Verlinkung auf andere Fhem-Wikiseiten verwenden
| <nowiki>[http://www.fhemwiki.de/wiki/Lemma]]</nowiki>
| <nowiki>[http://www.fhemwiki.de/wiki/Lemma]</nowiki>
| stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und sollte nicht benutzt werden.
| stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und sollte nicht benutzt werden.
<!-- Schablone für neue Tabellenzeilen
<!-- Schablone für neue Tabellenzeilen
Zeile 72: Zeile 78:


=== Beispiel: Neuer Artikel ===
=== Beispiel: Neuer Artikel ===
Am Beispiel eines Artikels über ein ''Device'' (das '''Gerät XYZ''') soll der prinzipielle Aufbau einer Wiki-Seite veranschaulicht werden:
Am Beispiel eines Artikels über ein ''Device'' bzw. Modul (das '''XYZ''') soll der prinzipielle Aufbau einer Wiki-Seite veranschaulicht werden:


{| class="wikitable"
{| class="wikitable"
Zeile 78: Zeile 84:
! Quelltext !! Darstellung !! Bemerkungen
! Quelltext !! Darstellung !! Bemerkungen
|-
|-
| <code><nowiki>'''Gerät XYZ''' ist ein... </nowiki></code>
| <code><nowiki>{{Infobox Hardware|...}}</nowiki> oder <nowiki>{{Infobox Modul|...}}</nowiki></code>
| '''Gerät XYZ''' ist ein...
| ''Infobox'', linksbündig dargestellt
| Seitentitel (fett gedruckt) möglichst in einem einleitenden Satz / Abschnitt benutzen.
| Formatierte Tabelle mit spezifischen Daten; Beispiele: [[Special:Linkliste/Vorlage:Infobox Modul|Module]], [[Special:Linkliste/Vorlage:Infobox Hardware|Geräte]]
|-
|-
| <code><s><nowiki>'''== Gerät XYZ ==''' ist ein... </nowiki></s></code>
| <code><nowiki>[[XYZ]] ist ein... </nowiki></code>
| '''XYZ''' ist ein...
| Seitentitel als Intra-Wiki-Link (wird dadurch fett gedruckt) möglichst in einem einleitenden Satz / Abschnitt benutzen.
|-
| <code><s><nowiki>'''== XYZ ==''' ist ein... </nowiki></s></code>
| &nbsp;
| &nbsp;
| Seitentitel '''nicht''' als erste Überschrift wiederholen!
| Seitentitel '''nicht''' als erste Überschrift wiederholen!
|-
|-
| <code><nowiki>== Features / Funktionen ==</nowiki></code>
| <code><nowiki>== Features / Funktionen ... ==</nowiki></code>
| '''Features / Funktionen'''
| '''Features / Funktionen'''
| Überschrift, Ebene&nbsp;2 (siehe [http://de.wikipedia.org/wiki/Hilfe:%C3%9Cberschrift Hilfe])
| Überschrift, Ebene&nbsp;2 (siehe [http://de.wikipedia.org/wiki/Hilfe:%C3%9Cberschrift Hilfe])
Zeile 98: Zeile 108:
| &nbsp;
| &nbsp;
|-
|-
| <code><nowiki>== Weblinks ==</nowiki></code>
| <code><nowiki>== Links ==</nowiki></code>
| '''Weblinks'''
| '''Weblinks'''
| Liste von Links auf externe Webseiten, Foren, etc.
| Liste von Links auf externe Webseiten, Foren, etc.
|-
|-
| <code><nowiki>[[Kategorie:XYZ Gerät]]</nowiki></code>
| <code><nowiki>[[Kategorie:XYZ Gerät]]</nowiki></code>
| Kategorie: XYZ Gerät
| Kategorie: XYZ Gerät (Unterkategorie von [[:Kategorie:Hardware]])
| Kategorien werden gesammelt am Ende der Seite angezeigt
| Kategorien werden gesammelt am Ende der Seite angezeigt; Bei Verwendung der Vorlage "Infobox Modul" wird automatisch der jeweils richtige Kategorieeintrag erzeugt.
|}
|}
Das Ganze noch einmal "am Stück" (als "Sourcecode") dargestellt:
Das Ganze noch einmal "am Stück" (als "Sourcecode") dargestellt:
  <nowiki>'''Gerät XYZ''' ist ein...  
  <nowiki>
{{Infobox Hardware|...}} oder {{Infobox Modul|...}}
[[XYZ]] ist ein...  


== Features / Funktionen ==
== Features / Funktionen ==
Die Haupteigenschaften von XYZ sind
Die Haupteigenschaften von XYZ sind
* a
* a
* b
* ...
* c


== Hinweise zum Betrieb mit Fhem ==
== Hinweise zum Betrieb mit Fhem ==
Um das Gerät von Fhem aus ansprechen zu können wird/werden benötigt...
Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# Feuer,
# ...
# Pfeife,
# ...
# ...


== Bekannte Probleme ==
== Bekannte Probleme ==
Keine.
Keine (oder Liste der bekannten Probleme / Einschränkungen).


== Weblinks ==
== Weblinks ==
* Hersteller: [http://www.hersteller.de HerstellerName]
* Erläuterung [http://www.xyz.de Linktitel]


[[Kategorie:XYZ Gerät]]</nowiki>
[[Kategorie:XYZ Gerät]]</nowiki>
Zeile 131: Zeile 141:
Auch die Gliederung (Einrückungen, Leerzeichen, Leerzeilen) sollten so oder ähnlich beibehalten werden, um auch Anderen die Arbeit im Quelltext zu erleichtern. Die aufgeführten Überschriften sollten enthalten sein, weitere können bei Bedarf natürlich eingefügt werden.
Auch die Gliederung (Einrückungen, Leerzeichen, Leerzeilen) sollten so oder ähnlich beibehalten werden, um auch Anderen die Arbeit im Quelltext zu erleichtern. Die aufgeführten Überschriften sollten enthalten sein, weitere können bei Bedarf natürlich eingefügt werden.


Noch "in Entwicklung" und noch nicht zur allgemeinen Verwendung freigegeben ist die Vorlage [[Vorlage:Infobox Hardware/Doku|<nowiki>{{Infobox Hardware}}</nowiki>]] mit der eine einheitliche Infobox in allen Komponentenbeschreibungen erreicht werden soll. Bisher (Stand Anfang Oktober 2013) ist diese Vorlage in den Artikeln [[PCA301 Funkschaltsteckdose mit Energieverbrauchsmessung|PCA301]] und [[FS20 HGS Funk-Hygrostat|FS20 HGS]] zu Demonstrationszwecken und als Diskussionsgrundlage verwendet
Kopiervorlagen für Seiten zu Geräten finden sich in der Dokumentation zur Vorlage [[Vorlage:Infobox Hardware|<nowiki>{{Infobox Hardware}}</nowiki>]] mit der eine einheitliche Infobox in allen Komponentenbeschreibungen erreicht werden soll. Analog dazu gibt es die Vorlage [[Vorlage:Infobox Modul|<nowiki>{{Infobox Modul}}</nowiki>]] für Fhem Befehle und Module.


Viele gute (und sicherlich auch ein paar schlechte) Beispiele sind in der [[:Kategorie:Hardware]] und ihren Unterkategorien zu finden.
Viele gute (und sicherlich auch ein paar schlechte) Beispiele sind in der [[:Kategorie:Hardware]] und ihren Unterkategorien zu finden.


=== Kategoriestruktur / -konzept ===
=== Kategoriestruktur / -konzept ===
[[Datei:Kategoriestruktur.png|mini|rechts|400px|Kategoriestruktur als Mindmap]]
[[Datei:Kategoriestruktur.png|mini|rechts|400px|Kategoriestruktur als "Mindmap"]]
FHEMWiki hat die im folgenden dargestellte Kategorienstruktur (mit Freeplane erstellte mindmap; gibt es bessere Darstellungsmöglichkeiten?). Die mit Ziffern markierten Kategorien treten unerwünschterweise mehrfach als Unterkategorie auf. Außerdem sind einige derzeit komplett leer oder enthalten nur einen Artikel / eine Unterkategorie. Auch diese Kategorien sollten umorganisiert bzw. sogar gelöscht werden.  
FHEMWiki hat die im folgenden dargestellte Kategorienstruktur.


Vorschläge:  
Vorschläge:  
Zeile 184: Zeile 194:
| [[Vorlage:Infobox Modul|Infobox&nbsp;Modul]]
| [[Vorlage:Infobox Modul|Infobox&nbsp;Modul]]
| <nowiki>{{Infobox Modul|Typ=...}}</nowiki>
| <nowiki>{{Infobox Modul|Typ=...}}</nowiki>
| Formatvorlage für die Beschreibung von ([[:Kategorie:Hilfsmodul|Hilfs-]])Modulen  
| Formatvorlage für die Beschreibung von [[:Kategorie:Gerätemodul|Modulen]], [[:Kategorie:Hilfsmodul|Hilfsmodulen]], [[:Kategorie:FhemBefehl|Befehlen]] und [[:Kategorie:Modul (Inoffiziell)|inoffiziellen Modulen]]
| [[Special:Linkliste/Vorlage:Infobox Modul|hier]]
| [[Special:Linkliste/Vorlage:Infobox Modul|hier]]
|-
|-
| [[Vorlage:Löschkandidat|Löschkandidat]]
| [[Vorlage:Löschkandidat|Löschkandidat]]
| <nowiki>{{Löschkandidat|Grund für die Löschung}}</nowiki>
| <nowiki>{{Löschkandidat|Grund für die Löschung}}</nowiki>
| Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie [[:Kategorie:Löschkandidaten|Löschkandidaten]] ein; ein [[FHEMWiki:Administratoren|Administratore]] wird die Seite dann nach Prüfung des Löschantrags entfernen.
| Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie [[:Kategorie:Löschkandidaten|Löschkandidaten]] ein; ein [[FHEMWiki:Administratoren|Administrator]] wird die Seite dann nach Prüfung des Löschantrags entfernen oder den Löschantrag zurückweisen.
| [[Special:Linkliste/Vorlage:Löschkandidat|hier]]
| [[Special:Linkliste/Vorlage:Löschkandidat|hier]]
|-
|-
| [[Vorlage:Link2Forum|Link2Forum]]
| [[Vorlage:Link2Forum|Link2Forum]]
| <nowiki>{{Link2Forum|Area=.../Topic=...|Message=...|}}</nowiki>
| <nowiki>{{Link2Forum|Area= |Topic= |Message= |LinkText= }}</nowiki>
| Erzeugt einen Link auf einen Bereich (Area), ein Thema (Topic) oder einen Beitrag (Message) im Fhem Forum. Thema und Beitrag werden mit numerischen Werten spezifiziert, mit dem Parameter <code>LinkText=</code> kann ein alternativer Text für den Link angegeben werden.
| Erzeugt einen Link auf einen Bereich (Area), ein Thema (Topic) oder einen Beitrag (Message) im Fhem Forum. Thema und Beitrag werden mit numerischen Werten spezifiziert, mit dem Parameter <code>LinkText=</code> kann ein alternativer Text für den Link angegeben werden.
| [[Special:Linkliste/Vorlage:Link2Forum|hier]]
| [[Special:Linkliste/Vorlage:Link2Forum|hier]]
Zeile 231: Zeile 241:


=== Neue Seite(n) ===
=== Neue Seite(n) ===
Kopiervorlagen für neue Seiten. Beispiel: [[FHEMWiki:Über_FHEMWiki#Beispiel:_Neuer_Artikel|Hardware Artikel]]. Die Verwendung dieser Schablonen soll den einheitlichen Aufbau (Gliederung, Abfolge, etc.) von Artikeln über einen Themenbereich fördern.
Kopiervorlagen für neue Seiten. Beispiel: [[FHEMWiki:Über FHEMWiki#Beispiel: Neuer Artikel|Neuer Artikel]]. Die Verwendung dieser Schablonen soll den einheitlichen Aufbau (Gliederung, Abfolge, etc.) von Artikeln über einen Themenbereich fördern.
 
Spezielle Kopiervorlagen finden sich auch in der Dokumentation zu einigen Formatvorlagen:
* Infobox Hardware
* Infobox Modul


[[Kategorie:FhemWiki]]
[[Kategorie:FhemWiki]]

Version vom 1. September 2014, 11:03 Uhr

Administratives zum und über FHEMWiki.

Emblem-question-yellow.svgAktuelle Wiki-Baustellen
Änderungen im Wiki, die an den verlinkten Stellen diskutiert / angeregt wurden


Administratives

Begrüßung neuer Mitschreiber

Info green.pngBegrüßungstext
  • Wünsche
  • Hinweis auf Administratives (also hierher)
  • Bitte um Einarbeitung in Wiki-Mitarbeit
  • Erste / nächste Schritte

Neu angemeldete Benutzer können mit in etwa folgendem Text auf ihrer Benutzer-Diskussionsseite begrüßt werden:

Ein solcher Text wird automatisch generiert durch Eintragung von {{subst:ph1959de/Hallo}} auf der Diskussionsseite des neuen Benutzers.

Administratoren

Zur Vermeidung von Spam und Vandalismus im Wiki gibt es generelle Schreibberechtigung für anonyme Benutzer. Wer mitarbeiten will, muss die Einrichtung eines Benutzerkontos über E-Mail an einen der Administratoren beantragen.

Empfehlungen und Regeln

Mitschreiber und Überarbeiter sind gebeten, sich an die in den folgenden Abschnitten aufgeführten Empfehlungen zu halten.

Erste Schritte / "Getting Started"

  • Lesen, lesen, lesen
  • bestehende Artikel ergänzen, verbessern, überarbeiten
  • neue Artikel anlegen, hierbei beachten:
    • Titel sorgfältig wählen; spätere Änderungen sind zwar möglich aber unnötiger Aufwand.
    • Einordnen in die bestehende Kategorienstruktur
    • neuen Artikel - wo sinnvoll - in bestehenden Artikeln verlinken
    • Nicht jede kleine Änderung über "Seite speichern" kontrollieren, sondern mit "Vorschau zeigen" Zwischenschritte überprüfen
  • Nach und nach komplexere Dinge wie Vorlagen und spezielle Formatierungen (Tabellen, Divs, etc.) verwenden

Gewünschtes Verhalten / "Do and Don't"

Erwünscht ... damit... Unerwünscht ... weil
Vorschau verwenden damit die Änderungshistorie übersichtlich bleibt Experimente mit Seitentiteln führen zu Leichen, Waisen oder unnötigen Weiterleitungen
Diskussionen bitte auf den entsprechenden Seiten von Benutzern oder Artikeln führen = Ebene1 = Überschriften auf "Ebene 1" (ein "=") sollten im Wiki-Artikel nicht verwendet werden. Diese Ebene ist reserviert für den Artikel.
<pre>...</pre> benutzen, um "vorformatierten" Text (Code, .cfg-Ausschnitte, etc.) darzustellen. Alternativ kann auch jede Zeile mit einem Leerzeichen begonnen werden. Passagen im laufenden Text können/sollten mit <code>Text</code> formatiert werden. Attribute für den Bereich können beispielsweise so spezifiziert werden: <pre style="width:50%;"> (mit diesem Zusatz würde beispielsweise der Kasten um den vorformatierten Text nur die (linke) Hälfte der Seite einnehmen). <nowiki>... </nowiki> sollte nur dann verwendet werden, wenn der Text Wiki-Syntax enthält, die nicht aufgelöst werden soll (wie hier in den Formatierungsbeispielen).
[[Lemma]] für die Verlinkung auf andere Fhem-Wikiseiten verwenden [http://www.fhemwiki.de/wiki/Lemma] stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und sollte nicht benutzt werden.

Strukturen und Konzepte

Die folgenden Strukturen und Konzepte haben sich bisher im FHEMWiki etabliert und sollten im Allgemeinen eingehalten werden. Änderungen bitte nicht eigenmächtig vornehmen, sondern voher an entsprechender Stelle zur Diskussion stellen.

Artikelgliederung

In Anlehnung an die Gebräuche bei Wikipedia, sollen innerhalb eines Artikels nur die Gliederungsebenen "2" (==) und tiefer verwendet werden.

Beispiel: Neuer Artikel

Am Beispiel eines Artikels über ein Device bzw. Modul (das XYZ) soll der prinzipielle Aufbau einer Wiki-Seite veranschaulicht werden:

Quelltext Darstellung Bemerkungen
{{Infobox Hardware|...}} oder {{Infobox Modul|...}} Infobox, linksbündig dargestellt Formatierte Tabelle mit spezifischen Daten; Beispiele: Module, Geräte
[[XYZ]] ist ein... XYZ ist ein... Seitentitel als Intra-Wiki-Link (wird dadurch fett gedruckt) möglichst in einem einleitenden Satz / Abschnitt benutzen.
'''== XYZ ==''' ist ein...   Seitentitel nicht als erste Überschrift wiederholen!
== Features / Funktionen ... == Features / Funktionen Überschrift, Ebene 2 (siehe Hilfe)
== Hinweise zum Betrieb mit Fhem == Hinweise zum Betrieb mit Fhem  
== Bekannte Probleme == Bekannte Probleme  
== Links == Weblinks Liste von Links auf externe Webseiten, Foren, etc.
[[Kategorie:XYZ Gerät]] Kategorie: XYZ Gerät (Unterkategorie von Kategorie:Hardware) Kategorien werden gesammelt am Ende der Seite angezeigt; Bei Verwendung der Vorlage "Infobox Modul" wird automatisch der jeweils richtige Kategorieeintrag erzeugt.

Das Ganze noch einmal "am Stück" (als "Sourcecode") dargestellt:

{{Infobox Hardware|...}} oder {{Infobox Modul|...}}
[[XYZ]] ist ein... 

== Features / Funktionen ==
Die Haupteigenschaften von XYZ sind
* a
* ...

== Hinweise zum Betrieb mit Fhem ==
Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt...
# ...
# ...

== Bekannte Probleme ==
Keine (oder Liste der bekannten Probleme / Einschränkungen).

== Weblinks ==
* Erläuterung [http://www.xyz.de Linktitel]

[[Kategorie:XYZ Gerät]]

Auch die Gliederung (Einrückungen, Leerzeichen, Leerzeilen) sollten so oder ähnlich beibehalten werden, um auch Anderen die Arbeit im Quelltext zu erleichtern. Die aufgeführten Überschriften sollten enthalten sein, weitere können bei Bedarf natürlich eingefügt werden.

Kopiervorlagen für Seiten zu Geräten finden sich in der Dokumentation zur Vorlage {{Infobox Hardware}} mit der eine einheitliche Infobox in allen Komponentenbeschreibungen erreicht werden soll. Analog dazu gibt es die Vorlage {{Infobox Modul}} für Fhem Befehle und Module.

Viele gute (und sicherlich auch ein paar schlechte) Beispiele sind in der Kategorie:Hardware und ihren Unterkategorien zu finden.

Kategoriestruktur / -konzept

Kategoriestruktur als "Mindmap"

FHEMWiki hat die im folgenden dargestellte Kategorienstruktur.

Vorschläge:

  1. derzeitige Kategorie "Server Hardware" wird zur Unterkategorie von "Hardware" und heißt nur noch "Server". Alle Unterkategorien "wandern mit".
    • Ergänzender Vorschlag: "Server" wird Unterkategorie von "Hardware Typen". Die jeweiligen Hersteller der Server bilden Unterkategorien von "Hardware Serien/Hardware Systeme.
  2. alle Unterkategorien von "Glossary" werden ersatzlos entfernt.
  3. Grundlegende Änderungen an der Struktur bitte nur nach entsprechender Diskussion.
  4. Unterteilung in zwei Hardware-Hauptkategorien mit jeweils einer Unterkategorieebene:
    1. Aufgabenbezogene Hauptkategorie: Hardware Typen
      • Gedacht für Benutzer, die sich einen Überblick über die Aufgaben verschaffen wollen, die von FHEM verwaltet werden können.
      • Beispiele für Unterkategorien: FHEM Server, Lichtsensoren, Feuchtesensoren, ...
      • Keine Unterkategorie "sonstiges" da Aufgabe im Kategorienamen klar beschrieben sein muss
    2. Herstellerbezogene Hauptkategorie: Hardware Serien / Hardware Systeme
      • Gedacht für Benutzer, die wissen wollen, welche Module innerhalb einer Serie existieren bzw. in FHEM integriert sind.
      • Beispiele für Unterkategorien: FS20, HMS, FritzBox, Raspberry Pi
      • Sammlung von Einzelgeräten unter "andere Komponenten"
    • Keine Unter-Unterkategorie um Übersichtlichkeit nicht erneut zu verlieren.
    • Kein Eintrag von einzelnen HW-Modulen in die Hauptkategorie. Dies muss immer über eine Unterkategorie erfolgen.
  5. Vorschlag für weitere Hauptkategorien: FHEM Module, FHEM Konfiguration (Howtos, Code Snippets, FAQ), FHEM Development

Vorlagen und Schablonen

Im Folgenden werden die Vorlagen (Wiki templates), Schablonen (Kopierbeispiele) und Muster aufgeführt, die in diesem Wiki zur Verfügung stehen.

Vorlagen

Die folgenden Fhem-Wiki spezifischen (Format-)vorlagen (templates) sind bisher verfügbar:

Titel Syntax Bemerkungen Ref
Anker {{Anker|Ankertext}} Details: Fügt an der aktuellen Stelle im Artikel eine Sprungmarke ein, auf die mit [[Artikel#Ankertext]] referiert werden kann, wie sonst auf eine Überschrift. Ankertext sollte innerhalb der Seite nur einmal vorkommen. hier
Baustelle {{Baustelle}} Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie Baustelle ein hier
Infobox Hardware {{Infobox Hardware|Bild=...}} Formatvorlage für die Beschreibung von Hardwarekomponenten (Geräten). hier
Infobox Modul {{Infobox Modul|Typ=...}} Formatvorlage für die Beschreibung von Modulen, Hilfsmodulen, Befehlen und inoffiziellen Modulen hier
Löschkandidat {{Löschkandidat|Grund für die Löschung}} Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie Löschkandidaten ein; ein Administrator wird die Seite dann nach Prüfung des Löschantrags entfernen oder den Löschantrag zurückweisen. hier
Link2Forum {{Link2Forum|Area= |Topic= |Message= |LinkText= }} Erzeugt einen Link auf einen Bereich (Area), ein Thema (Topic) oder einen Beitrag (Message) im Fhem Forum. Thema und Beitrag werden mit numerischen Werten spezifiziert, mit dem Parameter LinkText= kann ein alternativer Text für den Link angegeben werden. hier
Randnotiz {{Randnotiz|RNTyp=[g|Info|y|Warn|r|Fehl]|RNText=Text}} fügt einen Rahmen mit Text ein; mögliche Typen: Info (g(reen)), Warn (y(ellow)), Fehl (r(ed)) mit jeweils unterschiedlicher Hintergrundfarbe hier
stub {{stub}} Fügt einen Textrahmen ein und stellt den Artikel in die Kategorie NeedsEditing ein hier
Todo {{Todo|was muss noch getan werden...}} Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie NeedsEditing ein hier
       
Hallo {{subst:ph1959de/Hallo}} Begrüßung für neue Wiki-Benutzer; (derzeit noch) im privaten Namensraum, kann aber von anderen Benutzern so verwendet werden, da es mit dem Speichern der Seite in den endgültigen Text aufgelöst wird.  
Mit *xxx* gekennzeichnete Vorlagen existieren derzeit noch nicht

Schablonen

Hier bitte Formatierungsbeispiele für bestimmte Anwendungssituationen einfügen (z. B.: wie binde ich Bilder ein, wie erzeuge ich Tabellen, Listen, usw.).

Viele Anregungen, Anleitungen, Regeln, Empfehlungen können auch aus der Wikipedia Hilfe übernommen werden.

Neue Seite(n)

Kopiervorlagen für neue Seiten. Beispiel: Neuer Artikel. Die Verwendung dieser Schablonen soll den einheitlichen Aufbau (Gliederung, Abfolge, etc.) von Artikeln über einen Themenbereich fördern.

Spezielle Kopiervorlagen finden sich auch in der Dokumentation zu einigen Formatvorlagen:

  • Infobox Hardware
  • Infobox Modul