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

2013-03-01 Diskussionsfäden Harald Köster

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+h...@de.libreoffice.org
Probleme? 

Re: [de-discuss] Base-Handbuch Version 4.0

2013-03-01 Diskussionsfäden Christian Kühl

Hallo, Robert!

Am 01.03.2013 20:41, schrieb Robert Großkopf:


Soll ich jetzt einfach alle Einzeldateien ins Wiki hochladen und
dann die Seite entsprechend umgestalten?


So haben wir es bisher gehandhabt.


Wie kommt das Ganze schließlich auf die Seite de.libreoffice.org?
Brauche ich dafür überhaupt die Zwischenlagerung im Wiki?


Ja, denn von de.libreoffice.org werden Links zu den Dateien im Wiki
gesetzt. Wenn du keinen Zugang zu de.libreoffice.org hast, melde dich
hier und irgendjemand mit Rechten wird das erledigen.

Gruß,
Christian.

--
Informationen zum Abmelden: E-Mail an discuss+h...@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



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

2013-03-01 Diskussionsfäden Christian Kühl

Hallo, Harald,

so viele Gedanken müssen erst einmal verarbeitet werden...

Am 01.03.2013 21:07, schrieb Harald Köster:


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.


Bisher haben wir kaum einheitliche Festlegungen gehabt, was wie
formatiert werden soll (außer Menüeinträge, die auch vorher schon eine
eigene Vorlage besaßen), sodass jede Dokumentation ihrer eigenen
Philosophie folgt und bei denjenigen, wo viele dran gearbeitet haben, es
schon mal durcheinander gehen konnte. Das war die Idee hinter der neuen
Vorlage, sodass nicht nur die Menüeinträge, sondern auch andere fest
stehende Begriffe eine feste Vorlage besitzen.


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.


Gute Idee, die wir aufgreifen sollten. Allerdings macht das erst Sinn,
wenn wir die fertigen Vorlagen besitzen und dann Einigung darüber
erzielt haben, was mit welcher Vorlage formatiert werden soll.


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.


Diese Vorlage ist ursprünglich wohl vor allem für Computercode gedacht
gewesen, für alles andere wurde sie nachträglich missbraucht. Deshalb
besitzt sie eine Schriftart mit fester Zeichenbreite (was bei anderen
Anwendungen misslich aussehen kann).

Wenn die Benutzung für Dateipfade misslich aussieht, dann darf nicht die
Vorlage geändert werden, sondern muss nach einer anderen Lösung (z.B.
einer anderen oder neuen Vorlage) gesucht werden.

Ich habe jetzt eine neue Zeichenvorlage LibODateipfad angelegt, die die
gestauchte Schriftart Liberation Sans Narrow verwendet. Außerdem habe
ich die Beschreibung von LibOComputerCode entsprechend angepasst.


(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?


Deine Annahme ist so gemeint. Ich habe diese Vorlage jetzt in
LibOBegriffe umbenannt.


(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.


Ich habe diese Vorlage in LibOMenü umbenannt und das Pfade
weggelassen, um Verwechslungen zu vermeiden.

Zusätzliche Vorlagen mit der selben Formatierung sollten wir vermeiden,
Ziel ist es ja gerade, die Vielzahl an Vorlagen zu verringern.


(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”.


Das habe ich zwar in der Beschreibung der Vorlagen so verwendet, aber
allgemein würde ich das nicht formulieren. Aber in oben von dir
vorgeschlagener Tabelle sollte das mit aufgenommen werden.


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 …


Werden mit der Absatzvorlage LibOBeschriftung formatiert und bekommen
keine besondere Zeichenvorlage!!!


(2) Weblinks: Es sollte zumindest erwähnt werden, das LO automatisch
die richtige Formatierung erstellt. Nehme ich jedenfalls an, dass es
so ist...


Nicht ganz: Die Vorlage Internetlink ist dafür von mir angepasst worden.
Leider habe ich keine Möglichkeit gefunden, automatisch formatierten
Internetlinks (wie