I made no convention as long i've done it alone, sometimes quite quickly
and the best i could (especially at the beginning where i even didn't
know docbook and other stuffs).
usually, i tryed to follow tool or command name but there are sometimes
sub-section not realted to some UI object.
I see no trouble in doing a convention. I don't know if there is already
one in gnome-doc project, but may be somethings like gnome icon naming
project (or tango which is the same now i guess) could be a basis.
"
Icon Naming Guidelines
Here we define some guidelines for when creating new icons that extend
the standardized list of icon names defined here, in order to provide
icons for more specific MIME types, devices, or international flags.
*
Icon names are in the en_US.US_ASCII locale. This means that the
allowable characters in the icon names, must fall withing the
US-ASCII character set. As a further restriction, all icon names
may only contain lowercase letters, numbers, underscore, dash, or
period characters. Spaces, colons, slashes, and backslashes are
not allowed. Also, icon names must be spelled as they are in the
en_US dictionary.
*
The dash “-” character is used to separate levels of specificity
in icon names, for all contexts other than MimeTypes. For
instance, we use “input-mouse” as the generic item for all mouse
devices, and we use “input-mouse-usb” for a USB mouse device.
However, if the more specific item does not exist in the current
theme, and does exist in a parent theme, the generic icon from the
current theme is preferred, in order to keep consistent style.
*
Icons for branded applications should be named the same as the
binary executable for the application."
for ex :
document-new
edit-find
object-flip-vertical
we could at the same time do it for section ID but also for pictures.
our trouble is were we wish to have several picture in a section :
should we add a number or "--extrascomment"
Any opinion ?
>
>
-------------------------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc.
Still grepping through log files to find problems? Stop.
Now Search log events and configuration files using AJAX and a browser.
Download your FREE copy of Splunk now >> http://get.splunk.com/
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs
