VOICE Homepage: http://de.os2voice.org | Juni 2003 [Inhaltsverzeichnis] [Vorherige Seite] [Nächste Seite] [Artikelverzeichnis] editor@os2voice.org

## Richtlinien für Beiträge zum VOICE Newsletter

Letzte Änderung: 28. Mai 2003

### Inhalt

1. Allgemeines
2. Rechtliches
3. Themen
4. Inhalt und Struktur
5. Formatierung und HTML-Code
6. Links

### Allgemeines

Zuallererst: Sollten Sie Fragen bezüglich dieser Richtlinien haben, fragen Sie! Wir möchten lieber mit Ihnen daran arbeiten, unsere Qualität zu verbessern, als Sie durch zu ungenaue oder zu vage Formulierungen abzuschrecken.

Der VOICE Newsletter ist ein vollkommen auf freiwilliger Arbeit basierendes Projekt, sowohl was die Autoren als auch die Herausgeber, Redakteure und Übersetzer angeht. Niemand wird für seine Arbeit entlohnt, es sei denn durch Spenden der Leser.

Und so funktioniert es: Sie schreiben einen Artikel und senden ihn an editor@os2voice.org. Falls er mehrere Dateien umfaßt, packen Sie ihn bitte vorher mit Info-ZIP. Artikel in deutscher Sprache können sie sowohl in alter als auch in neuer Rechtschreibung einreichen; nationale Besonderheiten sind hierbei ebenfalls kein Problem. Stellen Sie bitte sicher, daß Ihr Artikel in einem dieser Formate vorliegt: HTML, ASCII oder ein Format, das von DeScribe, Lotus WordPro oder StarOffice dargestellt werden kann, womit außer IBM Works, Papyrus, IPF und Clearlook so ziemlich alles abgedeckt sein dürfte. Wir bevorzugen jedoch HTML.

Es gibt keine speziellen Anforderungen hinsichtlich der Länge, da dieser Newsletter nur als HTML oder INF erscheint. Der Artikel kann so lang oder so kurz sein wie nötig, seien Sie also gründlich in Ihren Beschreibungen oder Kommentaren. Denken Sie allerdings auch daran, daß Sie hier nicht Ihre Diplomarbeit abliefern und insofern nicht ganz am Anfang a la "Am Anfang war das Wort..." beginnen müssen. Ihre Leser werden sich schnell langweilen, wenn Sie die Besprechung eines Textverarbeitungsprogramms mit einer schön ausgearbeiteten Historie der Textverarbeitungssoftware beginnen.

Ihr Artikel wird anschließend von uns gelesen und von einem Rechtschreibprüfprogramm ausgewertet (was Sie allerdings schon vor Einsendung getan haben sollten). Sollten wir Änderungswünsche haben, die über Korrekturen an Orthografie oder Grammatik hinausgehen, werden wir Sie kontaktieren und die Änderungswünsche mit Ihnen besprechen. Wir nehmen keine größeren Änderungen vor, ohne mit dem Autor Rücksprache genommen zu haben. Wir werden mit Ihnen zusammen arbeiten, um den Artikel "in Form" zu bringen. Wir sind keine professionellen Herausgeber, aber wir denken, daß es uns trotzdem gelungen ist, einen ordentlichen Newsletter abzuliefern.

Wir legen Wert auf professionelle Texte, also werden Sie bitte nicht vulgär, bewegen Sie sich nicht auf illegalem Gebiet und hüten Sie sich vor Beleidigungen oder übler Nachrede. Ein umgangssprachlicher Schreibstil ("schreiben, wie man spricht") kann zwar in manchen Fällen - als Stilmittel, in einem Editorial oder einer Glosse - akzeptabel sein oder Sinn machen, aber wir möchten Sie dringend bitten, im allgemeinen einen professionelleren Weg zu wählen. Unser Ziel ist es, unsere Leserschaft und unsere Autoren für die Teilnahme zu gewinnen und zwar durch ein geschmackvolles und nützliches Medium für Informationen rund um OS/2.

