HP2-Wiki:Hilfe

Aus HP2-Wiki

Diese Seite hat Fragen zur Syntax zum Thema. Für sonstige Leitlinien: siehe Stilfragen, für allgemeine inhaltliche Belange: siehe Portal, für artikelspezifische Fragen: siehe jeweilige Diskussionsseite des betreffenden Artikels.

Die Hilfe-Seite erklärt grob den softwarebedingten Aufbau der HP2-Wiki und die grundlegenden Bausteine der Syntax, mit der alle bearbeitbaren Seiten der HP2-Wiki editiert werden. Sowohl Aufbau als auch Syntax sind mit Einschränkungen die gleichen wie bei der großen Wikipedia. Für ausführlichere Hilfestellung und eine Hilfe-Suchfunktion siehe das deutschsprachige Benutzerhandbuch der Mediawiki, oder dessen teils umfangreichere englischsprachige Version. Vor dem allerersten Bearbeiten oder Erstellen eines Artikels, siehe auch Erste Schritte.

Inhaltsverzeichnis 1 Wiki-Aufbau 1.1 Seitenaufbau 1.1.1 Persönliche Menüzeile 1.1.2 Hauptteil 1.1.3 Letzte Änderungen 1.2 Seitenarten 1.3 Namensräume 1.4 Neue Seiten erstellen 2 Syntax 2.1 Text 2.2 Listen 2.3 Sonstiges 2.3.1 Überschriften 2.3.2 Leerzeichen 2.3.3 Signatur 2.4 Links 2.4.1 Interwiki 2.4.2 Kategorien 2.5 Tabellen 2.6 Bilder

Wiki-Aufbau

Seitenaufbau

Jede Seite der HP2-Wiki stellt am oberen Rand rechts eine persönliche Menüzeile, und links einen allgemeinen Navigationsbereich, sowie unten einen Footer dar. Diese Bereiche können nicht, bzw. nur durch den Administrator bearbeitet werden.

Persönliche Menüzeile

Unangemeldete Benutzer finden in der persönliche Menüzeile Ihre IP Nummer und die Option, sich anzumelden bzw. zu registrieren. Angemeldete Benutzer finden in der persönlichen Menüzeile mehrere Links mithilfe derer jederzeit auf die eigene Benutzerseite, die eigene Diskussionsseite, die persönlichen Einstellungen, sowie den automatisch generierten Seiten Beobachtungsliste' und Eigene Beiträge zugegriffen werden kann. Ein Klick auf Abmelden beendet die Session als angemeldeter Benutzer und reduziert entsprechend die persönliche Menüzeile wieder. Persönliche Einstellungen für angemeldete Benutzer können über den Menüpunkt "Einstellungen" rechts oben vorgenommen werden. Die wenigen Optionen erklären sich von selbst und eine Hilfe dazu sollte eigentlich nicht notwendig sein. Derzeit sind keine anderen Skins als Monobook installiert.

Hauptteil

Der Hauptteil enthält den eigentlichen Inhalt jeder bearbeitbaren Seite. Mit einem Klick auf Druckversion wird er auch ohne Navigationsbereiche dargestellt (Genaueres zu "bearbeitbare Seiten" folgt unter Namensräume). Dieser Hauptteil gliedert sich wiederum in mehrere Karteikarten, die anhand der Reiter über dem Seitentitel angewählt werden können: Neben dem eigentlichen Artikel sind jeder Artikel-, Benutzer- oder anderen Seite jeweils eine Diskussionsseite beigefügt. Des weiteren stehen angemeldeten Benutzern, zum Teil auch unangemeldeten Benutzern, zur Bearbeitung notwendige oder anders nützliche Karteikarten zur Verfügung. Vor dem Bearbeiten sollte man sich mit den Navigationsbereichen, vor allem aber mit den Karteikarten, vertraut gemacht haben.

Letzte Änderungen

Die Liste Letzte Änderungen ist eine für das Projekt sehr bedeutsame Checkliste

• zum schnellen Aufsprüren von und Gegensteuern gegen Vandalismus
• für die Durchsicht neuer Beiträge

Bearbeitungen werden mit Zeit und Namen des Autors angegeben, per "Unterschied" ist der Bearbeitungsinhalt mit einem Klick einsehbar, "Versionen" führt zur Versionsgeschichte der jeweiligen Seite. Verschiedene Filter sind verfügbar: So werden zum Zweck der Übersichtlichkeit Bot-Bearbeitungen standardmäßig nicht aufgelistet.

Bots sind eine Benutzergruppe, deren Edits prinzipiell nicht durchgesehen werden müssen da sich ihre Beitragsqualität in diesem Sinne als zuverlässig gezeigt hat.

Durch klicken von "Bots einblenden" auf der Seite "Letzte Änderungen" werden auch Bot-Bearbeitungen angezeigt.

