de:tips:good_style
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungLetzte ÜberarbeitungBeide Seiten der Revision | ||
de:tips:good_style [2010-01-08 11:48] – 195.200.70.39 | de:tips:good_style [2023-06-12 11:59] – [Tipps für einen guten Stil] 109.90.15.2 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
====== Tipps für einen guten Stil ====== | ====== Tipps für einen guten Stil ====== | ||
- | Hier finden Sie einige Tipps um eine gute Wiki Seite zu erstellen. | + | Hier finden Sie einige Tipps, um eine gute Wiki Seite zu erstellen. |
+ | |||
+ | Scheinbar kann hier jeder unangemeldet Sachen ändern. Ist das gewollt? | ||
===== Seitenstruktur ===== | ===== Seitenstruktur ===== | ||
Zeile 7: | Zeile 9: | ||
* Beginnen Sie die Seite mit einer aussagekräftigen Überschrift erster Ordnung. | * Beginnen Sie die Seite mit einer aussagekräftigen Überschrift erster Ordnung. | ||
* Verschachteln Sie die Überschriften in der richtigen Reihenfolge, | * Verschachteln Sie die Überschriften in der richtigen Reihenfolge, | ||
- | * Gliedern Sie Ihren Text in Paragraphen, die Sie durch eine Leerzeile trennen. Ein durchschnittlicher | + | * Gliedern Sie Ihren Text in Absätze, die Sie durch eine Leerzeile trennen. Ein durchschnittlicher |
- | * Sollte Ihr Text länger als ein paar (ca. 3-5) Paragraphen | + | * Sollte Ihr Text länger als ein paar (ca. 3-5) Absätze |
* Schreiben Sie eine kurze Zusammenfassung des Inhalts nach der ersten Überschrift, | * Schreiben Sie eine kurze Zusammenfassung des Inhalts nach der ersten Überschrift, | ||
* Falls Sie viele Links zu anderen Wiki-Seiten oder externen Ressourcen haben, fügen Sie einen eigenen Absatz mit weiterführenden Quellen hinzu (siehe [[# | * Falls Sie viele Links zu anderen Wiki-Seiten oder externen Ressourcen haben, fügen Sie einen eigenen Absatz mit weiterführenden Quellen hinzu (siehe [[# | ||
* Falls mehrere Seiten eines [[: | * Falls mehrere Seiten eines [[: | ||
* Versuchen Sie, komplizierte Namensraum-Strukturen zu verhindern. Verwenden Sie stattdessen kurze, einfach zu merkende Namen für Namensräume. | * Versuchen Sie, komplizierte Namensraum-Strukturen zu verhindern. Verwenden Sie stattdessen kurze, einfach zu merkende Namen für Namensräume. | ||
+ | * Falls Sie als Wiki-Verantwortliche(r) bzw. Mitwirkende(r) weitere Unterstützung bei der Textformatierung und Seitenstrukturierung anbieten möchten, empfiehlt sich ebenfalls ein Blick auf das [[plugin: | ||
===== Textformatierung ===== | ===== Textformatierung ===== | ||
* Einzelne Wörter oder kurze Textpassagen können **fett** oder //kursiv// hervorgehoben werden. Wählen Sie eine Variante aus und wenden Sie diese konsequent an. | * Einzelne Wörter oder kurze Textpassagen können **fett** oder //kursiv// hervorgehoben werden. Wählen Sie eine Variante aus und wenden Sie diese konsequent an. | ||
* Wählen Sie eine Form, um Bildschirmausgaben und Texte auf dem Bildschirm darzustellen und benutzen Sie diese durchgehend. Vielleicht ist eine Seite mit Erklärungen Ihrer Stil-Konventionen eine gute Idee. | * Wählen Sie eine Form, um Bildschirmausgaben und Texte auf dem Bildschirm darzustellen und benutzen Sie diese durchgehend. Vielleicht ist eine Seite mit Erklärungen Ihrer Stil-Konventionen eine gute Idee. | ||
- | * Verwenden Sie [[: | + | * Verwenden Sie [[:de:wiki: |
- | * Verwenden Sie [[: | + | * Verwenden Sie [[:de:wiki: |
* Tabellen können die Lesbarkeit von strukturierten Daten stark erhöhen. Verwenden Sie aussagekräftige Spaltenüberschriften und eine Beschriftung, | * Tabellen können die Lesbarkeit von strukturierten Daten stark erhöhen. Verwenden Sie aussagekräftige Spaltenüberschriften und eine Beschriftung, | ||
* Lange Tabellen sind schwer zu bearbeiten. Vielleicht können Sie die Daten in einer verschachtelten Liste darstellen. | * Lange Tabellen sind schwer zu bearbeiten. Vielleicht können Sie die Daten in einer verschachtelten Liste darstellen. | ||
Zeile 28: | Zeile 30: | ||
* Beginnen Sie jeden Satz mit einem Großbuchstaben und beenden Sie ihn mit einem Punkt oder anderem Satzzeichen. | * Beginnen Sie jeden Satz mit einem Großbuchstaben und beenden Sie ihn mit einem Punkt oder anderem Satzzeichen. | ||
* Versuchen Sie kurze, klare Sätze zu schreiben, ohne viele Nebensätze zu benutzen. Wenn Sie denken, dass die Seite fertig ist, lesen Sie sie nochmal durch und verbessern Sie jeden Satz, der eine zu komplizierte Struktur hat. | * Versuchen Sie kurze, klare Sätze zu schreiben, ohne viele Nebensätze zu benutzen. Wenn Sie denken, dass die Seite fertig ist, lesen Sie sie nochmal durch und verbessern Sie jeden Satz, der eine zu komplizierte Struktur hat. | ||
- | * Entscheiden Sie sich, wie Sie Ihre Leser ansprechen. Da DokuWiki entwickelt wurde, um Dokumentationen zu schreiben, werden Sie oft Ihre Leser anweisen müssen, wie Dinge zu tun sind. Sie können die // | + | * Entscheiden Sie sich, wie Sie Ihre Leser ansprechen. Da DokuWiki entwickelt wurde, um Dokumentationen zu schreiben, werden Sie oft Ihre Leser anweisen müssen, wie Dinge zu tun sind. Sie können die // |
* Überprüfen Sie die Seite vor dem Speichern auf Grammatik- und Rechtschreibfehler. Beinhaltet Ihr Text zu viele Fehler, wirkt sich das auf die Glaubwürdigkeit Ihrer Aussagen aus, unabhängig davon wie durchdacht sie sind. | * Überprüfen Sie die Seite vor dem Speichern auf Grammatik- und Rechtschreibfehler. Beinhaltet Ihr Text zu viele Fehler, wirkt sich das auf die Glaubwürdigkeit Ihrer Aussagen aus, unabhängig davon wie durchdacht sie sind. | ||
* Entwickeln Sie Ihren eigenen Schreibstil. Zwingen Sie sich keinen Schreibstil auf, mit dem Sie sich nicht wohl fühlen. Das würde sich nur unnatürlich anhören und wäre unangenehm zu lesen. | * Entwickeln Sie Ihren eigenen Schreibstil. Zwingen Sie sich keinen Schreibstil auf, mit dem Sie sich nicht wohl fühlen. Das würde sich nur unnatürlich anhören und wäre unangenehm zu lesen. | ||
Zeile 44: | Zeile 46: | ||
===== Bilder und andere Medien ===== | ===== Bilder und andere Medien ===== | ||
- | * "Ein Bild sagt mehr als tausend Worte." | + | * "Ein Bild sagt mehr als tausend Worte." |
* Verwenden Sie eine Beschriftung, | * Verwenden Sie eine Beschriftung, | ||
* Falls Sie das Bild nicht selbst erstellt haben, nennen Sie die Quelle (wenn möglich mit einem Link) und das Copyright. | * Falls Sie das Bild nicht selbst erstellt haben, nennen Sie die Quelle (wenn möglich mit einem Link) und das Copyright. | ||
* Verlinken Sie keine Bilder von externen Seiten, außer es wurde Ihnen ausdrücklich erlaubt. Dies ist in erster Linie eine Sache des Copyright, kann aber auch ein Problem durch Stehlen von Bandbreite sein, falls [[config: | * Verlinken Sie keine Bilder von externen Seiten, außer es wurde Ihnen ausdrücklich erlaubt. Dies ist in erster Linie eine Sache des Copyright, kann aber auch ein Problem durch Stehlen von Bandbreite sein, falls [[config: | ||
- | * Benutzen Sie einen [[: | + | * Benutzen Sie einen [[:de:wiki: |
de/tips/good_style.txt · Zuletzt geändert: 2023-06-12 12:28 von saggi