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

Version vom 21. Dezember 2006, 11:38 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).

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)

• Wasserzeichen

Das DGL Wasserzeichen sollte auf alle Bilder aufgebracht werden, um ihre Herkunft zu dokumentieren. Das Wasserzeichen sollte so angebracht werden, dass ein Entfernen schierig 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:

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.