I have just uploaded a fresh version of the tools for Ubuntu Linux to Sourceforge. With the help of Rony they are now also running at „Warp Speed“, just as the build on Win or Mac.
Compared to Windows the installation process is a bit tedious, if the Win version is a Mercedes the Mac and Linux versions are VW Beetles… But using the tools should be as easy as a breeze. Please read Gil´s readme first. Examples of the results can be seen here <https://www.dropbox.com/sh/uv5j1w6h5tioi2y/AACTceDdBkAGDCeguXk0fP6aa?dl=0> Hälsningar/Regards/Grüsse, P.O. Jonsson oor...@jonases.se > Am 10.06.2020 um 15:19 schrieb Gil Barmwater <gbarmwa...@alum.rpi.edu>: > > Back at the end of October last year, a discussion started about finding a > replacement for our process to build our documentation. The reason being "The > issue has become even more serious since switching over to Windows 10. All > ooRexx docs still build (with slightly less appealing fonts) except for > rexxref. Tested on two Win 10 machines, any rexxref build fails with a > c0000005 exception about 99% of the time, but eventually successfully builds > in 1 out of a 100 tries.� A real pain." This quote from Erich summarized > the issues he was experiencing using the Publican tools that have been our > only method of getting our documentation built. > > I volunteered to "slog" through the process starting with investigating using > the Pandoc tool as a potential replacement for Publican. When that effort > didn't "pan" out, I started looking for other tools and in early December I > reported the first build of one of our documents using some other tools. > There were issues still to be resolved (and many still to be discovered!) but > the approach seemed worth pursuing. As a result I stated "My goal is to > develop a package containing the tools that anyone can download and install > that will allow them to build our docs on Windows 10 from a fresh checkout > from SourceForge with minimal changes to those files." > > I am happy to report that this goal has now been achieved! In addition, with > the help of P.O. Jonsson and Rony Flatcher, we now also have packages that > run on Mac and Ubuntu Linux. These produce documents that are > indistinguishable from those produced on Windows. All three packages are > available on SourceForge in the tools folder of the docs section - > .../docs/trunk/tools/. > > In addition to having no reliance on Publican, the packages use the most > recent versions of the Docbook DTDs and style sheets and Apache FOP. However, > the source files remain usable by Publican so we have not "burned any > bridges" in developing these packages. > > For anyone interested in trying one of these packages, I strongly suggest you > download and read the file "read1st.txt" in the Windows package as a first > step. It fully documents what is involved in generating our documents using > the package. > > As the packages are now in SVN, please report bugs and request enhancements > through the ooRexx ticket process. > > -- > Gil Barmwater > > > > _______________________________________________ > Oorexx-devel mailing list > Oorexx-devel@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/oorexx-devel
_______________________________________________ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
