https://bugs.kde.org/show_bug.cgi?id=410393
Bug ID: 410393
Summary: Bad XML to HTML conversion code in
ccbysa4-notice.docbook
Product: docs
Version: unspecified
Platform: openSUSE RPMs
OS: Linux
Status: REPORTED
Severity: major
Priority: NOR
Component: ksgmltools
Assignee: kde-doc-engl...@kde.org
Reporter: davidbry...@gvtc.com
Target Milestone: ---
Created attachment 121834
--> https://bugs.kde.org/attachment.cgi?id=121834&action=edit
.docbook file to demonstrate the error.
SUMMARY
ccbysa4-notice.docbook generates incorrect HTML code. You can find the master
copy here:
https://cgit.kde.org/kdoctools.git/tree/src/customization/en/entities/ccbysa4-notice.docbook
There are also copies in //cgit.../customization/xx/... for these other five
languages:
xx = ca (Catalan)
xx = es (Español)
xx = id (Indonesian)
xx = ru (Russian)
xx = uk (Ukrainian)
So there are six instances of the bug, all together. The rest of the
subdirectories (42 other languages) do not have an entry for
ccbysa4-notice.docbook. Not yet. I'm not certain how many languages are
actively supported right now.
STEPS TO REPRODUCE
1. Download "example.docbook", attached to this report.
2. Run meinproc5 to translate "example.docbook" into "index.html"
3. You'll see this error message:
ERROR: xref linking to cc-by-sa-4 has no generated link text.
Error: no ID for constraint linkend: "cc-by-sa-4".
OBSERVED RESULT
Bad html code linking to index#(nowhere).
EXPECTED RESULT
Good html code pointing to
https://creativecommons.org/licenses/by-sa/4.0/legalcode
SOFTWARE/OS VERSIONS
Windows:
macOS:
Linux/KDE Plasma: From openSuSE LEAP 15.0 repositories
(available in About System)
KDE Plasma Version: 5.12.8
KDE Frameworks Version: 5.45.0
Qt Version: 5.9.4
ADDITIONAL INFORMATION
I recently started writing some missing documentation (for KAddressBook). When
I submitted my first rough draft (at https://phabricator.kde.org/D22799),
somebody said I should replace one XML ENTITY (&FDLNotice;) with another one
(&CCBYSA4Notice;). So I did that. But then I got the error message from
meinproc5.
So I did some digging around on my hard disk, and I figured it out.
ccbysa4-notice.docbook is pretty short -- it says
<para>Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International or any later. A copy of the license is included in <xref
linkend="cc-by-sa-4"/>.</para>
But it really ought to say
<para>Permission is granted to copy, distribute and/or modify this document
under the terms of the Creative Commons Attribution-ShareAlike 4.0
International License or any later version of that license. A copy of the
license is included in <ulink
href="https://creativecommons.org/licenses/by-sa/4.0/legalcode";>at the Creative
Commons web site</ulink>>.
</para>
(Please note that I have patched a few words in the verbiage, substituted a
"ulink" tag for "link", and also inserted the href="crea..." attribute.)
I haven't figured out where the generated notice ought to point in any other
language besides English, but I do see this at the Creative Commons web site,
in a menu list at the top right:
Deutsch
Español
Français
Русский
Україиська
I don't see Catalan, but Español is pretty close ... you might need to talk
with some of the translators to get the whole thing done right. I'll gladly
submit a patch via Phabricatr if you just let me know which KD# repo I need to
clone. Thanks!
--
You are receiving this mail because:
You are watching all bug changes.
