Re: markup help needed

[John Fleck <jfleck inkstain net>]

On Thu, 2002-09-12 at 03:35, Pat Costello wrote:
> John, 
> 
> I've done the xml markup for the GNOME Package Glossary. Attached are the html 
> files. Some points: 
> 
> - Where should I put back the xml source in cvs? 

For now, I'd just attach it to the bug report in bugzilla. Then Telsa
et. al. can figure out where to put it. I'm not sure what was finally
decided on where these things should go.

> 
> - I created the glossary as a formal GDP document, with title page, legal 
> notice, author accreditation, the lot. I did this on the assumption that we do 
> want to make the material available in future for anyone who wants to use the 
> glossary in other documentation. Yes? 
> 

I think that's correct, yes.

> - I stuck to the markup brief and resisted the temptation to do some editing and 
> revising work on the list. For example, there are some inconsistencies in 
> terminology, some of the definitions could do with a little more clarity, the 
> list would probably be better if it were alphabetized, and so on. But, I bravely 
> resisted the siren call to fiddle around with the list and performed my duty as 
> an xml soldier. Of course, if a linguistic tidy-up is required, I'd be happy to 
> step up to the plate. 
> 

Prolly would be useful to have some editing done, but let's leave that
to the author's discretion - Peter wants us to?

> - I used a variablelist structure for the list of terms. If this is not 
> adequate, then I can change to another structure. 
> 

Sounds fine.

> - Although xmllint validated the file without any errors, I got an intriguing 
> message back when I used the xml->html converter: 
> 
> "No template named "term" exists in the context named "title" in the "en" 
> localization."
> 
> This error message did not stop the files converting into sound html files, see 
> attached. 

Hmm. That sounds like a stylesheet bug. I remember encountering
something similar before, but don't remember the cause.






-- 
John Fleck
jfleck inkstain net (h) jfleck abqjournal com (w)
http://www.inkstain.net http://www.abqjournal.com

"Sometimes, a diner is all about the mac and cheese." 
  - Zippy the Pinhead