FAQ update

[Francois Gouget]

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.