Seitenarten

Verschiedene Seiten, wie z.B. Beliebte Seiten, werden vom System dynamisch erstellt sind nicht bearbeitbar. Eine Liste findet sich im Navigationsbereich unter Spezialseiten .

Namensräume

Die Software gruppiert alle bearbeitbaren Seiten in gut ein Dutzend verschiedene "Namensräume" (auch NS von englisch: Namespace) um sie differenziert zu bearbeiten. Neben dem Artikel-Raum (auch "Haupt-Raum"), um dessen Seiten es eigentlich geht, gibt es den Diskussionsraum (hier sind alle "Diskussions-Karteikarten" der Artikel vertreten), den Benutzer-Raum für Benutzerseiten (die jeweils eigene oberste Benutzerseite ist in der persönlichen Menüzeile verlinkt), den Benutzerdiskussionsraum für die den Benutzerseiten beigefügten Diskussionen, den Vorlage-Raum, den Hilfe-Raum, den HP2wiki-Raum etc. sowie den jeweiligen Diskussionsräumen (z.B. NS "Vorlage Diskussion"). Die Seitentitel aller Seiten der verschiedenen Namensräume beginnen mit dem Namensraum als Präfix, gefolgt von einem Doppelpunkt und dem eigentlichen Seitennamen. Lediglich den Seiten des Artikelraums ist kein Präfix vorangestellt. Beispielsweise hat also die Diskussionsseite von Benutzer "HPJ" den Seitentitel "Benutzer Diskussion:HPJ" und führt bei der Standardsuche sowie bei der Verlinkung nur mit dem NS-Präfix zum Ziel.

Neue Seiten erstellen

Textstellen, die als Link innerhalb der HP2-Wiki vorgesehen sind, aber nicht zu einer bereits erstellten Seite führen, werden vom System rot dargestellt.

• Hin und wieder ist lediglich eine falsche Schreibweise des Seitentitels, zum Beipiel ein vergessenes Namensraum-Präfix, die Ursache für den "leeren Link"!
  

Die folgenden Schritte führen zum Erstellen einer neuen Seite in der HP2-Wiki:

Schrittfolge A (existierender roter Link)

1. Wird ein roter Link angeklickt, generiert die Software ein Bearbeitungsfenster für diese noch nicht existierende Seite.
2. Gibt man Bearbeitungsinhalt in das Bearbeitungsfenster und drückt (bitte nach erfolgter Kontrolle per Vorschau-Funktion) dann den Knopf "Artikel speichern", wird eine neue Seite geboren !

Schrittfolge B (freie Seitentitel-Wahl, ohne leeren Link)

1. Den gewünschten Seitentitel einschließlich gegebenenfalls notwendigen Namensraum-Präfixes als Suchbegriff in die Navigationsleiste links eingeben und "Artikel" oder die Enter-Taste der Tastatur drücken (siehe auch Anmerkungen).
2. die Software zeigt eine Suchergebnisseite an, in der sich oben im zweiten Satz die Passage ".... oder legen Sie den Artikel neu an." anklicken lässt. MIt einem Klick darauf gelangt man zum erstmaligen Bearbeitungsfenster für die noch nicht existierende Seite:
3. siehe Punkt 2 der "Schrittfolge A" weiter oben

Anmerkungen:

• Nur die eigentlichen Artikel (Artikel-Namensraum) haben kein Präfix, alle anderen Seiten benötigen eines. Zur Erstellung einer zusätzlichen Hilfeseite würde man beispielsweise "HP2wiki:Expertenhilfe" eingeben; zum Erstellen einer zusätzlichen Benutzerseite wäre "Benutzer:XYZ/Archiv alte Diskussionen" ein Beispiel (Unterseiten durch "/Seitentitel").
• Die Software unterscheidet für Seitentitel nicht zwischen Leerzeichen " " und Unterstrich "_".
• Befindet sich der Cursor nicht im Bearbeitungsfenster, bewirkt bereits das Drücken der Enter-Taste der Tastatur das Abspeichern der Seite.
• Drückt man den Knopf "Artikel speichern", ohne jeglichen Inhalt ins Bearbeitungsfenster gegeben zu haben, wird nach dem Motto "Wer nichts zu sagen hat ..." keine Seite erstellt.
• Vor dem Erstellen bitte die Ersten Schritte und unbedingt die Copyright-Bestimmungen beachten.
• Einmal getätigte Veröffentlichungen bleiben auch nach späteren Veränderungen unter den Bestimmungen der GNU in der Versionsgeschichte erhalten und öffentlich einsehbar.

Syntax

Um ein möglichst zweckmäßiges, einheitliches und ansprechendes Erscheinungsbild zu erreichen, gibt es zum Einsatz der verschiedenen Möglichkeiten der Syntax ein paar Regeln.

