On 21 Aug 2003, Jeremy Newman wrote:

> On Thu, 2003-08-21 at 19:19, Francois Gouget wrote:
> > What are the other problems with the generated HTML?
>
> For the docs the hyperlinks would need to be changed.

Currently we get relative links to shtml files, e.g.:
  <a href="introduction.shtml">Introduction</a>

What would we need? Something like this?
  <a href="introduction">Introduction</a>

It turns out this would be trivial (I'm quite surprised). The following
patch would do it: (it's bit more complex because we would only want to
do it when generating the doc for WineHQ, but still...)


Index: default.dsl
===================================================================
RCS file: /home/wine/wine/documentation/default.dsl,v
retrieving revision 1.1
diff -u -r1.1 default.dsl
--- default.dsl 13 Dec 2000 21:52:37 -0000      1.1
+++ default.dsl 22 Aug 2003 10:54:30 -0000
@@ -8,7 +8,7 @@
 <style-specification-body>

 (define %use-id-as-filename% #t)
-(define %html-ext% ".html")
+(define %html-ext% "")
 (define %html-header-tags% '())

 ;;(define %stylesheet% "../../winehq.css")



[...]
> I don't play with SGML much, but it should be possible to have the SGML
> output a modified HTML format, John Sheets did it once for me to have
> the SGML output SHTML with the correct includes. If we could get it to
> output in my .template format with the correct paths for links, then
> everyone would be happy.

Except for editing documents I'm not very familiar with SGML either.
>From my understanding, all we want to do should be feasible in DSSSL. We
already have a bit of DSSSL code in documentation/default.dsl so this
may be used as a starting point. Here are some more resources.

http://www.jclark.com/dsssl/
http://docbook.sourceforge.net/projects/dsssl/

So this is a call for volunteers. Could someone write some DSSL code so
we only output the stuff that's supposed to go inside the '<body>' tag.
I have looke a little bit into this but I did not find an obvious way to
do it.


-- 
Francois Gouget         [EMAIL PROTECTED]        http://fgouget.free.fr/
        It really galls me that most of the computer power in the world
                          is wasted on screen savers.
                     Chris Caldwell from the GIMPS project
                       http://www.mersenne.org/prime.htm



Reply via email to