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.