FHEMWiki:Über FHEMWiki: Unterschied zwischen den Versionen
Topos (Diskussion | Beiträge) (→Kategoriestruktur / -konzept: ergänzt) |
Krikan (Diskussion | Beiträge) K (→Gewünschtes Verhalten / "Do and Don't": -> <source> auf <syntaxhighlight> geändert) |
||
| (29 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
Administratives zum und '''über FHEMWiki'''. | Administratives zum und '''über FHEMWiki'''. | ||
{{Randnotiz|RNTyp=y|RNText='''Aktuelle Wiki-Baustellen''' | |||
* Vorlage/Makro für Links auf (ELV-,...)Dokumente <br /> [[Vorlage:DocLink|DocLink]] / Status: läuft, Basisversion verfügbar / [[Benutzer Diskussion:Ph1959de|Peter]]) | |||
* Konsolidierung von Kopiervorlagen (Hardware)<br />([[FHEMWiki Diskussion:Über FHEMWiki#Beispiel Neuer Artikel versus Infobox Hardware|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Ph1959de|Peter]]) | |||
<!--* 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]])--> | |||
<!-- * "HomeMatic Type xxx" - Konzept / Struktur...<br />([[Kategorie_Diskussion:Hardware_Typen|Diskussion]] / Status: läuft / [[Benutzer Diskussion:Strauch|Strauch]])--> | |||
<hr /> | |||
''Änderungen im Wiki, die an den verlinkten Stellen diskutiert / angeregt wurden'' | |||
}} | |||
== Administratives == | == Administratives == | ||
=== Begrüßung neuer Mitschreiber === | === Begrüßung neuer Mitschreiber === | ||
{{Randnotiz|RNText=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 | ||
}} | |||
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 24: | ||
=== Administratoren === | === Administratoren === | ||
Einrichtung eines Benutzerkontos über Mail an einen der [[FHEMWiki:Administratoren|Administratoren]] | Zur Vermeidung von Spam und Vandalismus im Wiki gibt es generell keine 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 == | ||
Mitschreiber und Überarbeiter sind gebeten, sich an die in den folgenden Abschnitten | Mitschreiber und Überarbeiter sind gebeten, sich an die in den folgenden Abschnitten zusammengestellten Empfehlungen zu halten. | ||
=== Erste Schritte / "Getting Started" === | === Erste Schritte / "Getting Started" === | ||
| Zeile 26: | Zeile 33: | ||
* bestehende Artikel ergänzen, verbessern, überarbeiten | * bestehende Artikel ergänzen, verbessern, überarbeiten | ||
* neue Artikel anlegen, hierbei beachten: | * neue Artikel anlegen, hierbei beachten: | ||
** Titel sorgfältig wählen; spätere Änderungen sind zwar möglich aber unnötiger Aufwand. | ** Titel sorgfältig wählen; spätere Änderungen sind zwar möglich aber unnötiger Aufwand. Sollte doch einmal etwas falsch gelaufen sein, dann bitte nicht mit dem richtigen Titel eine neue Seite anlegen, sondern die falsch benannte ''verschieben'' (verbirgt sich unter "Mehr" oben neben dem Suchfeld). | ||
** Einordnen in die bestehende Kategorienstruktur | ** Einordnen in die bestehende Kategorienstruktur | ||
** neuen Artikel - wo sinnvoll - in bestehenden Artikeln verlinken | ** neuen Artikel - wo sinnvoll - in bestehenden Artikeln verlinken | ||
| Zeile 45: | Zeile 52: | ||
| bitte auf den entsprechenden Seiten von Benutzern oder Artikeln führen | | bitte auf den entsprechenden Seiten von Benutzern oder Artikeln führen | ||
| = Ebene1 = | | = Ebene1 = | ||
| Überschriften auf "Ebene 1" (ein "=") | | Überschriften auf "Ebene 1" (ein "=") sollen im Wiki-Artikel nicht verwendet werden. Diese Ebene ist reserviert für den Artikel. | ||
|- | |- | ||
| <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/ | | 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/sollen 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>... </nowiki></nowiki> | | <nowiki><nowiki>... </nowiki></nowiki> | ||
| | | soll nur dann verwendet werden, wenn der Text Wiki-Syntax enthält, die nicht aufgelöst werden soll (wie hier in den Formatierungsbeispielen). | ||
|- | |||
| <nowiki><syntaxhighlight lang="...">...</syntaxhighlight></nowiki> | |||
| benutzen, um Codebeispiele mit [[Syntax Highlighting|Syntaxhervorhebung]] darzustellen. Unterstützte Sprachen, die für FHEM relevant sein könnten sind z.B. bash, gnuplot, java, javascript, perl, php | |||
| "Ich habe ...", "Man sollte..." | |||
| ... sind als Formulierung selten sinnvoll. Die Beschreibungen sollen neutral formuliert (also nicht '''ich''' oder '''man''') und präzise sein. | |||
|- | |- | ||
| <nowiki>[[Lemma]]</nowiki> | | <nowiki>[[Lemma]]</nowiki> | ||
| für die Verlinkung auf andere | | für die Verlinkung auf andere FHEM-Wikiseiten verwenden | ||
| <nowiki>[http:// | | <nowiki>[http://wiki.fhem.de/wiki/Lemma]</nowiki> | ||
| stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und | | stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und soll nicht benutzt werden. | ||
|- | |||
| Lesbarer Quelltext | |||
| Der Wiki-Quelltext soll soweit möglich lesbar sein und der "formatierten Version" entsprechen. Das betrifft insbesondere Leerzeilen. Allgemein sollen diese [https://de.wikipedia.org/wiki/Hilfe:Textgestaltung Wikipedia Richtlinien] befolgt werden. | |||
| HTML Tags | |||
| ... sollen möglichst vermieden werden. So sollen z.B. neue Abschnitte nicht über <nowiki><br (/)></nowiki> Tags erzeugt/erzwungen werden. Meistens ist es möglich und empfohlen, einfach eine Leerzeile im Quelltext einzufügen (siehe auch [https://de.wikipedia.org/wiki/Hilfe:Tags#br hier]). | |||
<!-- Schablone für neue Tabellenzeilen | <!-- Schablone für neue Tabellenzeilen | ||
|- | |- | ||
| Zeile 66: | Zeile 83: | ||
== Strukturen und Konzepte == | == Strukturen und Konzepte == | ||
Die folgenden Strukturen und Konzepte haben sich bisher im FHEMWiki etabliert und | Die folgenden Strukturen und Konzepte haben sich bisher im FHEMWiki etabliert und sollen im Allgemeinen eingehalten werden. Änderungen bitte nicht eigenmächtig vornehmen, sondern voher an entsprechender Stelle zur Diskussion stellen. | ||
=== Artikelgliederung === | === Artikelgliederung === | ||
| Zeile 72: | Zeile 89: | ||
=== Beispiel: Neuer Artikel === | === Beispiel: Neuer Artikel === | ||
Am Beispiel eines Artikels über ein ''Device'' (das ''' | 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 95: | ||
! Quelltext !! Darstellung !! Bemerkungen | ! Quelltext !! Darstellung !! Bemerkungen | ||
|- | |- | ||
| <code><nowiki> | | <code><nowiki>{{Infobox Hardware|...}}</nowiki> oder <nowiki>{{Infobox Modul|...}}</nowiki></code> | ||
| ''' | | ''Infobox'', am rechten Seitenrand dargestellt | ||
| | | Formatierte Tabelle mit spezifischen Daten; Beispiele: [[Special:Linkliste/Vorlage:Infobox Modul|Module]], [[Special:Linkliste/Vorlage:Infobox Hardware|Geräte]] | ||
|- | |- | ||
| <code><s><nowiki>'''== | | <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> | |||
| | | | ||
| 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 2 (siehe [http://de.wikipedia.org/wiki/Hilfe:%C3%9Cberschrift Hilfe]) | | Überschrift, Ebene 2 (siehe [http://de.wikipedia.org/wiki/Hilfe:%C3%9Cberschrift Hilfe]) | ||
|- | |- | ||
| <code><nowiki>== Hinweise zum Betrieb mit | | <code><nowiki>== Hinweise zum Betrieb mit FHEM ==</nowiki></code> | ||
| '''Hinweise zum Betrieb mit | | '''Hinweise zum Betrieb mit FHEM''' | ||
| | | | ||
|- | |- | ||
| Zeile 98: | Zeile 119: | ||
| | | | ||
|- | |- | ||
| <code><nowiki>== | | <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> | <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 | ||
* | * ... | ||
== Hinweise zum Betrieb mit | == Hinweise zum Betrieb mit FHEM == | ||
Falls es besondere Einschränkungen / Voraussetzungen, etc. gibt... | |||
# | # ... | ||
# ... | # ... | ||
== Bekannte Probleme == | == Bekannte Probleme == | ||
Keine. | Keine (oder Liste der bekannten Probleme / Einschränkungen). | ||
== Weblinks == | == Weblinks == | ||
* | * Erläuterung [http://www.xyz.de Linktitel] | ||
[[Kategorie:XYZ Gerät]]</nowiki> | [[Kategorie:XYZ Gerät]]</nowiki> | ||
Auch die Gliederung (Einrückungen, Leerzeichen, Leerzeilen) | Auch die Gliederung (Einrückungen, Leerzeichen, Leerzeilen) sollen 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 [[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 | FHEMWiki hat die im Mindmap dargestellte Kategorienstruktur (Unterkategorien zu Hardware Typen sind der Übersichtlichkeit halber nicht vollständig erfasst). Bitte Artikel sinnvoll in bereits '''vorhandene''' Kategorie(n) einordnen. Neue Unterkategorien nur nach gründlicher Überlegung anlegen und gegebenenfalls zur Diskussion stellen. Bei Hardware bitte die Besonderheit beachten, dass regelmäßig die Aufnahme in 2 Kategorien zu erfolgen hat: in die hersteller-/protokollbezogene Hauptkategorie '''[[:Kategorie:Hardware]]''' sowie die aufgabenbezogene Hauptkategorie '''[[:Kategorie:Hardware Typen]]''' | ||
Weitergehende Hinweise zur Kategorienstruktur: | |||
# Grundlegende Änderungen an der Struktur (bspw. Neuanlage [[:Kategorie:FHEM|Hauptkategorien]], Verschieben Unterkategorien,..) bitte '''nur''' nach entsprechender [[FHEMWiki_Diskussion:Über_FHEMWiki|Diskussion]] | |||
# Unterteilung in zwei Hardware-Hauptkategorien mit jeweils einer Unterkategorieebene: | |||
## Aufgabenbezogene Hauptkategorie: "Hardware Typen" | |||
# Grundlegende Änderungen an der Struktur bitte nur nach entsprechender Diskussion | |||
# Unterteilung in zwei Hauptkategorien mit jeweils einer Unterkategorieebene: | |||
## Aufgabenbezogene Hauptkategorie: | |||
##* Gedacht für Benutzer, die sich einen Überblick über die Aufgaben verschaffen wollen, die von FHEM verwaltet werden können. | ##* Gedacht für Benutzer, die sich einen Überblick über die Aufgaben verschaffen wollen, die von FHEM verwaltet werden können. | ||
##* Beispiele für Unterkategorien: | ##* Beispiele für Unterkategorien: Lichtsensoren, Feuchtesensoren, ... | ||
##* Keine Unterkategorie "sonstiges" da Aufgabe im Kategorienamen klar beschrieben sein muss | ##* Keine Unterkategorie "sonstiges" da Aufgabe im Kategorienamen klar beschrieben sein muss | ||
## Herstellerbezogene | ## Herstellerbezogene Hauptkategorie: "Hardware" (aus historischen Gründen "Hardware" und nicht die treffendere Bezeichnung "Hardware Serien / Hardware Systeme") | ||
##* Gedacht für Benutzer, die wissen wollen, welche Module innerhalb einer Serie existieren bzw. in FHEM integriert sind. | ##* Gedacht für Benutzer, die wissen wollen, welche Module innerhalb einer Serie existieren bzw. in FHEM integriert sind. | ||
##* Beispiele für Unterkategorien: FS20, HMS | ##* Beispiele für Unterkategorien: FS20, HMS, Homematic, ... | ||
##* Sammlung von Einzelgeräten unter " | ##* Sammlung von Einzelgeräten unter "[[:Kategorie:Other Components]]" | ||
# Keine | #* Keine neuen Unter-Unterkategorien um Übersichtlichkeit nicht zu verlieren. | ||
# Kein Eintrag von einzelnen HW-Modulen in die Hauptkategorie. Dies | #* Kein Eintrag von einzelnen HW-Modulen in die Hauptkategorie. Dies soll immer über eine Unterkategorie erfolgen. | ||
# keine Unterkategorien zu [[:Kategorie:Glossary]] anlegen! | |||
# Neue Kategorien bitte im Mindmap dokumentieren ([[FHEMWiki_Diskussion:Über_FHEMWiki#Graphviz_Source|Dateivorlage]]) | |||
== Vorlagen und Schablonen == | == Vorlagen und Schablonen == | ||
| Zeile 159: | Zeile 181: | ||
=== Vorlagen === | === Vorlagen === | ||
Die folgenden | Die folgenden FHEMWiki spezifischen (Format-)vorlagen (templates) sind bisher verfügbar: | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
| Zeile 167: | Zeile 189: | ||
| [[Vorlage:Anker|Anker]] | | [[Vorlage:Anker|Anker]] | ||
| <nowiki>{{Anker|Ankertext}}</nowiki> | | <nowiki>{{Anker|Ankertext}}</nowiki> | ||
| | | Fügt an der aktuellen Stelle im Artikel eine Sprungmarke ein, auf die mit <nowiki>[[Artikel#Ankertext]]</nowiki> referiert werden kann, wie sonst auf eine Überschrift. ''Ankertext'' darf innerhalb der Seite nur einmal vorkommen. | ||
| [[Special:Linkliste/Vorlage:Anker|hier]] | | [[Special:Linkliste/Vorlage:Anker|hier]] | ||
|- | |- | ||
| [[Vorlage:Infobox Hardware|Infobox Hardware]] | | [[Vorlage:Baustelle|Baustelle]] | ||
| <nowiki>{{Baustelle}}</nowiki> | |||
| Fügt einen Rahmen mit einem fest vorgegebenen Text ein; stellt den Artikel in die Kategorie [[:Kategorie:Baustelle|Baustelle]] ein | |||
| [[Special:Linkliste/Vorlage:Baustelle|hier]] | |||
|- | |||
| [[Vorlage:DocLink|DocLink]] | |||
| <nowiki>{{DocLink|#1|#2}}</nowiki> | |||
| Generiert einen Link auf z.B. ELV Dokumente (zur Erleichterung der Anpassung an URL-Änderungen, wie im Mai/Juni 2015 bei ELV geschehen). Die Vorlage ist (Stand 08/2015) noch in Entwicklung und nur für ELV-Links verwendbar. | |||
| [[Special:Linkliste/Vorlage:DocLink|hier]] | |||
|- | |||
| [[Vorlage:Infobox Hardware|Infobox Hardware]] | |||
| <nowiki>{{Infobox Hardware|Bild=...}}</nowiki> | | <nowiki>{{Infobox Hardware|Bild=...}}</nowiki> | ||
| | | Formatvorlage für die Beschreibung von Hardwarekomponenten (Geräten). | ||
| [[Special:Linkliste/Vorlage:Infobox Hardware|hier]] | | [[Special:Linkliste/Vorlage:Infobox Hardware|hier]] | ||
|- | |- | ||
| [[Vorlage: | | [[Vorlage:Hinweis|Hinweis]] | ||
| <nowiki>{{ | | <nowiki>{{Hinweis|Text...}}</nowiki> | ||
| | | fügt (in voller Seiten- oder Spaltenbreite) einen Rahmen mit Text ein | ||
| [[Special:Linkliste/Vorlage: | | [[Special:Linkliste/Vorlage:Hinweis|hier]] | ||
|- | |- | ||
| [[Vorlage: | | [[Vorlage:Infobox Modul|Infobox Modul]] | ||
| <nowiki>{{ | | <nowiki>{{Infobox Modul|Typ=...}}</nowiki> | ||
| | | Formatvorlage für die Beschreibung von [[:Kategorie:Gerätemodul|Modulen]], [[:Kategorie:Hilfsmodul|Hilfsmodulen]], [[:Kategorie:FHEM Befehl|Befehlen]] und [[:Kategorie:Modul (Inoffiziell)|inoffiziellen Modulen]] | ||
| [[Special:Linkliste/Vorlage: | | [[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| | | Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel oder die Datei in die Kategorie [[:Kategorie:Löschkandidaten|Löschkandidaten]] ein; ein [[FHEMWiki:Administratoren|Administrator]] wird die Seite oder die Datei 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:Link2CmdRef|Link2CmdRef]] | |||
| <nowiki>{{Link2CmdRef|Anker= |Lang= |Label= }}</nowiki> | |||
| Erzeugt einen Link auf einen Bereich in der Commandref. | |||
| [[Special:Linkliste/Vorlage:Link2CmdRef|hier]] | |||
|- | |||
| [[Vorlage:Link2Forum|Link2Forum]] | |||
| <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. | |||
| [[Special:Linkliste/Vorlage:Link2Forum|hier]] | |||
|- | |||
| [[Vorlage:Link2FU|Link2FU]] | |||
| <nowiki>{{Link2FU|user#|userName}}</nowiki> | |||
| Erzeugt einen Link auf die Profilseite eines Benutzers im FHEM Forum. Parameter ''user#'' ist die Nummer des Benutzers im Forum; dieser Parameter muss angegeben werden. Optional kann der Benutzername angegeben werden. | |||
| [[Special:Linkliste/Vorlage:Link2FU|hier]] | |||
|- | |||
| [[Vorlage:Randnotiz|Randnotiz]] | |||
| <nowiki>{{Randnotiz|RNTyp=[g|Info|y|Warn|r|Fehl]|RNText=Text}}</nowiki> | |||
| fügt einen Rahmen mit Text ein; mögliche Typen: Info (g(reen)), Warn (y(ellow)), Fehl (r(ed)) mit jeweils unterschiedlicher Hintergrundfarbe | |||
| [[Special:Linkliste/Vorlage:Randnotiz|hier]] | |||
|- | |- | ||
| [[Vorlage:stub|stub]] | | [[Vorlage:stub|stub]] | ||
| Zeile 195: | Zeile 247: | ||
| [[Special:Linkliste/Vorlage:stub|hier]] | | [[Special:Linkliste/Vorlage:stub|hier]] | ||
|- | |- | ||
| [[Vorlage: | | [[Vorlage:Taste|Taste]] | ||
| <nowiki>{{ | | <nowiki>{{Taste|Text}}</nowiki> | ||
| | | Formatiert den spezifizierten ''Text'' wie eine {{Taste|Taste}} | ||
| [[Special:Linkliste/Vorlage: | | [[Special:Linkliste/Vorlage:Taste|hier]] | ||
|- | |- | ||
| [[Vorlage:Todo|Todo]] | |||
| <nowiki>{{Todo|was muss noch getan werden...}}</nowiki> | |||
| Fügt einen Rahmen mit dem angegebenen Text ein; stellt den Artikel in die Kategorie [[:Kategorie:NeedsEditing|NeedsEditing]] ein | |||
| [[Special:Linkliste/Vorlage:Todo|hier]] | |||
| [[Vorlage: | |||
| <nowiki>{{ | |||
| | |||
| [[Special:Linkliste/Vorlage: | |||
|- | |- | ||
| | | | ||
| Zeile 217: | Zeile 265: | ||
| [[Vorlage:ph1959de/Hallo|Hallo]] | | [[Vorlage:ph1959de/Hallo|Hallo]] | ||
| <nowiki>{{subst:ph1959de/Hallo}}</nowiki> | | <nowiki>{{subst:ph1959de/Hallo}}</nowiki> | ||
| 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. | | 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. Muss auf der Diskussionsseite des Benutzers eingetragen werden, der begrüßt werden soll. | ||
| | |||
|- | |||
| [[Vorlage:ph1959de/Vorschau|Vorschau]] | |||
| <nowiki>{{subst:ph1959de/Vorschau}}</nowiki> | |||
| Bitte um Benutzung der Vorschaufunktion; (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. Muss auf der Diskussionsseite des Benutzers eingetragen werden, der an die Benutzung der Vorschaufunktion erinnert werden soll. | |||
| | | | ||
|- | |- | ||
! colspan="4" style="text-align:left" | Mit *xxx* gekennzeichnete Vorlagen existieren derzeit noch nicht | ! colspan="4" style="text-align:left" | Mit *xxx* gekennzeichnete Vorlagen existieren derzeit noch nicht | ||
| Zeile 229: | Zeile 283: | ||
=== Neue Seite(n) === | === Neue Seite(n) === | ||
Kopiervorlagen für neue Seiten. Beispiel: [[FHEMWiki: | 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:FHEM Wiki]] | |||
Aktuelle Version vom 8. Mai 2019, 13:58 Uhr
Administratives zum und über FHEMWiki.
Aktuelle Wiki-Baustellen
- Vorlage/Makro für Links auf (ELV-,...)Dokumente
DocLink / Status: läuft, Basisversion verfügbar / Peter) - Konsolidierung von Kopiervorlagen (Hardware)
(Diskussion / Status: läuft / Peter)
Änderungen im Wiki, die an den verlinkten Stellen diskutiert / angeregt wurden
Administratives
Begrüßung neuer Mitschreiber
Begrüß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 generell keine 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 zusammengestellten 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. Sollte doch einmal etwas falsch gelaufen sein, dann bitte nicht mit dem richtigen Titel eine neue Seite anlegen, sondern die falsch benannte verschieben (verbirgt sich unter "Mehr" oben neben dem Suchfeld).
- 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 "=") sollen 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/sollen 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> | soll nur dann verwendet werden, wenn der Text Wiki-Syntax enthält, die nicht aufgelöst werden soll (wie hier in den Formatierungsbeispielen). |
| <syntaxhighlight lang="...">...</syntaxhighlight> | benutzen, um Codebeispiele mit Syntaxhervorhebung darzustellen. Unterstützte Sprachen, die für FHEM relevant sein könnten sind z.B. bash, gnuplot, java, javascript, perl, php | "Ich habe ...", "Man sollte..." | ... sind als Formulierung selten sinnvoll. Die Beschreibungen sollen neutral formuliert (also nicht ich oder man) und präzise sein. |
| [[Lemma]] | für die Verlinkung auf andere FHEM-Wikiseiten verwenden | [http://wiki.fhem.de/wiki/Lemma] | stellt einen unnötigen externen Link auf eine Wiki-interne Seite dar und soll nicht benutzt werden. |
| Lesbarer Quelltext | Der Wiki-Quelltext soll soweit möglich lesbar sein und der "formatierten Version" entsprechen. Das betrifft insbesondere Leerzeilen. Allgemein sollen diese Wikipedia Richtlinien befolgt werden. | HTML Tags | ... sollen möglichst vermieden werden. So sollen z.B. neue Abschnitte nicht über <br (/)> Tags erzeugt/erzwungen werden. Meistens ist es möglich und empfohlen, einfach eine Leerzeile im Quelltext einzufügen (siehe auch hier). |
Strukturen und Konzepte
Die folgenden Strukturen und Konzepte haben sich bisher im FHEMWiki etabliert und sollen 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, am rechten Seitenrand 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. |
|
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) sollen 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
FHEMWiki hat die im Mindmap dargestellte Kategorienstruktur (Unterkategorien zu Hardware Typen sind der Übersichtlichkeit halber nicht vollständig erfasst). Bitte Artikel sinnvoll in bereits vorhandene Kategorie(n) einordnen. Neue Unterkategorien nur nach gründlicher Überlegung anlegen und gegebenenfalls zur Diskussion stellen. Bei Hardware bitte die Besonderheit beachten, dass regelmäßig die Aufnahme in 2 Kategorien zu erfolgen hat: in die hersteller-/protokollbezogene Hauptkategorie Kategorie:Hardware sowie die aufgabenbezogene Hauptkategorie Kategorie:Hardware Typen
Weitergehende Hinweise zur Kategorienstruktur:
- Grundlegende Änderungen an der Struktur (bspw. Neuanlage Hauptkategorien, Verschieben Unterkategorien,..) bitte nur nach entsprechender Diskussion
- Unterteilung in zwei Hardware-Hauptkategorien mit jeweils einer Unterkategorieebene:
- 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: Lichtsensoren, Feuchtesensoren, ...
- Keine Unterkategorie "sonstiges" da Aufgabe im Kategorienamen klar beschrieben sein muss
- Herstellerbezogene Hauptkategorie: "Hardware" (aus historischen Gründen "Hardware" und nicht die treffendere Bezeichnung "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, Homematic, ...
- Sammlung von Einzelgeräten unter "Kategorie:Other Components"
- Keine neuen Unter-Unterkategorien um Übersichtlichkeit nicht zu verlieren.
- Kein Eintrag von einzelnen HW-Modulen in die Hauptkategorie. Dies soll immer über eine Unterkategorie erfolgen.
- Aufgabenbezogene Hauptkategorie: "Hardware Typen"
- keine Unterkategorien zu Kategorie:Glossary anlegen!
- Neue Kategorien bitte im Mindmap dokumentieren (Dateivorlage)
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 FHEMWiki spezifischen (Format-)vorlagen (templates) sind bisher verfügbar:
| Titel | Syntax | Bemerkungen | Ref |
|---|---|---|---|
| Anker | {{Anker|Ankertext}} | 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 darf innerhalb der Seite nur einmal vorkommen. | hier |
| Baustelle | {{Baustelle}} | Fügt einen Rahmen mit einem fest vorgegebenen Text ein; stellt den Artikel in die Kategorie Baustelle ein | hier |
| DocLink | {{DocLink|#1|#2}} | Generiert einen Link auf z.B. ELV Dokumente (zur Erleichterung der Anpassung an URL-Änderungen, wie im Mai/Juni 2015 bei ELV geschehen). Die Vorlage ist (Stand 08/2015) noch in Entwicklung und nur für ELV-Links verwendbar. | hier |
| Infobox Hardware | {{Infobox Hardware|Bild=...}} | Formatvorlage für die Beschreibung von Hardwarekomponenten (Geräten). | hier |
| Hinweis | {{Hinweis|Text...}} | fügt (in voller Seiten- oder Spaltenbreite) einen Rahmen mit Text ein | 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 oder die Datei in die Kategorie Löschkandidaten ein; ein Administrator wird die Seite oder die Datei dann nach Prüfung des Löschantrags entfernen oder den Löschantrag zurückweisen. | hier |
| Link2CmdRef | {{Link2CmdRef|Anker= |Lang= |Label= }} | Erzeugt einen Link auf einen Bereich in der Commandref. | 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 |
| Link2FU | {{Link2FU|user#|userName}} | Erzeugt einen Link auf die Profilseite eines Benutzers im FHEM Forum. Parameter user# ist die Nummer des Benutzers im Forum; dieser Parameter muss angegeben werden. Optional kann der Benutzername 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 |
| Taste | {{Taste|Text}} | Formatiert den spezifizierten Text wie eine Taste | 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. Muss auf der Diskussionsseite des Benutzers eingetragen werden, der begrüßt werden soll. | |
| Vorschau | {{subst:ph1959de/Vorschau}} | Bitte um Benutzung der Vorschaufunktion; (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. Muss auf der Diskussionsseite des Benutzers eingetragen werden, der an die Benutzung der Vorschaufunktion erinnert werden soll. | |
| 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