Looked into it and tested a possible solution, here the steps:
* download the DocBook 4.5 DTDs from
<http://www.oasis-open.org/docbook/xml/4.5/>, unzip them,
e.g. to "F:\work\svn\oorexx\docs\trunk\tools\tmp\docbook4.5\docbook.dtd"
* define a new environment variable for xsltproc to point to the directory
that contains the
unzipped document type definitions, but watch out for the format on
Windows: start out with
three slashes and turn all backward slashes in the path to forward slashes,
also note the
trailing slash:
set
SGML_CATALOG_FILES=///F:/work/svn/oorexx/docs/trunk/tools/tmp/docbook4.5/docbook.dtd/"
Create the docs.
E.g. "rexxref.pdf" now needs appr. 20 seconds to be created compared to more
than 10 minutes without
the local DTDs!
---rony
On 23.04.2020 19:53, Gil Barmwater wrote:
>
> I suspect the slow performance might be due to the (repeated) fetching of the
> DTDs/stylesheets by
> the xsltproc/transform step. My internet connection is intermittently bad and
> I would sometimes
> get "failures" due to the inability of the program to get one of the files it
> needed. I'd suggest
> someone look into making the files "local" so that they need not be
> downloaded multiple times per
> "book". These files are "ancient" so there is no need to worry about not
> getting the latest version.
>
> Gil
>
> On 4/23/2020 1:07 PM, René Jansen wrote:
>> good work!
>>
>> Amazingly slow performance though - needs more memory?
>>
>> René
>>
>>> On 23 Apr 2020, at 19:04, P.O. Jonsson <oor...@jonases.se
>>> <mailto:oor...@jonases.se>> wrote:
>>>
>>> This is just to say that we now also have a bild of the HTML documentation
>>> on Jenkins. It takes
>>> 1h30 to build the PDF and 1h50 to build the HTML and I have set it to
>>> build@midnight, PDF first
>>> and HTML thereafter. This can be changed if needed. All documents seems to
>>> build just fine.
>>>
>>> There is currently no upload of documentation to Sourceforge -> Erich?
>>>
>>> To get hold of the documentation log in to Jenkins
>>> <http://build.oorexx.org/> and
>>> select ooRexx-docs-build (PDF) or ooRexx-docs-build2 (HTML) and then use
>>> the link Last
>>> Successful Artifacts
>>>
>>> Due to the way Jenkins create new workspaces ooRexx-docs-build
>>> ooRexx-docs-build2 are identical
>>> parallel folders with the same latest build tools from Gil, with some minor
>>> changes to fit it
>>> into Jenkins environment.
>>>
>>> Hälsningar/Regards/Grüsse,
>>> P.O. Jonsson
>>> oor...@jonases.se <mailto:oor...@jonases.se>
>>>
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