VOICE behält sich deshalb das Recht vor, die Veröffentlichung jedes Artikels aus welchen Grund auch immer abzulehnen.

### Rechtliches

Leider können wir Ihnen dies nicht ersparen. Es dient zu Ihrem und unserem Schutz:

Durch das Einsenden eines Artikels an den VOICE Newsletter erteilen Sie VOICE das unwiderrufliche und zeitlich unbegrenzte Recht zu, den Artikel (definiert als Text mit den darin verwendeten Bildern und Code) zu übersetzen, mittels beliebiger Medien weltweit zu veröffentlichen, zu speichern und zu vertreiben, und Sie verzichten dabei auf jedwedes Honorar. Desweiteren erteilen Sie VOICE das Recht, bei der Übersetzung der Verständlichkeit dienende Änderungen vorzunehmen. Ansonsten verbleiben alle Urheberrechte bei Ihnen als Autor. Durch das Einsenden eines Artikels versichern Sie, daß dieser frei von Rechten Dritter ist, oder daß diese Dritten andernfalls mit den oben genannten Bedingungen einverstanden sind, und daß Sie die Verantwortung und Haftung für eventuelle Urheberrechtsverletzungen in Ihrem Artikel (durch Text, Bildmaterial oder Code) übernehmen.

### Themen

Für den Fall, daß Sie sich nicht sicher sind, ob Ihre Idee für einen Artikel ins Programm des Newsletter paßt, ist hier eine Auflistung allgemeiner Arten:

- Besprechungen von Hard- und Software mit Angabe und Beurteilung der Fakten bezüglich Installation, Funktionen, Stabilität, Support
- Vergleichstest zwischen gleichartigen Hard- und Softwareprodukten, z.B. Grafikkarten oder Office-Suites, mit Gegenüberstellung der Eigenschaften wie z.B. Verarbeitung, Installation, Funktionen, Stabilität, Support. Eine Zusammenarbeit mit anderen Autoren wird aufgrund des Umfangs empfohlen.
- Ausführliche Anleitungen zur Installation, Konfiguration und optimalen Nutzung komplexer oder schwierig zu bedienender Produkte (sog. HowTos), z.B. zu OS/2 selbst, Emacs oder TeX.
- Aufsätze und Kommentare über Dinge, die in der Computerwelt geschehen.
- Vorstellung von OS/2-relevanten Projekten und Websites, wie z.B. Odin, Netlabs oder OS2.org.
- Tips & Tricks
- Einführungen in Programmiersprachen, z.B. Ada95 oder Python, oder zu einem speziellen Bereich des Programmierens mit Berücksichtigung der OS/2-Spezifika, z.B. PM/WPS- oder Multimedia-Programmierung
- Zusammenstellungen von Informationsquellen zu einem bestimmten Thema

Nun noch ein paar konkrete Vorschläge mit Themen, die uns besonders interessant erscheinen:

#### Besprechungen

