Date: Wed, 29 Aug 2012 22:10:19 +0900 (JST) From: Hiroki Sato <hrs@FreeBSD.org> To: gabor@FreeBSD.org Cc: doceng@FreeBSD.org, doc@FreeBSD.org, www@FreeBSD.org Subject: Re: [CALL FOR REVIEW] doc and www converted to XML Message-ID: <20120829.221019.266908030257017857.hrs@allbsd.org> In-Reply-To: <50392481.1070708@FreeBSD.org> References: <50390426.40604@FreeBSD.org> <20120826.025845.2271349946315727916.hrs@allbsd.org> <50392481.1070708@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
----Security_Multipart(Wed_Aug_29_22_10_19_2012_052)--
Content-Type: Text/Plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Gabor Kovesdan <gabor@FreeBSD.org> wrote
in <50392481.1070708@FreeBSD.org>:
ga> Em 25-08-2012 19:58, Hiroki Sato escreveu:
ga> > Ah, what I wanted to point out is that not only in the headers the
ga> > ids are converted to lower case in the new framework. I also
ga> > think we can ignore the impact for the headers.
ga> >
ga> > As you know, the Jade program uses the upper case because it
ga> > supports SGML general name normalization for the ids and NAMECASE
ga> > GENERAL is YES in SGML declaration for HTML. The xsltproc program
ga> > does not always do so because NAMECASE GENERAL is always NO in
ga> > XML.
ga>
ga> Ok, now I see you are referring to docs not www. I was talking about
ga> www because I only did manual conversion there. A side effect of
ga> changing the SGML declaration used by Jade to enforce XML syntax is
ga> that NAMECASE GENERAL is NO as you said. For now, I don't know what to
ga> do with that. If we start using XSLT, we can customize the DocBook XSL
ga> stlyesheets to do such a normalization. I think it shouldn't be
ga> difficult but I'll have to see how the corresponding parts are written
ga> in DocBook XSL. Do you have any suggestions how to handle this for the
ga> interim period?
If we continue to use the upper-case ids, converting all of id attr
and xref's linkend attr to upper-case in the source file, not in the
style sheet, is needed. Case normalization of ids by XSLT is wrong
because relationship between xref's linkend and id must be correct in
the XML source files.
I am still wondering if we should stick to the upper-case ids, but
considering consistency and compatibility, using upper-case is the
safest. Our possible options in my mind are:
1. Convert ids to upper-case and use them. No compatibility problem.
2. Use lower-case ids. Links from pages outside of www.FreeBSD.org
may be broken.
3. Convert the existing ids to upper-case but use lower case for
newly-added ones. It works but not consistent.
-- Hiroki
----Security_Multipart(Wed_Aug_29_22_10_19_2012_052)--
Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (FreeBSD)
iEYEABECAAYFAlA+FLsACgkQTyzT2CeTzy19rgCfe/746CtpWdWY2smICcTzPz1b
yhIAoIA5CJ5o1u/EjHlLXSiIiw7WqkKA
=kP+r
-----END PGP SIGNATURE-----
----Security_Multipart(Wed_Aug_29_22_10_19_2012_052)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120829.221019.266908030257017857.hrs>