Hilfe:Editierhilfe

Aus Macwrench

Wechseln zu: Navigation, Suche
HelpDocument.png
  Help.png Hilfe
 

Diese Seite soll einen kleinen Überblick über die wichtigsten Syntax-Elemente des Wiki geben und dient in erster Linie als Nachschlagewerk. Dieser Artikel ist übrigens auch in der Editieransicht über den Link "Bearbeitungshilfe" rechts neben den Speichern/Vorschau Knöpfen zu erreichen:

Hilfe LinkEditierhilfe.png

Detailliertere Beschreibungen der einzelnen Funktionen finden sich in den jeweiligen Hilfeartikeln (siehe Portal:Hilfe), allgemeine Benutzerhinweise sowie weitergehende Tipps und Tricks sind auch in der MediaWiki-Dokumentation nachzulesen.

Inhaltsverzeichnis

neue Artikel erstellen

Um einen neuen Artikel zu erstellen gibt es verschiedene Möglichkeiten:

  1. über die URL
  2. über die Wiki-Suche

über die URL

Einfach in der URL den Artikelnamen eintragen, z.B.:

http://www.macwrench.de/index.php/meinNeuerArtikel

anschließend über den Link "Seite bearbeiten" die Inhalte eingeben und speichern.

über die Wiki-Suche

Den gewünschten Artikelnamen im Suchfeld eingeben und auf "Los" klicken. Wenn noch kein Artikel mit dem genannten Namen existiert, kann er über den Link "neu" im Text angelegt werden.

Einsortieren eines Artikels

Die Zuweisung einer Kategorie ist für die korrekte Einsortierung des Artikels (z.B.: ein Artikel über TCP/IP gehört in die Kategorie "Netzwerke") erfolgt beim Editieren der Inhalte, z.B. durch Eingabe von

[[Kategorie:Netzwerk]]


Artikel bearbeiten

Um einen Artikel zu bearbeiten muss man im Wiki als Benutzer registriert und eingeloggt sein. Anschließend gelangt man über den "Seite bearbeiten" Link am Seitenfuß jedes Artikels in die jeweilige Eingabemaske und hann die Inhalte editieren.

Inhaltliches

Informationen zum Verfassen von Artikeln findet Ihr beispielsweis in diesen Artikeln:

Urheberrechte

Beim Schreiben von Artikeln unter Verwendung von Materialien aus weiteren Quellen sind natürlich immer die Urheberrechte und gesetzliche Vorschriften zu beachten. Informationen dazu gibt es in den Macwrench Lizenzbestimmungen und dem Artikel Urheberrecht beachten sowie in der Wikipedia und deren Lizenzbestimmungen.

Verwaltung

Warum die Einsortierung in Kategorien wichtig ist und wie dies genau vonstatten geht, steht in diesem Hilfeartikel geschrieben.

Seite einer Kategorie zuordnen

[[Category:kategoriename]] in den Artikel einfügen, am Besten ganz oben (damit man es sofort erkennt)

Hinweis: auch Bilder können so einsortiert werden, dabei existieren für die häufigsten Arten von Grafiken eigene Kategorien, z.B. für ...

  • Screehshots
  • Fotos
  • Anwendungs-Icons
  • Grafiken, die durch das Wiki verwendet werden (also eher interner Natur sind, interessant lediglich für die Wiederverwendung einiger Icons)

Mehr dazu ist in diesem Hilfeartikel nachzulesen.

Verlinken auf eine Kategorieübersicht

[[:Category:kategoriename]] (Beachte den Doppelpunkt am Anfang nach der ersten Doppelklammer)

Sortierung der Einträge auf Kategorie-Seiten

normalerweise werden die Einträge alphabetisch sortiert und es wird für jeden existierenden Anfangsbuchstaben ein Abschnitt erzeugt. Die Einordnung lässt sich wie folgt verändern:
[[:Category:kategoriename|sortierungsname]]
wobei sortierungsname zur Einsortierung verwendet wird (Angezeigt wird weiterhin der richtige Name).
Wenn vor sortierungsname ein Leerzeichen oder ein * eingefügt wird, erscheint der Eintrag ganz oben ausserhalb der alphabetischen Auflistung.

Datei-Upload

Bitte eindeutige Namen für die Dateien beim Upload verwenden, damit es keine Konflikte gibt (jaja ich weiß, die Folien.pdf ist von mir ... ;-) )

Die 100kB Warnung beim Upload kann man meines Wissens nach getrost ignorieren, aber bitte mirt Rücksicht auf den zur Verfügung stehenden Platz auf dem Server sonst gibts irgendwann Mecker von Andy.

Mehr Infos dazu gibts in diesem Hilfeartikel oder im MetaWiki

Zugelassene Dateiendungen sind beispielsweise:

  • Dokumente:
    • .pdf
    • .txt
  • Dateiarchive:
    • .zip
    • .tgz und .tbz
    • .gz (.tar.gz müsste auch tun)
    • .bz2 (.tar.bz2 müsste auch tun)
    • .dmg (.dmg.gz und .dmg.bz2 ebenfalls)

Verlinkung der hochgeladenen Dateien:

  • Direkte Darstellung auf der Seite:
    • [[bild:datei.jpg]]
    • [[bild:datei.jpg|Beschreibung]]
  • Link auf die Datei, Darstellung des Beschreibungstextes:
    • [[media:datei.jpg]]
    • [[media:datei.jpg|Beschreibung]]