- Astronomie: Nightvision, PmAs, XEphem für XFree86/OS2
- Büro: Finanzsoftware (Buchhaltung, Kontoführung), LyX für XFree86/OS2 (eine LaTeX-Oberfläche), Papyrus 9
- Dateimanager: Besonders interessant wäre ein großer Vergleichstest mit z.B. F, FC/2, FileStar/2, EF Commander, Connect/2 etc., sowie ein Einzeltest des Freeware-Programms F.
- Datenbanken: Vergleichs-/Einzeltest Approach, DB2, DBExpert, MySQL, PostgreSQL, Thinktool
- Editoren: Vergleichs-/Einzeltest Emacs, Enhanced EE, EPM, FED, FTE, MED
- E-Mail-Klienten: Auch hier wäre ein Vergleichstest angebracht mit z.B. MR/2 ICE, PMMail, dem Polarbar Mailer, Emerald Mail, Gnus/Emacs, Pine, Snee/Vsoup, Yarn/Vsoup. Aber auch Einzeltests der unbekannteren Programme sind interessant.
- Entwicklung: Free Pascal, GNAT, OpenWatcom, Virtual Pascal
- Grafik/DTP: DrawIt!, Embellish, GIMP, GMT, Gnuplot, Maul, Photo>Graphics, PhotoTiger, PMView 2000
- FTP-Klienten: Vergleichs-/Einzeltest NcFTP, NFTP, emtec FTP, F, Handy FTP
- Newsreader für OS/2: Sowohl ein Vergleichstest als auch Einzeltests, sowohl PM als auch Textmodusprogramme sind interessant. Kandidaten: ProNews/2, Gnus/Emacs (evtl. mit Changi), Slrn/Slrnpull/Changi, Yarn/Vsoup/Souper.
- Multimedia: OS/2s große Schwachstelle. Hier ist jedes Programm von Interesse.
- Netzwerk/Internet: Links-Browser, FTP-Server (von Hethmon Brothers, Peter Moylan), Mailserver (Hethmon, IPS, Weasel, ZxMail), HTTP-Server (Apache, SRE, Xitami, Web/2)
- Spiele: Lincity für XFree86/OS2, Shisen/2, Stellar Frontier, Emulatoren wie VICE/2, MAME etc.
- Tools: ePDF, Ghostscript/GSView, Junk Spy 2, PMPDF
- X11: Besprechungen portierter X-Anwendungen

#### Anleitungen

- Nutzung von Mozillas neuem Junk-Mail-Feature
- Anbindung und Nutzung von Datenbanken mit REXX
- Installation und Nutzung portierter X11-Anwendungen
- Wie man bestimmte Hardware-Klassen unter OS/2 zur Mitarbeit bewegt (feststellen, welche Treiber erforderlich sind, welche Parameter verwendet werden müssen, etc.)
- PDFs unter OS/2 erstellen (mit Ghostscript 8 und GSView oder PMPDF, sowie VTeX/Free)
- EPM mit Macros erweitern
- News und Mail lesen mit Gnus/Emacs
- News lesen mit Srln und slrnpull oder Changi
- News und Mail lesen mit Snee und Vsoup
- News und Mail lesen mit Yarn und Vsoup oder Souper
- No-cost IDE mit gcc und Emacs
- PDFs erstellen unter OS/2 (mit Ghostscript und GSView oder PMPDF sowie VTeX/Free)
- GIMP- oder Photo>Graphics-Workshop
- PM-Programmierung mit Ada95 (GNAT)

#### Sonstiges

- Interviews mit Leuten aus der OS/2-Welt (Entwickler, Veranstaltungsorganisatoren, etc.), z.B. Kendall Bennett, Daniela Engert, Jason A. Gow, Adrian Gschwend, Kim Haverblad, Mike Kaply, Christian Langanke, Sander van Leeuwen, Ulrich Möller, Rich Walsh

### Inhalt und Struktur

Im folgenden sollten Sie eine ungefähre Idee davon bekommen, was in Ihren Artikel hineingehört:

1. Ihre "Koordinaten": Geben Sie Ihren Namen, Ihre E-Mail-Adresse und, wenn Sie mögen, Ihre Homepage an. Sie können auch ein paar Zeilen zu sich selbst oder Ihrer Firma schreiben, diese werden aber am unteren Seitenrand erscheinen.
2. Quellen: Bitte listen Sie URLs von Webseiten, auf die Sie sich beziehen, oder Bücher, denen Sie Informationen entnommen haben, auf.
3. Grafiken sind in Ordnung und können sehr hilfreich sein, um die Funktionsweise eines Produktes zu erklären, aber achten Sie bitte darauf, diese auf 256 Farben zu beschränken (dies ist eine Einschränkung der INF-Version). Je kleiner die Dateigröße, desto besser, da einige Leser und Leserinnen den Newsletter gerne offline lesen möchten. Je nach Größe der Bilder sollten Sie darüber nachdenken, im Text Vorschauen (Thumbnails) zu benutzen. Zu einer Abbildung gehört auch eine Beschreibung, z.B. "Abb.1: Einstellungsdialog für das LAN-Interface".

   Bilder können prinzipiell in nahezu allen Formaten geliefert werden, aber wir bevorzugen PNG, JPG oder GIF (nutzen Sie ggf. eine Applikation wie PMView mit Lizenz für die LZW-Kompression). Beachten Sie dabei, daß die verschiedenen Formate auch für verschiedene Zwecke geeignet sind. Beispielsweise führen JPEGs oft dazu, daß die Schrift von Dialogen schlecht lesbar wird. Denken Sie daran, uns zu sagen, wo die Bilder im Text erscheinen sollen oder kennzeichnen Sie dies selbst durch die entsprechenden Tags im HTML-Format.

