Problems validating kquickguide

Matthew East mdke at ubuntu.com
Wed Nov 2 14:14:15 UTC 2005


On Wed, 2005-11-02 at 11:45 +0000, Matthew East wrote:
> On Wed, 2005-11-02 at 16:35 +0530, Bhuvaneswaran wrote:
> > > Please see the first mail in this thread for what is wrong: it is the
> > > kquickguide that doesn't work, not the ccbysa.xml
> > 
> > Yeah, you are correct. kquickguide doesn't work. But, IMO it was due
> > to invalid ccbysa.xml. The error was:
> 
> {snip}
> 
> > When i applied that patch to ccbysa.xml, I was able to validate
> > kquickguide.xml. To be more clear, i'm talking about svn trunk. If you
> > meant different svn branch or error, please let me know, thankx.
> 
> I’ll take a good look at this later. From memory however, commenting out
> the doctype on this licence led to lots of the other documents breaking
> and failing to validate. If this is true, we need to find a solution
> that works properly for everything.

Yes, I can confirm that doing this workaround (commenting out the
doctype in ccbysa.xml) breaks validation of other docs (for example the
gnome/desktopguide) because the entities in the ccbysa.xml are therefore
no longer defined.

So what is the solution here? We need to figure out a way to ensure that
the kquickguide and kuserguide validate properly. Perhaps the answer
will be to have a full review of the doctypes and headers in all our
documents, and establish a standard. But I don't really know enough
about it to provide an answer here.

M
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20051102/6bcfe41c/attachment.pgp>


More information about the ubuntu-doc mailing list