Bitte vor jedem Speichern ("Artikel speichern") die Vorschau-Funktion ("Vorschau zeigen") benutzen ! Ein fehlerloser Edit von nennenswertem Ausmaß kommt praktisch nie vor.

Text

Die wichtigste Zutat eines Artikels, Text, wird einfach und ohne Zeilenumbruch in das Bearbeitungsfenster geschrieben. Ein einfacher Zeilenumbruch in der Syntax (im Bearbeitungsfenster) wird in der Seitenausgabe ignoriert. Um einen Zeilenumbruch zu erreichen muss <br /> eingegeben werden; eine Leerzeile bewirkt einen Absatz. Weitere Möglichkeiten der Textgestaltung sind:

Syntax-Eingabe	Seiten-Ausgabe
Zeilenumbruch <br /> hier	Zeilenumbruch hier
doppelte Apostrophe ergeben ''Kursivschrift''	doppelte Apostrophe ergeben Kursivschrift
dreifache Apostrophe ergeben '''Fettschrift'''	dreifache Apostrophe ergeben Fettschrift
Hochstellen: cm<sup>3</sup>	Hochstellen: cm3
Tieferlegen: H<sub>2</sub>O	Tieferlegen: H2O
Klein: <small>X Challenge</small>	Klein: X Challenge
Doppelpunkt am Zeilenanfang bewirkt : einfaches oder :: mehrfaches Einrücken	Doppelpunkt am Zeilenanfang bewirkt einfaches oder mehrfaches Einrücken

Listen

nicht nummerierte Listen werden durch Sternchen *, nummerierte durch Doppelkreuze # am Zeilenanfang generiert:

Syntax-Eingabe	Seiten-Ausgabe
nicht nummerierte Liste * etwas * noch etwas	nicht-nummerierte Liste etwas noch etwas
nummerierte Liste # erster Punkt # zweiter Punkt	nummerierte Liste erster Punkt zweiter Punkt

Sonstiges

Syntax-Eingabe	Seiten-Ausgabe
Trennlinie (in neuer Zeile)1): ----	Trennlinie (in neuer Zeile):
Syntax-Pause durch "nowiki"2): <nowiki>*weder Liste ''noch kursiv''</nowiki>	Syntax-Pause durch "nowiki": *weder Liste ''noch kursiv''

¹⁾ Shortcut: Knopf ganz rechts über dem Bearbeitungsfenster ²⁾ Shortcut: Dritter Knopf von rechts über dem Bearbeitungsfenster

Überschriften

Syntax-Eingabe	Seiten-Ausgabe
== Überschrift ==	Überschrift
=== untergeordnete Überschrift ===	untergeordnete Überschrift
==== untergeordnete Überschrift 2 ====	untergeordnete Überschrift 2

Anmerkungen: Shortcut für das Setzen der Überschrift ist der fünfte Knopf (großes "A") über dem Bearbeitungsfenster.
Ab 4 Überschriften pro Seite generiert die Software automatisch ein Inhaltsverzeichnis. Dies kann in den "Einstellungen" abgestellt werden.