Seitenaufbau

Verschiedene Artikeltypen

  • Kurztipps (im Artikelnamen kennzeichnen!)
  • HowTo
  • Artikel
  • Artikelreihen
  • Skripte und kleine Projekte (in die Kategorie "Entwicklung" einzusortieren)

Strukturierung der Inhalte

Artikel werden in erster Linie über die Überschriften strukturiert, was auch erst das automatische Erzeugen des Inhaltsverzeichnisses im Seitenkopf ermöglicht:

==Überschrift 2. Ebene==

===Überschrift 3. Ebene===

(1. Ebene ist der Titel des Artikels)

Text um 1 Tabulator einrücken mit : voranstellen
Text um 2 Tabulatoren einrücken mit :: voranstellen

----(horizontale Linie)

Mehr Informationen dazu sind in diesem Artikel zu finden.

Seiteninhalte

Textformatierungen

Hier die wichtigsten Textauszeichnungen, mehr Informationen dazu gibt es in diesem Hilfeartikel.

''Kursiver Text''

'''Fettgedruckter Text'''

Wiki-Code darstellen ohne ihn zu parsen: <nowiki>* '''blablablubb'''</nowiki>

Unter- und Durchgestrichenen Text m.W. nur mit HTML Tags, also:

<u>Unterstrichener Text:</u> Unterstrichener Text

<strike>Durchgestrichener Text:</strike> Durchgestrichener Text

Signaturen

~~~ nur Name, also z.B. hagbard

~~~~ Name + Uhrzeit, also z.B. hagbard 10:35, 29. Mär 2005 (CEST)

~~~~~ nur Uhrzeit, also z.B. 10:35, 29. Mär 2005 (CEST)

Weitere Informationen dazu gibt es hier.

Links

Links sind wohl eine der wichtigsten Funktionen im Wiki, um das "Stöbern" in Artikeln und Themen zu ermöglichen. Hier soll einmal die grundlegende Syntax erklärt werden, weitere Informationen dazu gibt es hier und hier.

Datei:Icon macwrench.png
  • Link auf die ISBN-Suche für Bücher: ISBN 1234567890 z.B.: ISBN 3897213931

Listen

Nicht numerierte Listen:

  • * Listeneintrag 1. Ebene
    • ** Listeneintrag 2. Ebene

Numerierte Listen:

  1. erste Ebene numeriert mit #
    1. zweite Ebene numeriert mit ##
    • zweite ebene nicht numeriert mit #*
  2. ...

Beschreibungslisten:

Titel 1
Beschreibung 1
Titel 2
Beschreibung 2
Titel 2.1
Beschreibung 2.1
Titel 2.2
Beschreibung 2.2

Weitere Informationen dazu gibt es hier.

Formeln

Im Wiki lassen sich auch mathematische Formeln darstellen, was in technischer Hinsicht durch einen Export in PNG-Dateien via LaTeX realisiert wird. Dieser PNG-Export scheint nicht dabei allerdings wirklich fehlerfrei zu funktionieren, ich konnte die Fehlerquelle aber bisher nicht ermitteln. Anscheinend beschränkt sich die Fehlfunktion nicht nur auf Matrizen (wie bisher angenommen).

hier ein paar Beispiele, mehr Infos dazu gibts hier

<math> \alpha\sqrt{9}</math>

<math>\sqrt{1-e^2}</math>

<math>sin x + ln y + sgn z</math>

<math>\forall \exists \empty \emptyset \in \ni \notin</math> <math>\sum_{k=1}^N k^2</math> <math>\oint_{C} x^3\, dx + 4y^2\, dy</math> <math>\int_{-N}^{N} e^x\, dx \,\!</math> <math>\frac{2}{4}</math> <math>\hat a \ \bar b \ \vec c \ \overrightarrow{a b} \ \overleftarrow{c d} \ \widehat{d e f} \ \overline{g h i} \ \underline{j k l}</math>

<math>\int_0^\infty x^\alpha \sin(x)\,dx = 2^\alpha \sqrt{\pi}\, \frac{\Gamma(\frac{\alpha}{2}+1)}{\Gamma(\frac{1}{2}-\frac{\alpha}{2})}\,</math>

<math>f(n+1)</math> <math>=(n+1)^2</math>
<math>=n^2 + 2n + 1</math>

Quellcode in Wiki-Artikeln

Text für Sourcecode in einer Box wie dieser hier durch Voranstellen
eines Leerzeichens an eine (jede) Zeile. 
Bei einer Leerzeile wird die Box abgeschlossen, der Text wird nicht automatisch umgebrochen!!\
sondern \
muss \
mit backslashes manuell umgebrochen werden.

<?php
class helloWorld {
    var $output= "";
    function setHelloWorld($text) {
        $this->output = $text;
    }
    function helloWorld() {
        echo $this->output;
    }
}
?>

Syntax Highlighting geht (im Moment noch) leider nur manuell: 

<?php
$blah = new helloWorld();
$blah->setHelloWorld("Hello World!");
$blah->helloWorld();
?>

Weitere Informationen dazu gibt es hier.

Weiterführende Informationen

Von „http://www.macwrench.de/wiki/Hilfe:Editierhilfe“
Persönliche Werkzeuge