[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-it
Subject:    Fwd: Markup Changes (fwd)
From:       Federico Cozzi <federico.cozzi () sns ! it>
Date:       2002-01-27 11:19:19
[Download RAW message or body]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Salve gente,

vi inoltro questa mail che e` passata sulla lista internazionale di 
traduzione. Interessa tutti quelli che si occupano di traduzione della 
documentazione.

- -- 
Federico Cozzi                             federico.cozzi@sns.it
                                           OpenPGP key: F1525410

- ---------- Forwarded message ----------
Date: Sun, 27 Jan 2002 09:52:45 +0100
From: Eric Bischoff <e.bischoff@noos.fr>
Reply-To: kde-i18n-doc@mail.kde.org
To: kde-i18n-doc@kde.org
Subject: Fwd: [kde-doc-english]Attn all: Markup Changes
Resent-Date: 27 Jan 2002 07:54:09 -0000
Resent-From: kde-i18n-doc@mail.kde.org
Resent-cc: recipient list not shown: ;

Hi all,

I'm forwarding this very informative message from Lauri, as it concerns doc 
translations as well.

The note about "Micro$oft" jokes seems very important to me, so please read 
it carefully. It would be better to avoid anyone being brought to court 
because of one of those innocent jokes that we all like so much.

- ----------  Message transmis  ----------

Subject: [kde-doc-english]Attn all: Markup Changes
Date: Sat, 26 Jan 2002 19:13:42 +0100
From: Lauri Watts <lauri@kde.org>
To: kde-doc-english@mail.kde.org

Phil asked about markup changes, and in case it goes unnoticed, I'm posting
this reply separately.  I apologise for the length ahead of time :)

Mostly these changes were sorted out on the kde-docbook list.  I've finally
got cvs working for the i18n server again (just a minute ago) and I'll be
updating the markup.docbook there over the weekend.

Here's a rundown of the changes, in any case:

1:  We are no longer going to mark up the <accel>'s.  It was a nice
experiment, and it certainly works well, but it's very difficult to maintain,
both for the authors and for the translators.  When it came to Cost vs
Benefit, accel lost.  If we ever come up with a way to automatically generate
the menu markup from the application sources, it'll be back, I guess.

2:  The package an application belongs to is now defined in the prolog of the
document, because the following entities make use of it:

3:  The new entities are:

&help.menu.documentation; - the entire standard help menu, in a
<variablelist> (so, anywhere you could put a <variablelist> you can drop in
this entity.

&install.intro.documentation; replaces the boilerplate text at the beginning
of the installation appendix, which mentions the KDE websites, FTP sites, and
.

&install.compile.documentation; replaces the standard compilation
instructions.

5:  And finally, we're working on changing the way the (tm) and (r) is marked
in the HTML output, and eventually we hope you as authors won't have to worry
about it.  For now however, it is VERY important that you markup trademark
names.

We cannot afford to be complacent about trademark acknowledgements, several
times in the last year now KDE and/or KDE developers and Linux Distributions
that distribute KDE have all been approached by lawyers.  For those of you
who don't keep up with the news, this has gone far beyond simple demands for
payment, in one case resulting in actual court action.   The trademark
acknowledgements are as much to protect you, as authors and copyright
holders, as they are to protect KDE.

I'd hate for any of us to be on the receiving end of one of those cease and
desist letters, so please take note:
It's Microsoft, it's not Micro$oft, none of the cute Windows puns are ok, and
even the words Linux and Sendmail are trademarked.  There are entities for
nearly everything that we know is a trademark, and we've taken care to make
them as close to what you'd normally write as possible.  For example,
&PostScript; and &Linux; and &RedHat;  - In general these are neither cryptic
nor hard to remember, and the text they output in the HTML is exactly the
same as the entity.

I'm aware (probably more than anyone!) that remembering these is tedious, but
it's for your own protection in this case, it's not about me being a
nitpicker, for once.  The minute we have another solution in place that
provides legal protection for everyone, this list will be the first to know.

You can always find an up to date list in
kdelibs/kdoctools/customization/entities/general.entities but as a rule of
thumb, if the word you're mentioning is a product name, and belongs to a
company, it's probably a trademark.  If you're really not sure, ask here, the
list can handle the traffic.

- --
Lauri Watts
KDE Documentation Coordinator
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Per informazioni si veda http://www.gnupg.org

iD8DBQE8U+I7cFFOofFSVBARAu96AJ9uqRxMpNnS5efFK1xrOsVfu+fMRwCdGin4
USgmGGCmFfzwlMx29Sk+CG4=
=oQm8
-----END PGP SIGNATURE-----


_______________________________________________
Traduzioni di KDE in italiano: http://i18n.kde.org/teams/it
http://mail.kde.org/mailman/listinfo/kde-i18n-it
[prev in list] [next in list] [prev in thread] [next in thread]