Re: [de-discuss] Dokumentvorlage für LibO 4 Dokumentation

Hallo Christian,

Am 28.02.2013 19:26, schrieb Christian Kühl:

> Zeichenvorlagen:
> - Vorlage LibOMenüpfad wird jetzt in LibO-grün dargestellt.
> - Neue Vorlage LibODialogRegisterAbschnitt (für Hervorhebungen von
>    Bezeichnungen, die kein Menüpfad sind) in LibO-gelb.
ich habe mir zu Zeichenvorlagen noch mal ein paar Gedanken gemacht, da 
ich bei der Auswahl der richtigen Zeichenvorlage immer etwas Mühe hatte. 
An einigen Stellen habe ich dann tatsächlich auch die falschen Vorlagen 
verwendet.
Ich hatte bestimmte Arten von Textstellen und hab dann die 
Beschreibungen der Zeichenvorlagen durchgelesen, um zu sehen welche 
Vorlage die Richtige ist oder was am Besten passt. Besser wäre es, 
zumindest aus meiner Sicht, wenn zuerst die Textstellenarten (irgendwie 
blöder Begriff, aber mir fällt im Augenblick kein besserer ein) 
aufgelistet werden und jeder Art eine Zeichenvorlage zugeordnet wird. 
Dies könnte man z.B. mit einer Tabelle machen: 3 Spalten in der 
Reihenfolge Textstellenart, Zeichenvorlage und Beispiele.

Anmerkungen und Vorschläge zu einzelnen Zeichenvorlagen:

(1) “LibOComputerCode”: Ergänzungen: Datei- und Ordnernamen “inkl. 
Pfade”, auch für Teile von Dateinamen wie z.B. “.odt”. Die Zeichenbreite 
dieser Vorlage finde ich relativ groß. Dies führt dazu, das es z.B. bei 
längeren Pfadnamen schnell zu Zeilenumbrüchen kommt. Ich würde mir eine 
Font mit etwas kleinerer Zeichenbreite wünschen.
(2) “LibODialogRegisterAbschnitt”: Im Text steht das diese Vorlage für 
“LibreOffice-eigene-Begriffe” verwendet werden soll. Wäre dann nicht 
gleich die Bezeichnung „LibODialogEigeneBegriffe“ oder 
„LibODialogBegriffe“ besser? Ich nehme an, dass mit „Abschnitt“ die 
Abschnitte in den Dialogen gemeint und mit Registern die Tabs/Reiter in 
den Dialogen gemeint sind, oder? Darf diese Vorlage auch für Begriffe 
außerhalb von Dialogen eingesetzt werden?
(3) “LibOMenüpfad”: Mit dem Begriff “Pfad” assoziiere ich immer zuerst 
Dateipfade. Hier kann eine Verwechselungsgefahr bestehen. Laut 
Beschreibung sollen auch alle Mausklicktexte mit dieser Vorlage 
formatiert werden. Mit dem Namen der Vorlage wird dieses nicht 
assoziiert. Daher mein Vorschlag: Eigene Vorlage für alle Mausklicktexte 
(Schaltflächen, Symbolnamen, weitere?) z.B. “LibOMausklick” oder 
“LibOMausklicktext”, auch wenn die Formatierung von Mausklicktexten und 
Menütexten identisch ist.
(4) “LibOStarkeBetonung”: Ergänzen: Neben allgemeinen starken 
Hervorhebungen auch für “Begriffe am Anfang von Absätzen, wenn diese den 
Charakter einer Überschrift für den Absatz haben”.

Folgende Textstellenarten sind bisher nicht aufgeführt und somit auch 
keinen Vorlagen zugeordnet worden:
(1) Referenzen innerhalb des Dokuments (Kapitel, Abbildungen, …). Ich 
hab den Referenztext immer kursiv formatiert und in Anführungszeichen 
gesetzt. Beispiel: ... finden Sie im Kapitel „Installation der Hilfe“ 
auf Seite 25 …
(2) Weblinks: Es sollte zumindest erwähnt werden, das LO automatisch die 
richtige Formatierung erstellt. Nehme ich jedenfalls an, dass es so ist...
(3) Englische Begriffe (z.B. extension, user, …). Mein Vorschlag: kursiv 
formatieren, entweder eigene Vorlage oder "LibOBetonung" verwenden, 
Begriffe wie im Englischen klein schreiben.
(4) Eigennamen, insbesondere auch englische, wenn sie aus mehreren 
Worten bestehen. Beispiele: LibreOffice, The Document Foundation, 
Windows Installer, Linux, Java Runtime Environment, Pentium, OpenSuse, 
etc.). Mein Vorschlag: auch kursiv, entweder eigene Vorlage für 
Eigennamen oder LibOBetonung verwenden.
(5) Bezeichnungen in Dialogen, soweit sie durch die bisher definierten 
Zeichenvorlagen nicht festgelegt sind. Z. B. Markierfeldern, 
Auswahlmöglichkeiten in Auswahllisten oder Listenfeldern. Mein 
Vorlagenvorschlag: „LibODialogBegriffe“ (siehe auch oben)

Müssen/dürfen/sollen bestimmte Hervorhebungen mit Anführungszeichen 
gekennzeichnet werden? Ich habe z. B. Folgendes benutzt:
(1) ... finden Sie im Kapitel „Installation der Hilfe“ auf Seite 25 ...
(2) ... Durch ein Klick auf das „+“ werden …
(3) ... die Funktion „Programme installieren“ der Benutzeroberfläche ...

Müssen/dürfen/sollen auch andere Anführungszeichen benutzt werden? Z.B. 
<Benutzername> oder 'Benutzername'. Die Zeichen "<" ">" werden manchmal 
als Platzhalter verwendet.
Bezüglich der Benutzung von Farben für Hervorhebungen neige ich eher 
dazu, keine Farben zu benutzen, da Farben bei Schwarz-Weiß-Druckern eher 
zum Gegenteil einer Hervorhebung, sprich grau, werden.
Kleine Fehler, die mir aufgefallen sind: In der Kapitelvorlage wird in 
Tabellen und in Fußzeilen an einigen Stellen noch die Zeichenvorlage 
“Standard” benutzt. Im Text steht “LiboList TextKörper x” und nicht 
“LiboListe TextKörper x”.
... nur so ein paar Gedanken und Ideen ...

Grüße
Harald

--
LibreOffice - Die Freiheit nehm' ich mir! - www.libreoffice.de

--
Informationen zum Abmelden: E-Mail an discuss+help@de.libreoffice.org
Probleme? http://de.libreoffice.org/hilfe-kontakt/mailing-listen/abmeldung-liste/
Tipps zu Listenmails: http://wiki.documentfoundation.org/Netiquette/de
Listenarchiv: http://listarchives.libreoffice.org/de/discuss/
Alle E-Mails an diese Liste werden unlöschbar öffentlich archiviert