Hi P.O.,

On 28.04.2020 22:16, P.O. Jonsson wrote:
> Hi Rony and thanks for the script. I have adapted it to my needs and can make 
> the .fo files now.
> As it turns out xsltproc is included with macOS itself so once I got the 
> redirect for the http:
> working everything fell into place. I use homebrew instead of macPorts bit it 
> works approx the
> same. The XML files are here for my setup:
>
> export XML_CATALOG_FILES="/usr/local/etc/xml/catalog“

Are you sure you need to set that environment variable? The Linux and Mac 
versions of xsltproc are
setup by default to use the catalog files which they know the (their standard) 
location.

>
> Her my timing for an even older machine (mid-2010 Mac Pro):
>
> POs-12Core-Pro:oorexxdocs po$ bash builddoc.sh rexxpg
> Building rexxpg
> Making portrait pages on A4 paper (210mmx297mm)
>
> real0m3.320s
> user0m3.208s
> sys0m0.107s
>
> POs-12Core-Pro:oorexxdocs po$ bash builddoc.sh rexxref
> Building rexxref
> Making portrait pages on A4 paper (210mmx297mm)
>
> real0m52.967s
> user0m52.537s
> sys0m0.417s

Very nice improvements, indeed! :)

> Using homebrew I could also install fop and build the actual pdf as well. 
> Takes a few seconds only
> but it is not complete, there is still tweaking to do to make the fop 
> processing work on macOS.
>
> In two hours on the Mac I achieved more than I did in two days on Windows :-(

Well, you had *much* better information to start with.

The problem is with the documentation of the Windows version of xsltproc and 
missing documentation
about catalog files and the like. Also missing *any* documentation about the 
whole editing and
building process needed for the Rexx books! :(

Therefore I suggest, once this nut got cracked to document briefly the 
architecture of docbook (dtd
and xsl), the mechanics and the interdependencies. In addition a little howto 
for creating a new
Rexx book which would automatically explain the interdependencies and naming 
conventions.

In the end, after xsltproc runs on all platforms and fop generates comparable 
results on all
platforms, it may be worthwhile to look into creating "epub"/"epub3" renderings 
of the books (there
seem to be docbook-xsl definitions for them) allowing them to be used in 
electronic bookreaders
(which may allow to change the fonts, their sizes, have bookmarks placed etc.).

Best regards

---rony

P.S.: Also, once everything is set up and humming away, it may be interesting 
to create a pure Java
solution, i.e. replacing xsltproc by Apache Xalan/Xerces, that should be able 
to run unchanged on
all platforms.


_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel

Reply via email to