Note that making the tools available is only part of the process; the
documents need to have their <programlisting> tags updated as well.
Unless I missed it, that has NOT been done (except for the
Conventions.xml file which is part of the common content in the oorexx
folder). As that change does NOT affect the current document build
process, it can be done regardless of any work on highlighting our
documents. Just a heads-up.
Gil
On 8/11/2026 4:53 PM, Rony G. Flatscher wrote:
Dear Josep Maria,
On 03.08.2026 12:12, Josep Maria Blasco wrote:
The current refresh of the Rexx Parser includes a new
hldoc2HTML.rex tool in bin/docbook/. Together with hldocprep.rex,
hldoc2pdf.rex and hldoc2fo.rex, they allow to transform properly
tagged docbook .xml files into nicely highlighter PDF and HTML files.
Tagging is as simple as
substituting
<programlisting>
by
<programlisting language="rexx">
in all listings /that contain a valid ooRexx fragment/ (the parser
cannot highlight an invalid program for obvious reasons).
You can browse a highlighted PDF version of rexxref at
https://rexx.epbcn.com/rexxref/rexxref.pdf; the HTML version can be
found at https://rexx.epbcn.com/rexxref/. You can choose your
highlighting palette by using the upper-right dropdown menu labeled
"Coding style"; your choice is sticky, and will accompany you while
you're in the same web. You can also add ?style=<style-name> as a
query string, as in
https://rexx.epbcn.com/rexxref/keyReply.html?style=tokio-night; in
this case, the palette choice is not sticky, as this allows the
sharing of pages with a particular palette.
You will find the usage notes here:
https://rexx.epbcn.com/rexx-parser/bin/docbook/
That is *great*, thank you very much!
Would it be possible to incorporate your great tools
(hldocprep.rex, hldoc2pdf.rex, hldoc2fo.rex) into "docs\trunk\tools"
such that they are available for building the docs in color, if your
Rexx parser is available? In case the Rexx parser is not available
maybe fall back to "docprep.rex", "doc2pdf.rex", and "doc2fo.rex"?
Assuming that "fo2pdf.rex" works on the black-and-white- and the
color-version .fo files.
---rony
_______________________________________________
Oorexx-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
--
Gil Barmwater
_______________________________________________
Oorexx-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
