Re: [htdig-dev] Re: splitting attrs.html

[Ted Stresen-R. <ted...@ma...>]

Well, I think there are two issues to consider:

1) Rewriting some Perl code that takes the defaults.xml document and 
converts it into multiple attribute.html-type documents ("splitting")
2) Deciding on a format or "look and feel" for the documentation

My plan was to spend this past weekend trying to learn enough Perl 
based on my PHP knowledge to be able to tackle number 1, but I'm afraid 
it's looking like too steep of a hill to climb in one weekend 
(especially considering it's Friday and I'm no further along than I was 
Saturday morning :-( ).

At the same time, I'm exploring the capabilities of XSLT, for this and 
other projects, as a solution to creating individual HTML files (one 
for each attribute). The goal is to produce _something_ that splits 
defaults.xml into it's component pieces, even if it only ends up in the 
Contributions section.

Alas, XSLT is really cool and certainly up to the task, but it too will 
require a few more weeks of study before I'm able to contribute 
anything worthwhile.

Converting the documentation to XHTML and changing the look and feel 
(and improving the usability)...

I could put together a style sheet (something I already know how to do 
and do with quite a bit of regularity) if you want, at least I'll be 
able to contribute _something_ while I work on the other piece...

Let me know...

Ted Stresen-Reuter

On Friday, January 31, 2003, at 03:21  AM, Gabriele Bartolini wrote:

> Ciao Ted, Budd and Gilles,
>
>> HyperCard and AppleScript and Lingo), I'll see if I can write the 
>> code for generating the documentation in Perl, but I would like to 
>> see Brian's scripts...
>
> I was trying to give a look at the situation of the XHTML porting of 
> the documentation. Any news? I can volounteer. I was thinking about 
> using an utility such as 'tidy' to help me moving forward, and also 
> try to check it up from the accessibility point of view. First (sorry 
> it is my fault), I'd remove the 'bold' effect when going over a link 
> (when I put it, it was almost one of my first experiences with CSS!) 
> which is really unaccessible!.
>
> I'll try and put the 'lang' attribute in every page and the content 
> type as well, and leave an empty 'body' in every page (I know some old 
> versions may show the default color - usually white - but it doesn't 
> prevent it from being viewed). Other changes will be made > consequently.
>
> Sounds good?
>
> Let me know. The only case which could have some problems is the 
> automatically generated configuration file (please update me for 
> this!).
>
> Ciao ciao
> -Gabriele
>
> --
> Gabriele Bartolini - Web Programmer - ht://Dig & IWA Member - 
> ht://Check maintainer
> Current Location: Prato, Tuscany, Italia
> an...@ti... | http://www.prato.linux.it/~gbartolini | ICQ#129221447
>
>