[generguide-devel] Changes...

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

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

Hi,

I am working (discovering how things work), documenting it and 
working again.
I have made some changes, I hope it will not affect you badly.
1. Added support for CATALOGS to generpublish.sh script
   (it works if you start it with option '-k')
   Internet and especially SF are very weak recently so to process
   XML files effectively I need maping DTDs and MODs to my local
   file system.
2. Documentation for using xinclude.xsl with java tools has been written.
    Description for generating HTML, PDF and other formats has to be 
    added yet.
3. I have updated xinclude.mod and put it to our web site at address:
    http://generguide.sourceforge.net/xinclude/1.0/xinclude.mod
4. Well, the last one, but not the less important. I have changed XML prolog
    in all our guides to following form:
  <!ENTITY % xinclude
    PUBLIC "-//GenerGuide//ELEMENTS XInclude for SDocBook V1.0//EN"
    "http://generguide.sourceforge.net/xinclude/1.0/xinclude.mod">

    The one, most important consequence is, when you will be processing
    documentation xinclude.mod have to be loaded by processing tool.
    Because it is located on the web site you should note significant increase
    of time necessary for processing.
    But benefit is that you don't need to worry about having this file on your
    disk in proper location when you are editing XML documentation.

    But before you start to hate me for wasting your time with waiting
    forever until processing will finish I give you tip how to avoid 
    downloading xinclude.mod (and sdocbook DTD) each time file is 
    processed.

1. Set environment variable similar to main below:
export SGML_CATALOG_FILES="/sgml/catalog:/sgml/dtds/sdocbook-1.0/sdocbook.cat"
2. Put attached catalog file in place pointed by above variable and 
sdocbook.cat in directory where you have simplified docbook dtd.
(If you have)
3. Look in catalog file and ensure that it points to correct xinclude.mod 
location on your HDD.
4. Always start generpublish.sh with '-k' parameter.

Because you usually call xmltools with '--novalid' sdocbook DTD is
not downloaded so, you don't need sdocbook.cat indeed. But in a case
if you would like to validate XML document with them this catalog may help.

For Java tools once more file is needed. The CatalogManager.properties
file works as above environment variable and it has to be somewhere in
directory given as classpath. If you want to use it, look inside and ensure
that 'catalog' property has correct value.

There is document in our guide/ directory describing this matter a little bit
- - basicxml.xml - which is not included in developersguide.

On the other side I saw (and worked according this rule) that you have
added xinclude declaration to all XML files. However it is necessary only
where it is used, so it could be removed in many files what can speed
processing up. (Not too much if you use xinclude.mod from your disk).

It seems to me that I have even sent you description how to set/use 
catalogs under xxe.

I hope I didn't forget about anything. If you find something wrong
send me message I will correct it ASAP.

uff....
and still working on this.....

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/Ulw10/6x1bjSKPkRAtXRAKDEkMjjQnFoevENMYDrNf6t5STPfQCgqvPF
KVoUURFtXSBeavu8EYR1p7I=
=Asiu
-----END PGP SIGNATURE-----