DGL Wiki:Hinweise zum Artikel erstellen: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Allgemein)
K (Bilder)
 
(19 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
==Allgemein==
 
==Allgemein==
Wenn man noch keine Wiki Erfahrung hat sollte man sich die [[DGL_Wiki:Editierhilfe]] durchlesen, bevor man einen Artikel erstellt. (Sie enthält auch tiefergehende Informationen, wie z.B. vorhandene Wikivorlagen)
+
Wenn man noch keine Wiki Erfahrung hat, sollte man sich die [[DGL_Wiki:Editierhilfe]] durchlesen, bevor man einen Artikel erstellt (diese enthält auch tiefergehende Informationen, wie z.B. vorhandene Wikivorlagen).
Es kommt nicht darauf an, dass Artikel, die ihr erstellt schon perfekt sind, was auch kaum möglich ist. Wichtig ist, dass ihr überhaupt beim Wiki mithelft und wir es so schnell zu einem umfassenden OpenGL-Nachschlagewerk werden lassen. Auch wenn ihr noch unerfahren im Umgang mit Wikis seid, solltet ihr euch an folgende Konventionen halten:
+
Es kommt nicht darauf an, dass Artikel, die ihr erstellt, schon perfekt sind, was auch kaum möglich ist. Wichtig ist, dass ihr überhaupt beim Wiki mithelft und wir es so schnell zu einem umfassenden OpenGL-Nachschlagewerk werden lassen.  
 +
 
 +
Wenn ihr einmal Zweifel habt, wie ein Artikel gebaut sein soll, dann schaut euch einfach einen ähnlichen bestehenden Artikel an - einfach auf ''bearbeiten'' klicken.
 +
 
 +
Auch wenn ihr noch unerfahren im Umgang mit Wikis seid, solltet ihr euch an folgende Konventionen halten:
  
 
=== Namenskonventionen ===
 
=== Namenskonventionen ===
Wie auf Wikipedia gilt die [http://de.wikipedia.org/wiki/Wikipedia:Namenskonventionen#Singularregel Singularregel].
+
Wie auf Wikipedia gilt die [http://de.wikipedia.org/wiki/Wikipedia:Namenskonventionen#Singularregel Singularregel], das heißt, dass Artikel immer in der Einzahl zu benennen sind (zum Beispiel "Polygon" statt "Polygone")
  
 
===Bilder===
 
===Bilder===
 
Bilder sind in diesem Wiki hoch willkommen. Schließlich ist OpenGL ein Mittel zur visuellen Darstellung.<br>
 
Bilder sind in diesem Wiki hoch willkommen. Schließlich ist OpenGL ein Mittel zur visuellen Darstellung.<br>
 
Wenn ihr Bilder hochladen wollt, dann fügt in diese bitte unser DGL-Wiki-[[Wasserzeichen]] ein.
 
Wenn ihr Bilder hochladen wollt, dann fügt in diese bitte unser DGL-Wiki-[[Wasserzeichen]] ein.
Bitte beachtet, dass ihr keine Bilder nutzt, deren Copyright ihr nicht besitzt oder deren Copyright nicht der der "GNU Freie Dokumentationslizenz" entspricht. Bilder hochladen können nur angemeldete Mitglieder (Über den Link bei "Werkzeuge" (links unten)). Nach dem Hochladen erhaltet ihr Informationen wie das Bild in einem Artikel benutzt werden kann. (Mehr Informationen zur Benutzung von Bildern findet ihr in der [[DGL_Wiki:Editierhilfe]] und in der [http://de.wikipedia.org/wiki/Wikipedia:Bilder#Bilder_einbinden Wikipediahilfe]).
+
Bitte beachtet, dass ihr keine Bilder nutzt, deren Copyright ihr nicht besitzt oder deren Copyright nicht der der "GNU Freie Dokumentationslizenz" entspricht. Bilder hochladen können nur angemeldete Mitglieder (über den Link bei "Werkzeuge" (links unten)). Nach dem Hochladen erhaltet ihr Informationen, wie das Bild in einem Artikel benutzt werden kann. (Mehr Informationen zur Benutzung von Bildern findet ihr in der [[DGL_Wiki:Editierhilfe]] und in der [http://de.wikipedia.org/wiki/Wikipedia:Bilder#Bilder_einbinden Wikipediahilfe]).
 +
 
 +
{{Hinweis|Eine Liste mit Artikeln welche noch ein Bild benötigen könnt ihr in der [[:Kategorie:Bildwunsch]] finden.}}
 +
 
 +
Nachfolgend ein paar (unverbindliche) Gestaltungsregeln:
 +
* Hintergrund
 +
:Der Hintergrund sollte weiß sein, da sich dadurch das Bild harmonisch in die Seite einfügt (der Seitenhintergrund ist auch weiß).
 +
 
 +
* Objektfarbe/Objektgestaltung
 +
:Die Objekte sollten farblich in gutem Kontrast zum Hintergrund stehen. Idealerweiße sollten Objekte, die räumlich sind/dargestellt werden, mit aktiver Beleuchtung gerendert werden, da dadurch die dritte Dimension besser zu Geltung kommt.
 +
 
 +
* Parameter erklären
 +
:Falls das Bild eine [[OpenGL-Funktionsübersicht|OpenGL-Funktion]] erklären soll, sollten die Parameter bzw. deren Wirkung im Bild kenntlich gemacht werden. (Siehe z.B. [[gluPartialDisk]], [[glRotate]], [[glScale]], [[glTranslate]])
 +
 
 +
* [[Wasserzeichen]]
 +
:Das DGL Wasserzeichen sollte auf alle Bilder aufgebracht werden, um ihre Herkunft zu dokumentieren. Das Wasserzeichen sollte so angebracht werden, dass ein Entfernen schwierig wird.
 +
 
 +
* Texturen
 +
:Falls Texturen verwendet werden, sollte - wenn möglich/sinnvoll - das Wikilogo als Textur benutzt werden. Auf diese Weise schützt man das Bild effektiv vor Inhalteklau. Das Wasserzeichen kann dann entfallen.
  
 
==Ich möchte einen Artikel über eine OpenGL/SDL Funktion erstellen==
 
==Ich möchte einen Artikel über eine OpenGL/SDL Funktion erstellen==
 
Bitte nehmt in diesem Fall die [[Funktionsvorlage]] (für SDL die [[SDL_Funktionsvorlage]]) als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.<br>
 
Bitte nehmt in diesem Fall die [[Funktionsvorlage]] (für SDL die [[SDL_Funktionsvorlage]]) als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.<br>
Eine einheitliche Formatierung der Artikel ist nicht nur schick sondern hilft später auch Informationen schnell zu finden.
+
Eine einheitliche Formatierung der Artikel ist nicht nur schick, sondern hilft später auch, Informationen schnell zu finden.
Die englischen [http://www.opengl.org/documentation/specs/man_pages/hardcopy/GL/html/gl/ orginal Spezifikationen] von OpenGL.org können als Nachschlage Werk bei der Artikelerstellung helfen (Für SDL ist das englische [http://www.libsdl.org/cgi/docwiki.cgi/ Dokumentationswiki] bei libSDL.org hilfreich). Erst wenn die Basisinfos vorhanden sind sollte man Zusatzinfos wie häufige Fehlerquellen eintragen. Weitere Regeln:
+
Die englischen [http://www.opengl.org/documentation/specs/man_pages/hardcopy/GL/html/gl/ orginal Spezifikationen] von OpenGL.org können als Nachschlagewerk bei der Artikelerstellung helfen (Für SDL ist das englische [http://www.libsdl.org/cgi/docwiki.cgi/ Dokumentationswiki] bei libSDL.org hilfreich). Weitere Quellen für Orginalspezifikationen findet ihr bei den [[Link]]s.
 +
Erst wenn die Basisinfos vorhanden sind sollte man Zusatzinfos, wie z.B. häufige Fehlerquellen, eintragen. Das bedeutet, dass alle Informationen der original Specs vorhanden sein müssen. Es darf zu keinem Informationsverlust kommen.
 +
 
 +
Weitere Regeln:
  
 
*Tritt irgendwo im Text der Name der Funktion auf, zu welcher der Text gehört, wird der '''Funktionsname''' fett geschrieben.
 
*Tritt irgendwo im Text der Name der Funktion auf, zu welcher der Text gehört, wird der '''Funktionsname''' fett geschrieben.
Zeile 21: Zeile 46:
 
*Vermeidet Sackgassenartikel. Das heißt, jeder Artikel sollte auf weitere verwandte Artikel verlinken.
 
*Vermeidet Sackgassenartikel. Das heißt, jeder Artikel sollte auf weitere verwandte Artikel verlinken.
  
Solltet ihr Teile nicht übersetzen können kopiert ihr diese bitte direkt in den Artikel und markiert sie entsprechend (siehe folgende Hinweise).
+
Solltet ihr Teile nicht übersetzen können, kopiert diese bitte direkt in den Artikel und markiert sie entsprechend (siehe folgende Hinweise).
  
 
==Ich möchte einen Artikel über eine OpenGL Extension erstellen==
 
==Ich möchte einen Artikel über eine OpenGL Extension erstellen==
 
Bitte nehmt in diesem Fall die [[Extensionvorlage]] als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.<br>
 
Bitte nehmt in diesem Fall die [[Extensionvorlage]] als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.<br>
Eine einheitliche Formatierung der Artikel ist nicht nur schick sondern hilft später auch Informationen schnell zu finden.
+
Eine einheitliche Formatierung der Artikel ist nicht nur schick, sondern hilft später auch, Informationen schnell zu finden.
Auch hier gilt: Haltet euch an die Informationen der [http://oss.sgi.com/projects/ogl-sample/registry/ Orginalspezifikation] bevor ihr weitere Infos hinzufügt.
+
Auch hier gilt: Haltet euch an die Informationen der [http://oss.sgi.com/projects/ogl-sample/registry/ Orginalspezifikation], bevor ihr weitere Infos hinzufügt.
  
 
==Mein Artikel ist nicht vollständig==
 
==Mein Artikel ist nicht vollständig==
 
Dies stellt kein Problem dar, denn auch ein unvollständiger Artikel bringt das Wiki weiter.
 
Dies stellt kein Problem dar, denn auch ein unvollständiger Artikel bringt das Wiki weiter.
Bitte tragt dann auf der Seite [[:Kategorie:Unvollständig]] ein, was noch gemacht werden muss, damit andere Autoren ihn vervollständigen können.<br>
+
Bitte tragt dann auf [[:Kategorie:Unvollständig|dieser Seite]] ein, was noch gemacht werden muss, damit andere Autoren ihn vervollständigen können.<br>
 
Außerdem solltet ihr in die erste Zeile des Artikels den Wikikode
 
Außerdem solltet ihr in die erste Zeile des Artikels den Wikikode
 
  <nowiki>{{Unvollständig}}</nowiki>
 
  <nowiki>{{Unvollständig}}</nowiki>
eintragen. Dadurch wird ein Hinweis angezeigt, dass der Artikel von euch als noch unvollständig angesehen wird. Vorallem soll dieser Hinweis angegeben werden, wenn Teile des Artikels noch nicht übersetzt sind.
+
eintragen. Dadurch wird ein Hinweis angezeigt, dass der Artikel von euch als noch unvollständig angesehen wird. Vor allem sollte dieser Hinweis angegeben werden, wenn ganze Teile des Artikels noch nicht übersetzt sind.
  
 
===Teile des Artikels sind noch nicht übersetzt===
 
===Teile des Artikels sind noch nicht übersetzt===
Zusätzlich zu obigen Sachen soll der unübersetzte Teil des Texts kursiv und fett markiert werden:
+
Zusätzlich zu obigen Dingen sollte der unübersetzte Teil des Texts kursiv und fett markiert werden:
  
 
<div align="center">
 
<div align="center">
{|{{Prettytable}}
+
{|{{Prettytable_B1}}
 
!Mit HTML
 
!Mit HTML
 
!Mit Wikicode
 
!Mit Wikicode
Zeile 50: Zeile 75:
  
 
==Ich möchte Artikel offline schreiben==
 
==Ich möchte Artikel offline schreiben==
Falls ihr einen Artikel offline schreiben wollt so editiert diesen Artikel und fügt diesen Text ein:
+
Falls ihr einen Artikel offline schreiben wollt, so editiert diesen Artikel und fügt diesen Text ein:
 
  <nowiki>{{Offline}}</nowiki>
 
  <nowiki>{{Offline}}</nowiki>
Auf diese Weise wird verhindert das in der zwischenzeit jemand anders den Artikel erstellt oder bearbeitet.<br>
+
Auf diese Weise wird verhindert, dass in der Zwischenzeit jemand anders den Artikel erstellt oder bearbeitet.<br>
Wenn Ihr es euch doch wieder anders überlegt habt dann ersetzt den Hinweis bitte durch <nowiki>{{Unvollständig}}</nowiki> und tragt ihn in der oben genannten Übersicht ein.
+
Wenn Ihr es euch doch wieder anders überlegt habt, dann ersetzt den Hinweis bitte durch <nowiki>{{Unvollständig}}</nowiki> und tragt ihn in der oben genannten Übersicht ein.

Aktuelle Version vom 2. Juli 2007, 11:18 Uhr

Allgemein

Wenn man noch keine Wiki Erfahrung hat, sollte man sich die DGL_Wiki:Editierhilfe durchlesen, bevor man einen Artikel erstellt (diese enthält auch tiefergehende Informationen, wie z.B. vorhandene Wikivorlagen). Es kommt nicht darauf an, dass Artikel, die ihr erstellt, schon perfekt sind, was auch kaum möglich ist. Wichtig ist, dass ihr überhaupt beim Wiki mithelft und wir es so schnell zu einem umfassenden OpenGL-Nachschlagewerk werden lassen.

Wenn ihr einmal Zweifel habt, wie ein Artikel gebaut sein soll, dann schaut euch einfach einen ähnlichen bestehenden Artikel an - einfach auf bearbeiten klicken.

Auch wenn ihr noch unerfahren im Umgang mit Wikis seid, solltet ihr euch an folgende Konventionen halten:

Namenskonventionen

Wie auf Wikipedia gilt die Singularregel, das heißt, dass Artikel immer in der Einzahl zu benennen sind (zum Beispiel "Polygon" statt "Polygone")

Bilder

Bilder sind in diesem Wiki hoch willkommen. Schließlich ist OpenGL ein Mittel zur visuellen Darstellung.
Wenn ihr Bilder hochladen wollt, dann fügt in diese bitte unser DGL-Wiki-Wasserzeichen ein. Bitte beachtet, dass ihr keine Bilder nutzt, deren Copyright ihr nicht besitzt oder deren Copyright nicht der der "GNU Freie Dokumentationslizenz" entspricht. Bilder hochladen können nur angemeldete Mitglieder (über den Link bei "Werkzeuge" (links unten)). Nach dem Hochladen erhaltet ihr Informationen, wie das Bild in einem Artikel benutzt werden kann. (Mehr Informationen zur Benutzung von Bildern findet ihr in der DGL_Wiki:Editierhilfe und in der Wikipediahilfe).

Info DGL.png Eine Liste mit Artikeln welche noch ein Bild benötigen könnt ihr in der Kategorie:Bildwunsch finden.

Nachfolgend ein paar (unverbindliche) Gestaltungsregeln:

  • Hintergrund
Der Hintergrund sollte weiß sein, da sich dadurch das Bild harmonisch in die Seite einfügt (der Seitenhintergrund ist auch weiß).
  • Objektfarbe/Objektgestaltung
Die Objekte sollten farblich in gutem Kontrast zum Hintergrund stehen. Idealerweiße sollten Objekte, die räumlich sind/dargestellt werden, mit aktiver Beleuchtung gerendert werden, da dadurch die dritte Dimension besser zu Geltung kommt.
  • Parameter erklären
Falls das Bild eine OpenGL-Funktion erklären soll, sollten die Parameter bzw. deren Wirkung im Bild kenntlich gemacht werden. (Siehe z.B. gluPartialDisk, glRotate, glScale, glTranslate)
Das DGL Wasserzeichen sollte auf alle Bilder aufgebracht werden, um ihre Herkunft zu dokumentieren. Das Wasserzeichen sollte so angebracht werden, dass ein Entfernen schwierig wird.
  • Texturen
Falls Texturen verwendet werden, sollte - wenn möglich/sinnvoll - das Wikilogo als Textur benutzt werden. Auf diese Weise schützt man das Bild effektiv vor Inhalteklau. Das Wasserzeichen kann dann entfallen.

Ich möchte einen Artikel über eine OpenGL/SDL Funktion erstellen

Bitte nehmt in diesem Fall die Funktionsvorlage (für SDL die SDL_Funktionsvorlage) als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.
Eine einheitliche Formatierung der Artikel ist nicht nur schick, sondern hilft später auch, Informationen schnell zu finden. Die englischen orginal Spezifikationen von OpenGL.org können als Nachschlagewerk bei der Artikelerstellung helfen (Für SDL ist das englische Dokumentationswiki bei libSDL.org hilfreich). Weitere Quellen für Orginalspezifikationen findet ihr bei den Links. Erst wenn die Basisinfos vorhanden sind sollte man Zusatzinfos, wie z.B. häufige Fehlerquellen, eintragen. Das bedeutet, dass alle Informationen der original Specs vorhanden sein müssen. Es darf zu keinem Informationsverlust kommen.

Weitere Regeln:

  • Tritt irgendwo im Text der Name der Funktion auf, zu welcher der Text gehört, wird der Funktionsname fett geschrieben.
  • Tritt irgendwo im Text der Name eines Parameters auf, welcher zur Funktion gehört, wird der Parametername kursiv geschrieben.
  • Tritt irgendwo im Text eine OpenGL/SDL-Konstante auf, wird die OPENGL_ODER_SDL_KONSTANTE komplett groß und fett geschrieben.
  • Vermeidet Sackgassenartikel. Das heißt, jeder Artikel sollte auf weitere verwandte Artikel verlinken.

Solltet ihr Teile nicht übersetzen können, kopiert diese bitte direkt in den Artikel und markiert sie entsprechend (siehe folgende Hinweise).

Ich möchte einen Artikel über eine OpenGL Extension erstellen

Bitte nehmt in diesem Fall die Extensionvorlage als Grundlage für den Artikel, damit eine einheitliche Erscheinung der Artikel gewährleistet ist.
Eine einheitliche Formatierung der Artikel ist nicht nur schick, sondern hilft später auch, Informationen schnell zu finden. Auch hier gilt: Haltet euch an die Informationen der Orginalspezifikation, bevor ihr weitere Infos hinzufügt.

Mein Artikel ist nicht vollständig

Dies stellt kein Problem dar, denn auch ein unvollständiger Artikel bringt das Wiki weiter. Bitte tragt dann auf dieser Seite ein, was noch gemacht werden muss, damit andere Autoren ihn vervollständigen können.
Außerdem solltet ihr in die erste Zeile des Artikels den Wikikode

{{Unvollständig}}

eintragen. Dadurch wird ein Hinweis angezeigt, dass der Artikel von euch als noch unvollständig angesehen wird. Vor allem sollte dieser Hinweis angegeben werden, wenn ganze Teile des Artikels noch nicht übersetzt sind.

Teile des Artikels sind noch nicht übersetzt

Zusätzlich zu obigen Dingen sollte der unübersetzte Teil des Texts kursiv und fett markiert werden:

Mit HTML Mit Wikicode
<b><i> untranslated text </i></b> '''''untranslated text'''''
(5x Hochkomma ( ' ) )

Ich möchte Artikel offline schreiben

Falls ihr einen Artikel offline schreiben wollt, so editiert diesen Artikel und fügt diesen Text ein:

{{Offline}}

Auf diese Weise wird verhindert, dass in der Zwischenzeit jemand anders den Artikel erstellt oder bearbeitet.
Wenn Ihr es euch doch wieder anders überlegt habt, dann ersetzt den Hinweis bitte durch {{Unvollständig}} und tragt ihn in der oben genannten Übersicht ein.