#### Produktbesprechungen

Falls es sich bei Ihrem Artikel um eine Produktbesprechung handelt, sollten auf jeden Fall Esther Schindlers Artikel How to write a product review aus der November-2000-Ausgabe der Extended Attributes lesen. Allgemein sollte der Artikel die folgenden zusätzlichen Punkte beinhalten (aber lassen Sie sich nicht von diesem Gerüst einengen):

1. Einführung: Was ist die Aufgabe, die das Programm lösen soll? Warum haben Sie sich gerade für dieses bestimmte Programm oder Gerät entschieden? Nach welchen Kritereien haben Sie Ihre Entscheidung getroffen? Welche Alternativen haben Sie geprüft? Wie war Ihr erster Eindruck?
2. Setup/Installation: War das Paket komplett oder mußten Sie Zubehör kaufen (z. B. Kabel oder Treiber für Hardware)? Mußten Sie das Handbuch lesen? Gab es ein Handbuch und, falls ja, wie gut/hilfreich war es? Mußten Sie reines DOS oder - Gott behüte - Windows 9x booten, um irgendein Setup-Tool oder eine Kalibrationssoftware laufen zu lassen? Mit welcher Hard- und Software setzen Sie das Paket ein (bitte die wichtigsten Konfigurationsangaben wie CPU, RAM, Festplatte, OS-Version, etc.)? Gibt es Mindestanforderungen an Hard- und Software? Welchen Support gibt es? Mußten Sie um Hilfe bitten und, falls ja, wie war die Antwort? Im allgemeinen sollte man sich nicht mit der Installation beschäftigen, da man erwarten kann, daß sie reibungslos abläuft. Falls Sie jedoch Probleme hatten oder finden, daß etwas auf besonders intelligente Weise gelöst wurde, berichten Sie darüber.
3. Was kann es und wie funktioniert es: Was soll das Produkt laut Hersteller können und wie gut hält es dieses Versprechen ein? Tut es dies besser oder schlechter als vergleichbare Produkte? Vermissen Sie Funktionen, die zur Bewältigung der Aufgabe notwendig sind? Geben Sie ggf. Details dazu an, wie Sie die Anwendung einsetzen (nicht zu spezifisch, die Grundlagen reichen). Denken Sie dabei daran, daß Ihre Arbeitsweise nicht notwendigerweise mit der unserer Leser übereinstimmt. Viele Autoren lassen sich leider dazu hinreißen, an dieser Stelle eine Art Bedienungsanleitung zu schreiben. Wenn Sie eine Produktbesprechung schreiben, sollten Sie nicht darauf eingehen, welchen Menüpunkt man zum Aufruf einer Funktion auswählen muß. Berichten Sie dem Leser besser darüber, wie gut diese Funktion arbeitet. Abbildungen können sehr dabei helfen, dem Leser die Funktionsweise eines Produktes zu erklären.
4. Zusammenfassung/Abschließende Betrachtung: Sind Sie mit dem Produkt zufrieden? Können Sie einen Vergleich mit ähnlichen Produkten anstellen, z.B. in Bezug auf Qualität und Nutzen? Wie ist das Preis-/Leistungsverhältnis? Würden Sie dieselbe Kaufentscheidung noch einmal treffen bzw. würden Sie es weiterempfehlen? Für wen ist das Produkt geeignet? Welches sind Ihrer Ansicht nach die wesentlichen Stärken und Schwächen? Mußten Sie Kontakt zum Hersteller oder Verkäufer aufnehmen, um Support zu erhalten? Falls ja, wie hilfreich war er?
5. Quellen: Geben Sie auch URLs an, wo Informationen zu dem Gerät (oder der Software) oder zu mit diesem verwendeter Software erhältlich sind. Nennen Sie auch den Richtpreis des Herstellers und den Straßenpreis. Wenn möglich, nennen Sie Händler, bei denen das Produkt erworben werden kann.

