Benutzer:Andreas Plank/Qualität von Artikeln: Unterschied zwischen den Versionen

Aus Open Source Ecology - Germany
Zur Navigation springen Zur Suche springen
 
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
(Im Entwurf --[[Benutzer:Andreas Plank|Andreas Plank]] ([[Benutzer Diskussion:Andreas Plank|Diskussion]]) 17:15, 20. Apr. 2018 (CEST))
 
(Im Entwurf --[[Benutzer:Andreas Plank|Andreas Plank]] ([[Benutzer Diskussion:Andreas Plank|Diskussion]]) 17:15, 20. Apr. 2018 (CEST))
  
In der Anleitung „[[Hilfe:Der Umgang mit dem Wiki|Der Umgang mit dem Wiki]]“ wird ausführlicher auf Formatierungen eingegangen als das hier möglich ist, und in der tabellarischen [[Hilfe:Bearbeiten|Bearbeitungshilfe]] ist versucht, alles übersichtlich (knapp) zusammenzufassen. Will man eine neue Seite erstellen, gibt man am besten den neuen Seitentitel in die Suchbox rechts oben ein und falls nicht schon eine ähnliche Seite existiert, kann man von der Ergebnisseite aus diese neue Seite erstellen.
+
<!-- In der Anleitung „[[Hilfe:Der Umgang mit dem Wiki|Der Umgang mit dem Wiki]]“ wird ausführlicher auf Formatierungen eingegangen als das hier möglich ist, und in der tabellarischen [[Hilfe:Bearbeiten|Bearbeitungshilfe]] ist versucht, alles übersichtlich (knapp) zusammenzufassen. Will man eine neue Seite erstellen, gibt man am besten den neuen Seitentitel in die Suchbox rechts oben ein und falls nicht schon eine ähnliche Seite existiert, kann man von der Ergebnisseite aus diese neue Seite erstellen.
 +
-->
  
<big>Hier nun ein Schnellkurs für Formatierungen:</big>
+
== Schlechte Gestaltung vs. Von qualitativen Mängeln hin zu gut geschriebenen Artikeln ==
* ''jede'' neue Leerzeile bewirkt einen ''neuen'' Absatz
 
* <code><nowiki>'''fett''', ''kursiv'', und '''''fett-kursiv'''''</nowiki></code><br /> ergibt '''fett''', ''kursiv'', und '''''fett-kursiv'''''
 
* <code><nowiki>[[Seitenname]]</nowiki></code> verlinkt zur internen {{SITENAME}} Wikiseite [[Seitenname]] <br />(Hinweis: ein [[roter Link]] kennzeichnet die Seite als noch nicht existierend, aber als '''neu erstellbare Seite''')
 
* <code><nowiki>[[Seitenname | abweichender Text]]</nowiki></code> verlinkt auf dieselbe Seite, aber mittels Alternativtext durch ein zusätzliches „|“ getrennt und ergibt [[Seitenname | abweichender Text]].
 
