[generguide-devel] More suggestions, was - some concerns

[Artur H. <ko...@pl...>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1


I think you know about it but, here is excellent guide:
http://www.sagehill.net/docbookxsl/index.html

Especially this part can be interesting for you:
http://www.sagehill.net/docbookxsl/ModularDoc.html#XIncludeFallback
I am thinking about to use plain xinclude.xsl without your modifications.
Because we need this XSL for other inclusions (modular docs) so
it would be better to have and manage only one version.

Above url points to description how to manage inclusions which
can be not reachable at the time of processing.

Another one:
http://www.sagehill.net/docbookxsl/ModularDoc.html#UsingXinclude
shows also how to include whole context of given element without
element itself. Look at the end of this section, just before bold text:
"Including plain text".

> I suggest it should go into the Documentation section, under "Publishing
> docbook files".  You will already see a section here which would be
> outdated with your new work.
> http://generguide.sourceforge.net/developersguide/developersguide.html#publ
>ishingdocbook
Ok, I will.

> > I propose to change it to something like:
> > <!ENTITY % xinclude
> > PUBLIC "-//GenerGuide//ELEMENTS SDocBook XInclude extension V1.0//EN"
> > "http://generguide.sourceforge.net/xinclude/1.0/xinclude.mod">
> Yes, this sounds reasonable.  (I don't understand what these references
> mean, but your suggestions sound like they would work and I trust your
> judgement enough that I'm happy not to find out.)
One of the biggest benefit to work in team is that nobody needs to know
everything. Knowledge can be spreaded for all team members.
So whole team has always greater knowledge than one developer
could have.
However here is the very short description about this matter if you want
to know:
http://xmlwriter.net/xml_guide/doctype_declaration.shtml#PublicDTD

PS. Somebody told: Knowledge of language grammar can hurt. I think it is
true. The better I know English grammar the more difficult is for me to 
express my thougths. ;-)

Artur
- -- 
Artur Hefczyc             "Don't change people, just live with them."
Open Source Developer:
http://www.geotools.org/
http://generguide.sourceforge.net/
http://wttools.sourceforge.net/
http://maven-plugins.sourceforge.net/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE/UFxk0/6x1bjSKPkRAmURAKCDFeb6PriYx/GCtA8Ga+9bYIhESQCfUr82
ru/qx65o6c+GJ/i+t8fy9lY=
=w/PX
-----END PGP SIGNATURE-----