Überschriften dienen nicht nur optische der Gliederung von Artikeln, sondern bieten auch die Möglichkeit der Verlinkung in eine/innerhalb einer Seite. Beispiel: [[HP2wiki:Erste_Schritte#Schritte des Bearbeitens|Hier sind alle Bearbeitungsschritte aufgeführt]]

Leerzeichen

In vielen, aber nicht allen Fällen ergibt ein Leerzeichen in der Syntax ein Leerzeichen in der Textausgabe. Vor allem in Tabellen ist aber ein Platzhalter verlangt, soll ein Feld frei bleiben, da sonst die Ausgabe korrumpiert (Beispiel). Das explizite Leerzeichen in der Syntax ist "&nbsp;".

Signatur

Syntax-Eingabe	Seiten-Ausgabe
--~~~~	--HPJ 07:38, 20. Jun 2008 (CDT)

Anmerkung: Der Zweite Knopf von rechts über dem Bearbeitungsfenster ist ein Shortcut für diese Zeichenkette.

In der Wiki gibt es nur eine kleine, automatische Signatur: Durch den Eintrag von "--~~~~" in die Syntax, wird als Ergebnis automatisch der eigene Benutzername ("Benutzer:XY") mit Link zur eigenen Benutzerseite, und die Uhrzeit angegeben.
Bei Diskussionen wird dringend erbeten, den eigenen Benutzernamen unter den Diskussionsbeitrag zu setzen - ob manuell oder automatisch. In einem Artikel stört dies. In Artikeln sowie bei allen anderen bearbeitbaren Seiten kann man per "Versionen" die Versionsgeschichte einsehen, d.h. man kann jederzeit "nachforschen", wer wann was und wie geschrieben/bearbeitet hat. (Eine Signatur in Diskussionen macht diese Recherche überflüssig)

Links

Bei Links (auch "Verweise" oder "Hyperlinks") ist zwischen Links innerhalb der HP2-Wiki und Links zu Seiten außerhalb der HP2-Wiki zu unterscheiden.

Links zu Seiten innerhalb der HP2-Wiki werden mit doppelten Eckklammern [[ ]] gesetzt, Alternativtext vom Link mit einem Senkrechtbalken | abgetrennt. Links innerhalb der HP2-Wiki benötigen keinen vollen URL-Pfad, sondern lediglich den Seitentitel (Bei Spezialseiten ist der Titel in der URL ersichtlich, nicht im übersetzten Hauptteil der Seite).

Links zu Seiten außerhalb der HP2-Wiki werden mit einfachen Eckklammern [ ] gesetzt, Alternativtext vom Link mit einer Leerstelle abgetrennt.

Syntax-Eingabe	Seiten-Ausgabe
[[ErzbergRodeo]] (interner Link)	ErzbergRodeo (interner Link)
[[Benutzer:Yaku|Yaku]] (Alternativtext)	Yaku (Alternativtext)
http://bokkura.com (externer Link)	http://bokkura.com (externer Link)
[http://bokkura.com] [http://kansai-bikers.net] (externe Links)	[1] [2] (externe Links)
[http://bokkura.com/wi Die Hauptseite von außen angegangen ...]	Die Hauptseite von außen angegangen ...

Interwiki

Interwiki-Links und Kategorie-Links sind besondere Links, die außerhalb des Seiten-Hauptteils erscheinen und gebräuchlicherweise in der Syntax am Ende stehen: Interwiki-Links in der Navigationsleiste links führen zu einer Seite einer anderen Wiki - in unserem Fall mit "en" zur englischen, mit "ja" zur japanischen HP2-Wiki (Syntax-Beispiele: [[en:Help]], [[ja:ヘルプ]] ). Anmerkung: Der originale Seitentitel in der anderssprachigen Wiki ist gefragt, also mitunter auch japanische Zeichen.

Kategorien

Kategorie-Links der Syntax [[Kategorie:Kategoriename]] erscheinen im Footer und führen zur angegebenen Kategorie, die sich gewissermaßen als "Artikelliste" darstellt. Durch das Setzen des Kategorie-Links in eine bestimmte Seite wird diese gleichzeitig in die jeweils verlinkte Kategorie eingeordnet. Eine Bearbeitung der Kategorieseite selbst ist also nicht nötig.

Ein Doppelpunkt zwischen "[[" und "Kategorie" bewirkt die Anwendung als gewöhnlicher Link, d.h. der Link verbleibt im Seiten-Hauptteil an der jeweils eingefügten Textstelle, auch die Einordnung der betreffenden Seite in die verlinkte Kategorie findet nicht statt.

Tabellen

Tabellen bieten in unzähligen Variationen die Möglichkeit, Inhalte kompakt zu gestalten. Für das Layout gibt es einige Gestaltungsmittel - entsprechend kompliziert kann die Layout-Tüftelei werden. Hier nur das Grundgerüst jeder Tabelle, Optionen und Feinheiten siehe Mediawiki-Benutzerhandbuch

Zu beachten ist, dass aufgrund von Faktoren wie Fließtext, einem Mix von Prozentangaben und Pixelangaben der verschiedenen Seitenbestandteile je nach Computerbildschirm, Browserart, Fenstergröße, im Browser eingestellter Schriftgröße und Schriftart, usw. usw. das Layout unterschiedlich aussieht. Siehe auch Stilfragen.

Syntax-Eingabe	Seiten-Ausgabe
{| border="1" |- |Zeile1 Zelle1||Zeile1 Zelle2 |- |Zeile2 Zelle1||Zeile2 Zelle2 |}	Zeile1 Zelle1 Zeile1 Zelle2 Zeile2 Zelle1 Zeile2 Zelle2

Bilder

Die Option "Dateien Hochladen" ist nicht aktiviert. Geplant ist, Admins das Hochladen von Dateien zu ermöglichen. Den Weg bis zum Admin muss die Datei 'zu Fuß' zurücklegen, d.h. außerhalb der HP2-Wiki per E-Mail o.ä. Bis der Bug, der dieser Handhabung im Weg steht, beseitigt ist, können wir folgendes machen, um nicht fremde Server für unsere Zwecke einzuspannen: Dem Admin die entsprechende Datei mailen. > Er lädt sie mit maximal 600x600 Pixel auf den Server, sodass sie mit blankem "http://bokkura.com/wi/commons/DATEINAME.FORMAT" in der Syntax eingebunden wird.