*  <code><nowiki>[http://species-id.net Testlink nach Species-ID]</nowiki></code> verlinkt die externe Seite „<nowiki>http://species-id.net</nowiki>“ als [http://species-id.net Testlink nach Species-ID], zusätzlich gekennzeichnet durch einen Pfeil [[File:External.svg|10px|link=]]. (Hinweis: Trennung erfolgt mit Leerzeichen „<tt>&nbsp;</tt>“ statt „|“).
 
 
 
<big>Einige wichtige Formatierungen funktionieren ''nur'', wenn das jeweilige Zeichen genau das ''erste'' Zeichen der Zeile ist:</big>
 
 
 
<code>* </code>→ unnummerierter Listenpunkt  (** → doppelte, *** → dreifache Einrückung)<br />
 
<code># </code>→ nummerierter Listenpunkt (## → doppelte, ### → dreifache Einrückung)<br />
 
<code>: </code>→ Zeile eingerückt (:: → doppelte, ::: → dreifache Einrückung)<br />
 
<code>; Begriff : Erklärung</code> → Begriffserklärungen<br />
 
<code>==&nbsp;Abschnitt&nbsp;== </code>→ Überschriften (Hinweis: „=“ muß die Überschrift umschließen; ==&nbsp;→&nbsp;2.&nbsp;Ebene, ===&nbsp;→&nbsp;3.&nbsp;Ebene )<br />
 
„<code> Mit einem Leerzeichen beginnende Zeilen erscheinen als gerahmter Schreibmaschinentext vor grauem Hintergrund ohne Zeilenumbruch</code>“ ergibt: <br />
 
Mit einem Leerzeichen beginnende Zeilen erscheinen als gerahmter Schreibmaschinentext vor grauem Hintergrund ohne Zeilenumbruch
 
 
 
== Schlechte Gestaltung Von qualitativen Mängeln hin zu gut geschriebenen Artikeln ==
 
  
 
Artikel, die stümperhaft geschrieben sind, erwirken wahrscheinlich ein chaotisches Wahrnehmungsbild beim Lesen, daher empfehlen wir beim Schreiben von Wiki-Artikeln folgendes:
 
Artikel, die stümperhaft geschrieben sind, erwirken wahrscheinlich ein chaotisches Wahrnehmungsbild beim Lesen, daher empfehlen wir beim Schreiben von Wiki-Artikeln folgendes:
; Seitentitel: Verständliche Seitentitel: Abkürzungen ausschreiben und verständlich machen, also statt „''OTELO''“ besser „''Offenes Technologielabor (OTELO)''“ (Hinweis: es ist dann besser auf der Seite „''OTELO''“ eine Weiterleitung auf die Seite „''Offenes Technologielabor (OTELO)''“ einzurichten mit <nowiki>#WEITERLEITUNG [[Offenes Technologielabor (OTELO)]]</nowiki>, also auf den tatsächlichen Artikel, denn Weiterleitung auf Weiterleitung auf Artikel verwirkt sich)
+
; Seitentitel: <ul><!--
; Sorgfalt: Sorgfältig überlegen, strukturieren und ''dann'' schreiben. Schreibe so, dass der Artikel auch noch in 30 Jahren lesbar ist, ohne dass Mediendateien fehlen.
+
--><li>Verständliche Seitentitel: Abkürzungen ausschreiben und verständlich machen, also statt „''OTELO''“ besser „''Offenes Technologielabor (OTELO)''“ </li><!--
 +
--><li>sinnvolle Weiterleitungen: es ist besser die Seite der Abkürzung „''OTELO''“ als eine Weiterleitung auf die Seite „''Offenes Technologielabor (OTELO)''“ zu erstellen mit <nowiki>#WEITERLEITUNG [[Offenes Technologielabor (OTELO)]]</nowiki>. </li><!--
 +
--><li>Beachte: 2&nbsp;Zwischenebenen z.B. Weiterleitung auf Weiterleitung auf Artikel hingegen verwirkt sich und eine Weiterleitung erfolgt nicht</li><!--
 +
--></ul>
 +
; Sorgfalt & Dauerhaftigkeit: <ul><!--
 +
--><li>Sorgfältig überlegen, strukturieren und ''dann'' schreiben. Schreibe so, dass der Artikel auch noch in 30{{nnbsp}}Jahren lesbar ist, ohne dass Mediendateien fehlen.</li><!--
 +
--><li>verwende Links, die stabil bleiben;</li><!--
 +
--><li>falls möglich lade externe Bilder (so es das Urheberrecht erlaubt) in das Wiki, damit die Information auch noch in 10{{nnbsp}}Jahren lesbar bleibt</li></ul>
 +
; Überschriften : <ul><!--
 +
--><li>Abschnitte (nur) dazu verwenden, um eine gute Seitenstruktur zu gestalten, die den Inhalt unterstützt. </li><!--
 +
--><li>Vermeide gänzlich leere TODO-Abschnitte (auch wenns sie später hinzugefügt werden wollen)</li><!--
 +
--></ul>
 
; Weniger ist oft mehr : Üppige Formatierung vermeiden und sparsam verwenden, siehe hierzu auch Bier (2009)<ref name='Bier2009'>Bier, Christoph (2009): ''typokurz&nbsp;– Einige wichtige  typografische Regeln''. Version 1.7, 21.&nbsp;Mai 2009. URL: https://zvisionwelt.files.wordpress.com/2012/01/typokurz.pdf. Gesichtet am 5. 2. 2010.</ref>
 
; Weniger ist oft mehr : Üppige Formatierung vermeiden und sparsam verwenden, siehe hierzu auch Bier (2009)<ref name='Bier2009'>Bier, Christoph (2009): ''typokurz&nbsp;– Einige wichtige  typografische Regeln''. Version 1.7, 21.&nbsp;Mai 2009. URL: https://zvisionwelt.files.wordpress.com/2012/01/typokurz.pdf. Gesichtet am 5. 2. 2010.</ref>
; Überschriften : Abschnitte (nur) dazu verwenden, um eine gute Seitenstruktur zu gestalten, die den Inhalt unterstützt, vermeide gänzlich leere Abschnitte
 
  
 
Weitere Anliegen, die keine gute Artikelgestaltung erwirken, stellt die folgende Übersicht zusammen (darf ergänzt werden ;-)
 
Weitere Anliegen, die keine gute Artikelgestaltung erwirken, stellt die folgende Übersicht zusammen (darf ergänzt werden ;-)
Zeile 40: Zeile 34:
 
|-
 
|-
 
|
 
|
* Defekte Werkzeuge oder eingebundene Tools
+
Defekte Werkzeuge oder eingebundene Tools:
 
* 404-Seiten (Seite nicht gefunden)
 
* 404-Seiten (Seite nicht gefunden)
 
* 500 Seiten (Interner Server Fehler)
 
* 500 Seiten (Interner Server Fehler)
 
|<ul>
 
|<ul>
<li>möglichst nur Links verwenden, die nachhaltig auch bleiben werden
+
<li>möglichst nur Links verwenden, die dauerhaft auch bleiben werden</li>
<li>Link mit Datum (letzter Zugriff: XX.y.2018), Seitenbeispiel
+
<li>Link mit Datum (letzter Zugriff: XX.y.2018), Seitenbeispiel:
 
<pre style="font-size:smaller;border:1px dotted gray;">
 
<pre style="font-size:smaller;border:1px dotted gray;">
 
Text Text http://www.example.org<ref>Titel, Autor (letzter Zugriff: XX.y.2018), eventueller Kommentar</ref> Text Text
 
Text Text http://www.example.org<ref>Titel, Autor (letzter Zugriff: XX.y.2018), eventueller Kommentar</ref> Text Text
Zeile 52: Zeile 46:
 
== Anmerkungen ==
 
== Anmerkungen ==
 
<references/>
 
<references/>
</pre>
+
</pre></li>
<li>oder gänzlich weglassen
+
<li>oder gänzlich weglassen</li>
 
</ul>
 
</ul>
 
|  
 
|  
Zeile 71: Zeile 65:
 
* siehe auch [[Hilfe:Übersetzen von Seiten]]
 
* siehe auch [[Hilfe:Übersetzen von Seiten]]
 
|  
 
|  
 +
|-
 +
|
 +
* vermeide zu breite Bilder
 +
| bei mehr als 800px breit werden sie beim Drucken auf DIN A4 randlich abgeschnitten, da zu groß
 +
|
 
|-
 
|-
 
|  
 
|  

Aktuelle Version vom 1. Juni 2018, 10:53 Uhr

(Im Entwurf --Andreas Plank (Diskussion) 17:15, 20. Apr. 2018 (CEST))


Schlechte Gestaltung vs. Von qualitativen Mängeln hin zu gut geschriebenen Artikeln

Artikel, die stümperhaft geschrieben sind, erwirken wahrscheinlich ein chaotisches Wahrnehmungsbild beim Lesen, daher empfehlen wir beim Schreiben von Wiki-Artikeln folgendes:

Seitentitel
  • Verständliche Seitentitel: Abkürzungen ausschreiben und verständlich machen, also statt „OTELO“ besser „Offenes Technologielabor (OTELO)
  • sinnvolle Weiterleitungen: es ist besser die Seite der Abkürzung „OTELO“ als eine Weiterleitung auf die Seite „Offenes Technologielabor (OTELO)“ zu erstellen mit #WEITERLEITUNG [[Offenes Technologielabor (OTELO)]].
  • Beachte: 2 Zwischenebenen z.B. Weiterleitung auf Weiterleitung auf Artikel hingegen verwirkt sich und eine Weiterleitung erfolgt nicht
Sorgfalt & Dauerhaftigkeit
  • Sorgfältig überlegen, strukturieren und dann schreiben. Schreibe so, dass der Artikel auch noch in 30 Jahren lesbar ist, ohne dass Mediendateien fehlen.
  • verwende Links, die stabil bleiben;
  • falls möglich lade externe Bilder (so es das Urheberrecht erlaubt) in das Wiki, damit die Information auch noch in 10 Jahren lesbar bleibt
Überschriften
  • Abschnitte (nur) dazu verwenden, um eine gute Seitenstruktur zu gestalten, die den Inhalt unterstützt.
  • Vermeide gänzlich leere TODO-Abschnitte (auch wenns sie später hinzugefügt werden wollen)
Weniger ist oft mehr
Üppige Formatierung vermeiden und sparsam verwenden, siehe hierzu auch Bier (2009)[1]

Weitere Anliegen, die keine gute Artikelgestaltung erwirken, stellt die folgende Übersicht zusammen (darf ergänzt werden ;-)

Problem/Anliegen Lösung Kommentar
Externe Mediendateien, die irgendwann einmal verschwinden werden
  • falls eine „freie“ Lizenz vorliegt, Datei ins Wiki hochladen mit Angaben zu Urheber, Lizenzangaben, Datum, Beschreibung

Defekte Werkzeuge oder eingebundene Tools:

  • 404-Seiten (Seite nicht gefunden)
  • 500 Seiten (Interner Server Fehler)
  • möglichst nur Links verwenden, die dauerhaft auch bleiben werden
  • Link mit Datum (letzter Zugriff: XX.y.2018), Seitenbeispiel:
    Text Text http://www.example.org<ref>Titel, Autor (letzter Zugriff: XX.y.2018), eventueller Kommentar</ref> Text Text
    Text Text Text Text Text Text Text Text
    
    == Anmerkungen ==
    <references/>
    
  • oder gänzlich weglassen
Seiten mit nur einem Link
  • benutzerfreundliche Seitenvorgaben anbieten
  • wenigstens eine Kurzbeschreibung am Anfang der Seite & ein Abschnitt „== Weblinks ==
  • Denglische Schreibweise
  • oder Mix von Englisch mit Deutsch auf derselben Seite
  • Überschrift in Deutsch aber Absatztext in Englisch
  • vermeide zu breite Bilder
bei mehr als 800px breit werden sie beim Drucken auf DIN A4 randlich abgeschnitten, da zu groß
  • vermeide das Einbinden externer Seiten mittels <iframe>

Falls die Seite auch gedruckt werden soll, ist häufig das Problem, dass iframes von Browsern nicht richtig gedruckt werden: z.B. kann es sein, dass er nur als weiße Fläche zu sehen ist

Anmerkungen

  1. Bier, Christoph (2009): typokurz – Einige wichtige typografische Regeln. Version 1.7, 21. Mai 2009. URL: https://zvisionwelt.files.wordpress.com/2012/01/typokurz.pdf. Gesichtet am 5. 2. 2010.