On 2/9/2011 11:15 AM, David Nelson wrote:
Hi John, :-)
I had a look at your revised template. My 2 cents about things would be this:
1) One of the first things I'd like personally to see done would be to
rename the OOo styles as LibO styles. I can't think of any reason for
*not* doing this. Can anyone else think of any issues that would
arise?
I'd like to see the prefix end with something other than a capital letter -- the style name will be
considerably easier to read that way. Lib, Lo, LibO-, or something else. But any name changes have
to take the style hierarchy into account, and will force all the documents through a number of hoops
to apply the right styles. I'm not sure what steps are required there, or how automatic they can be.
2) As regards the menu item separator, I'd opt for simplicity and just
use ">". Using a field feels like an unnecessary complication to me,
and I'm not so fond of the arrow in LiberationMono. I'd add a sentence
to make this a convention.
This is my preference, too; it's a very widely used technique.
3) There no clear conventions in the template about how to express
keystrokes and keystroke sequences. My suggestion would be that we
should add explanations about this. Again, I'd keep things simple and
use "<>" to enclose all keystrokes, and I would't bother with special
characters from WingDings, etc (for the Mac<Cmd> key, for instance).
So we'd have:
<Enter>,<Cmd>,<Ctrl>,<F1>,<Shift>,<CapsLock>,<Ctrl> +<S> etc.
However, it's true that the LibreOffice software itself doesn't do
this. So what are people's thoughts on that?
David Nelson
The original template called for the OOoKeystroke style (Liberation Sans italic) for these, and the
docs seem mostly to do that, with no angle brackets, and generally the label that appears on a
standard keyboard (or an easily identifiable abbreviation like Bksp) -- but I'd agree that for
things like the Mac command key and the Windows key I'd rather see the name, and brackets might help
distinguish them. Having them all in angle brackets would be OK, but I'd prefer <Ctrl-S> to <Ctrl> +
<S>, for example, or better yet use square brackets, which are easier to type: [Ctrl-S]. I like
Jean-Francois' Liberation Sans bold white-on-black style for them, but why not modify the existing
style? In any case, adding an explanation to the template and to a Conventions component in the
front matter would be good.
I'd also like to see individual, readily identifiable style names for each type of referenced item.
(I'll use Lib here as the prefix, but we should agree on one.) So : LibStyleName, LibFieldName,
LibTabName, LibRefBookName, LibRefChapterName, LibRefHeading, LibDialogSection, LibButtonName,
LibIconName, .... Then there's no confusion about what is preferred. Right now, they're mostly
either OOoEmphasis or OOoStrongEmphasis, or done by direct application (ugh!). The template shows
the things that the user clicks on as OOoMenuPath (bold), and the others as OOoEmphasis (italic),
but this has been very inconsistently applied. Having the unambiguous names in the custom styles
list would make it easy to apply the right style, and to make consistent changes for individual
items as desired.
--
Unsubscribe instructions: E-mail to [email protected]
List archive: http://listarchives.libreoffice.org/www/documentation/
*** All posts to this list are publicly archived for eternity ***