#### Anleitungen

Wenn es sich bei Ihrem Artikel um eine Anleitung handelt, sie also erklärt, wie man ein bestimmtes Ziel mit bestimmten Anwendungen, Dienstprogrammen usw. erreichen kann, dann beachten Sie bitte folgendes:

1. Rekapitulieren Sie, worin das eigentliche Problem bestand und was die zu seiner Lösung erforderlichen Schritte und Hilfsmittel waren.
2. Versuchen Sie, die Schritte in eine zeitliche Reihenfolge zu bringen und lassen Sie Dinge weg, die nichts damit zu tun haben, weil sie die Leser ansonsten verwirren.
3. Beginnen Sie mit einer kurzen Beschreibung des Problems, vielleicht einer Begründung, warum Sie der Meinung sind, daß sich der Aufwand lohnt, und eventuell einer kurzen Zusammenfassung der Lösung.
4. Nennen Sie die erforderlichen Hilfsmittel (falls es nicht zu viele sind, kann dies auch an dem Punkt getan werden, an dem sie benötigt werden, beispielsweise am Anfang eines Kapitels). Sind zur Verwendung dieser Hilfsmittel weitere erforderlich? Falls umfangreiche Vorbereitungen zu treffen sind, um die Hilfsmittel nutzen zu können, beschreiben Sie sie, bevor Sie mit der Beschreibung des Problemlösungsprozesses beginnen.
5. Ist zur Lösung des Problems zwingend Vorwissen erforderlich, das nicht direkt mit den Lösungsschritten zu tun hat? Behandeln Sie es, bevor Sie sich mit der Problemlösung selbst beschäftigen. Streuen Sie keine Informationshäppchen wie "Übrigens funktioniert XY, indem es Z tut." ein.
6. Nennen Sie die Schritte, die zur Lösung des Problems notwendig sind.
   - Wenn es mehrere Möglichkeiten gibt, an die Sache heranzugehen, und sie eine umfangreichere Beschreibung erfordern, erstellen Sie für jede ein eigenes Kapitel. Handeln Sie sie nicht in einem Abschnitt ab, damit die Leser nicht verwirrt werden.
   - Berücksichtigen Sie immer, daß die Leser wahrscheinlich viel weniger wissen als Sie selbst. Nehmen Sie Expertenwissen nicht als gegeben an. Liefern Sie detaillierte Erläterungen, aber erklären Sie keine Grundlagen, die für das Nachvollziehen (und Verstehen) der Schritte nicht notwendig sind.
   - Führen Sie im Kapitel/Absatz eines Schritts keine Informationen auf, die mit dem Schritt nicht direkt zu tun haben. Wenn es sich um Informationen handelt, die nützlich werden könnten, behandeln Sie sie in einem eigenen Kapitel nach dem Problemlösungsprozeß.
   - Wenn das Problem und/oder seine Lösung sehr umfangreich und/oder kompliziert sind, wären Informationen zur Fehlersuche und -behebung praktisch.
7. Führen Sie Quellen an, bei denen sich interessierte Leser weitergehende Informationen beschaffen können, die die Hintergründe beleuchten, das Thema detaillierter behandeln usw.

### Formatierung und HTML-Code

