Hilfe
aus JControlWiki, der freien Wissensdatenbank
An dieser Stelle finden Sie Hilfe zur Benutzung des Wikis.
Inhaltsverzeichnis |
Funktionsweise
Was ist ein Wiki?
Das Grundkonzept eines Wikis ist, dass jeder Teilnehmer unkompliziert beliebige Seiten anlegen und editieren kann. Ein Wiki erlaubt es, komplexe Inhalte einer ausgewachsenen Internetseite mit der Spontanität und dem Gemeinschaftsgeist eines Forums zu verknüpfen.
Das JControl-Community-Wiki
Das JControl-Community-Wiki bietet seinen Benutzern die Möglichkeit, über ihre Erfahrungen mit JControl zu berichten, eigene Projekte vorzustellen oder sich gegenseitig Programmierhilfen zu geben.
Im Gegensatz zur Schwesterseite www.jcontrol.org liegt die Betonung von www.jcontrol-community.de auf dem Wort "Community": Diese Seite soll weitgehend unmoderiert den Benutzern von JControl überlassen werden.
Rubriken
Momentan besteht das Wiki aus drei Hauptrubriken:
- Projekte (hier können eigene Projekte vorgestellt werden),
- Tutorials (hier können Anleitung für verschiedenste Problemstellungen erstellt werden),
- Know How (hier können Tipps und Tricks diskutiert werden)
- und Hardware (hier kann JControl-kompatible Hardware besprochen werden).
Lesen
Artikel im JControl-Community-Wiki können von jedem jederzeit gelesen werden. Klicken Sie sich einfach über die Links auf dieser Seite zu den für Sie interessanten Artikel durch, benutzen Sie die Suche auf der linken Bildschirmseite oder lassen Sie sich mit der Option Zufälliger Artikel überraschen.
Aktiv teilnehmen
Ein Wiki lebt davon, dass seine Teilnehmer sich aktiv an der Gestaltung beteiligen, also eigene Seiten verfassen und sich an Diskussionen beteiligen. Jeder ist herzlich eingeladen, aktiv in das Geschehen auf dieser Seite einzugreifen.
Anmeldung
Um im JControl-Community-Wiki Seiten zu erstellen oder ändern zu können, müssen Sie sich zunächst anmelden. Wir haben uns für die Anmeldepflicht entschieden, da wir fürchten dass das Wiki andernfalls von irgendwelchen Spam-Bots überschwemmt würde. Die (sehr wenigen!) von Ihnen angegebenen Daten werden einzig zur Authentifizierung im Wiki verwendet und nicht für sonst irgendwelche Zwecke.
Was gehört ins Wiki
Bevor Sie etwas in das Wiki schreiben, sollten Sie sich vergewissern, dass es an dieser Stelle gut aufgehoben ist, oder ob vielleicht das Forum auf www.jcontrol.org besser geeignet ist. Während letzteres vor allem für Fragen zu Hard- und Software gedacht ist, sollen im Wiki vor allem Fragen beantwortet oder Problemlösungen vorgestellt werden. Eine Frage im Stil von "Wie kann ich Temperatursensor XYZ abfragen?" gehört ins Forum. Im Wiki könnte jemand hingegen eine Liste mit bekannten Temperatursensoren anlegen, und darstellen, ob und wie diese mit JControl angesteuert werden können.
Seiten editieren
Um eine vorhandene Seite zu erweitern, kann ein angemeldeter Benutzer einfach die entsprechende Seite aufrufen und oben auf den Reiter "bearbeiten" klicken. Daraufhin erscheint ein Editor, in dem der bereits vorhandene Seiteninhalt dargestellt ist. Fügen Sie nun Ihre Änderungen ein und überprüfen Sie diese in der Vorschau, die Sie über den Knopf Vorschau zeigen aufrufen können.
Die Formatierung der Seiten erfolgt über Spezialzeichen, die manuell eingegeben werden können oder über das Menü des Editors ausgewählt werden können. Die Spezialzeichen sind sehr einfach und man kann sie sich am einfachsten nach der Learning-by-Doing-Methode aneignen. Auch kann es hilfreich sein, sich anzusehen, wie andere Wiki-Seiten formatiert wurden.
Sind Sie mit den Änderungen auf der Seite zufrieden, können Sie sie durch Druck auf den Knopf Artikel speichern verewigen.
Neue Seiten erstellen
Neue Seiten können erstellt werden, indem zunächst ein Verweis auf die noch nicht existierende neue Seite auf einer bereits vorhandenen (z.b. Projekte) eingefügt wird. Verweise innerhalb des Wikis können mit folgender Syntax erzeugt werden: [[<Verweis>|<Text>]] Den Teil <Verweis> ersetzen Sie durch den Namen, unter dem Ihre neue Seite gefunden werden soll. Den Teil <Text> durch den Text, der als Verweis dargestellt werden soll.
Der Text [[Hauptseite|Dieser Link führt zur Startseite]] erzeugt z.B. folgenden Verweis: Dieser Link führt zur Startseite.
Der Verweis auf eine noch nicht existierende Seite wird rot dargestellt. Ein Klick auf einen solchen Verweis öffnet den Editor, in dem die neue Seite mit Inhalt gefüllt werden kann.
Namensgebung für neue Seiten
Beim Erstellen neuer Seiten sollten bestimmte Regeln zur Namensgebung befolgt werden. Der Name Ihrer Seite sollte dem der Rubrik gefolgt von einem Doppelpunkt beginnen. Wollen Sie z.B. auf der Seite Ihr JControl-Projekt vorstellen, sollte der Name mit "Projekt:" anfangen. Danach sollte ein griffiger Name folgen. Geht es z.B. um die Steuerung einer Heizanlage, könnte der gesamte Name z.B. Projekt:Heizungssteuerung lauten. Andere Beispiele wären Hardware:Temperatursensoren oder Know How:Optimierte Java-Programmierung.
Datei-Uploads
Es besteht die Möglichkeit, Dateien auf den Wiki-Server hochzuladen und in die Artikel zu integrieren. Neben den gängigen Bildformaten PNG, JPG und GIF können momentan lediglich ZIP-Dateien hochgeladen, in denen z.B. Quelltexte enthalten sein können. Bei sehr großen Dateien sollte - wenn möglich - jedoch ein anderer Server zur Ablage verwendet werden, da der Speicherplatz des Wikis beschränkt ist.
WikiMedia Handbuch
Falls Sie tiefere Erkenntnisse über die Funktionsweise und Bedienung des Wikis benötigen, können Sie diese im WikiMedia-Handbuch finden.
