Making HTML XHTML compliant

[Nicola Fontana-3]

Hi all,

I need to do some post-processing on the generated HTML docs and
I'd like to use an XSL stylesheet. To be able do generate XHTML
compliant code, I modified gtk-doc.xsl as shown by the
attachement. I used it on a couple of projects and seems to work
properly.

Is there some reason / drawback / pitfall I must be aware of? Or
gtk-doc is still using HTML4 only for historical reasons?

If the latter case applies, maybe an update should be considered.

Ciao
--
Nicola
[xhtml.diff]

---

--- gtk-doc.xsl.old 2009-04-01 14:22:53.000000000 +0200
+++ gtk-doc.xsl 2009-04-01 14:23:03.000000000 +0200
@@ -3,7 +3,7 @@
                 version="1.0">
 
   <!-- import the chunked XSL stylesheet -->
-  <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"/>
+  <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/>
   <xsl:include href="devhelp.xsl"/>
   <xsl:include href="devhelp2.xsl"/>
   <xsl:include href="version-greater-or-equal.xsl"/>
@@ -19,7 +19,6 @@
 
   <xsl:param name="chunker.output.encoding" select="'UTF-8'"/>
   <xsl:param name="chunker.output.indent" select="'yes'"/>
-  <xsl:param name="chunker.output.doctype-public" select="'-//W3C//DTD HTML 4.01 Transitional//EN'"/>
   <xsl:param name="chunk.fast" select="1"/>
 
   <xsl:param name="default.encoding" select="'UTF-8'"/>

---

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[Stefan Kost]

hi,

actually in trunk I started to work on adding configure option to select output
formats. I need to refactor the stylesheets a bit. I could then offer xhtml as a
format. I am a bit unsure about switching to xhtml by default. No idea what kind
of thin gs people do with their docs and if that would cause trouble for them.

Stefan

eNTiDi di Fontana Nicola schrieb:

> Hi all,
>
> I need to do some post-processing on the generated HTML docs and
> I'd like to use an XSL stylesheet. To be able do generate XHTML
> compliant code, I modified gtk-doc.xsl as shown by the
> attachement. I used it on a couple of projects and seems to work
> properly.
>
> Is there some reason / drawback / pitfall I must be aware of? Or
> gtk-doc is still using HTML4 only for historical reasons?
>
> If the latter case applies, maybe an update should be considered.
>
> Ciao
>
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> gtk-doc-list mailing list
> gtk-doc-list@...
> http://mail.gnome.org/mailman/listinfo/gtk-doc-list

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list

[David Nečas (Yeti)-2]

On Fri, Apr 03, 2009 at 10:41:56PM +0300, Stefan Kost wrote:
> actually in trunk I started to work on adding configure option to select output
> formats. I need to refactor the stylesheets a bit. I could then offer xhtml as a
> format. I am a bit unsure about switching to xhtml by default. No idea what kind
> of thin gs people do with their docs and if that would cause trouble for them.

As someone who processes gtk-doc output, uses custom CSSs and have tried
all kinds of approaches from sed&perl kluges to keeping a separate XSLT
in somehow sync with the gtk-doc's, I can conclude that whatever you do
it breaks with each bloody new gtk-doc version anyway.  So, no need to
worry.  This is the Linux kernel internal interface approach.

The other approach would be to really declare a stable output format and
then keep it, but I don't think this is realistic.

Anything between means you both worry about breaking it and break it...

Yeti

_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@...
http://mail.gnome.org/mailman/listinfo/gtk-doc-list