Yelp and XML/HTML

[Matthew Thomas]

Em 6 Aug, 2005, às 6:33 AM, Matthew East escreveu:
>
> On Sat, 2005-08-06 at 08:35 +0200, Sean Wheller wrote:
>>
>> On Saturday 06 August 2005 05:14, Robert Stoffers wrote:
>>>
>>> In regards to my last email, I know a lot of effort has been put into
>>> making HTML documents, I did want to bring to everyones attention 
>>> though that a lot of problems in Yelp have been fixed. As a result, 
>>> documents such as the FAQ Guide now work in Yelp as XML files as 
>>> well as HTML. Of cause we also get the benefits of the side navbar

Actually, one of the things I want to do for Ubuntu Help is hide the 
navigation pane! It makes sense for a manual that has meaningful 
structure, but not for help pages that don't have obvious structure, 
where each topic already links to its subtopic pages at the top, and 
where you want a narrow help window alongside what you're doing. (I 
think this is something both Microsoft and Apple got wrong -- Microsoft 
in their help viewer, and Apple in their HTML framesets. It looks as 
though Microsoft is going to fix this with a single-pane help viewer in 
Vista.)

> ...
> Although of course it is useful for us to evaluate Yelp with regards to
> its support for xml, the decision to ship html was made by the whole
> team at a meeting, and IMHO we should stick to this. The reason for
> making the decision was not only that Yelp does not fully support xml,
> but among others, that we can ship the same documents in the operating
> system and on the website, not to mention both for Ubuntu and Kubuntu.
>
> We can work to ensure that the html built is good from a formatting
> perspective.
> ...

How can I alter the formatting for a DocBook document? For example, I'd 
like to give sets of instructions a pale background color so they stand 
out. I'd also like tables of contents to be bulleted lists instead of 
numbered lists. And I'd like to hide the Previous and Next links at the 
bottom of each page -- again, they make sense for a highly structured 
manual, but not for help pages.

Cheers
-- 
Matthew Thomas
http://mpt.net.nz/