implementing TopicBasedHelp

[Matthew East]

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



* Richard Johnson:
> On Sunday 03 December 2006 11:30, Matthew East wrote:
>> Erm. All our substantial documents (desktop guide, server guide and so
>> on) have done this for the last 2 or 3 releases... I'm not quite sure
>> where you're going with this.
> 
> Well, each chapter is one topic with the Edubuntu Handbook, whereas with our 
> Desktop Guide and what not, each chapter could contain a couple different 
> topics. With the Handbook, there would be a file for Installing Standalone, 
> then one for Post-Installation, and so on. There are roughly 30 xml files for 
> the Handbook. Now if we break down each topic or question there will be a 
> greater number of files. It is bringing them/linking them to a main document. 
> Whereas when we validate, it specifically tells you where the buggered part 
> is, with the Handbook it gives you a line number from the handbook.xml file 
> when the error is actually in another file. That is what I was referring to 
> really.

I'm not sure if you're making a point about improving the topic based
sandbox, if you are, can you be clearer about what you'd change?

If you're asking about why it doesn't tell you which xml file the error
is when you validate the handbook, it's because you're using entities to
include the separate files. Try using xincludes and it will work better.

Matt
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFczvRtSaF0w5rBv8RAlgLAJ95SYJQUHbsBWiwLRbYmU3/Nw0cRQCeOWbh
YD8Ye11kD62/hgrkidNM1yg=
=PIcv
-----END PGP SIGNATURE-----