Durch eine geeignete Formatierung läßt sich die Lesbarkeit eines Textes erheblich verbessern. Bitte halten Sie sich deshalb in Ihrem Artikel an die folgenden Richtlinien, auch um ein konsistentes Erscheinungsbild des Newsletter zu gewährleisten.

- Sie müssen das Design des Newsletter mit Kopf, Fuß und Informationskästen nicht nachbilden. Diese Aufgabe wird von unseren PPWizard-Skripten automatisch erledigt. Sie brauchen nur das Layout zu erstellen, das Sie innerhalb des Artikelkörpers verwenden wollen, und die Daten zu Ihrer Person, ggf. dem getesteten Programm, Links usw. zur Verfügung zu stellen. Werfen Sie einmal einen Blick auf diese Vorlagen.
- Verwenden Sie zur Formatierung keine CSS! Wenn Sie Ihren Artikel mit Mozilla Composer bearbeiten, muß die Option Use CSS styles instead of HTML elements and attributes im Abschnitt Composer der Einstellungen Mozillas deaktiviert sein!
- Benutzen Sie bitte keine spezifischen Schriftarten oder -größen! Manche Editoren scheinen dies standardmäßig zu tun. Bei Bildunterschriften kann jedoch eine kleinere Schrift verwendet werden.
- Falls Sie Tabellen benutzen wollen, halten Sie diese bitte möglichst einfach: Verwenden Sie bitte keine Grafiken innerhalb von Tabellen und benutzen Sie keine verschachtelten Tabellen, da beides nicht durch IPF unterstützt wird und die Erstellung der INF-Version erschwert. Farbige Gestaltung ist jedoch kein Problem.
- Dinge, die Sie betonen möchten, sollten im Fettdruck erscheinen.
- Schreiben Sie Namen von Objekten, wie z.B. der Schriftartpalette, und Optionen in Dialogen kursiv, genauso wie Werte, die in Dialogen eingegeben werden sollen.
- Dateinamen, Pfade und Quellcode sollten in `fester Schriftweite`, also nicht proportional, erscheinen (HTML-Tags <tt>, <code> und <pre>).
- Alles, was an der Befehlszeile eingegeben werden soll, sollte in `fester Schriftweite` erscheinen und die Farbe grün besitzen. Ggf. sollten Sie diesen Text auch in eine separate Zeile setzen.
- Markieren Sie Warnungen in roter Farbe. Vorzugsweise etwa so:

  > ACHTUNG: Sie sollten auf keinen Fall...

- Tasten und Tastenkombinationen sollten durch `feste Schriftweite` markiert und in größer-als/kleiner-als Zeichen eingerahmt werden, wie z.B. bei `<STRG-ALT-ENTF>`.
- Alle URLs sollten in der Quellensektion im Volltext angegeben werden, wie bei http://hobbes.nmsu.edu, und nicht in der Art wie Hobbes. Die letztere Art wird innerhalb des eigentlichen Artikeltextes bevorzugt.
- Stellen Sie sicher, daß Ihr Editor keine absoluten lokalen Links wie `C:\VOICE\vnewsf3.htm` verwendet.

### Links

How to write a product review von Esther Schindler
  Tips zum Schreiben einer Produktbesprechung von Esther Schindler, extended attributes, November 2000
SelfHTML
  Eine sehr gute, deutschsprachige Einführung in HTML.
HTML Tidy
  Ein Freeware-Programm zum Prüfen und Formatieren von HTML-Code. Es ist auch in der Lage, Fehler zu korrigieren.
WWW Consortium
  Das WWW Consortium bietet ausführliche Informationen zu den von ihm festgelegten HTML-Standards, eine Online-Prüfung von Webseiten und mehr.

Nochmals: Falls Sie irgendwelche Fragen zur Einsendung selbst oder dazu haben, wie man einen Artikel schreibt, fragen Sie nur.

Vielen Dank!

Die Redaktion des VOICE Newsletter.

[Artikelverzeichnis]
editor@os2voice.org
[Vorherige Seite] [Inhaltsverzeichnis] [Nächste Seite]
VOICE Homepage: http://de.os2voice.org