Gil, there seems to be a little problem when re-running the HTML rendering for the same book (e.g. "doc2HTML.cmd" for "rexxpg"): as long as the target book directory, e.g. "HTML_folders\rexxpg", exists it seems that the process just hangs. Renaming or removing the book's target directory "HTML_folders\rexxpg" solves this.
Another observation: currently it seems that all files in the book's "images" directory (e.g. "rexxpg/en-US/images") get copied to the HTML target book instead of the svg-images only. In the case of "rexxpg" there are images "odg" (OpenOffice draw files), "svg" and "pdf" (which I intend to remove as they are not used AFAICS). --- There is a further observation: when exporting the svg rendering from odg then the svg font names gets " embedded" added to it. E.g. "Arial" becomes "Arial embedded", "Courier New" becomes "Courier New embedded". This causes rendering problems in HTML making some images look distorted. Will change the font in all of the rexxpg images in the odg files to "Liberation Mono" and "Liberation Sans" which at exporting them from odg to svg will get the names "Liberation Mono embedded" and "Liberation Sans embedded", respectively, as "Liberation" is the font that the documentation uses. Will write a little script to remove " embedded" from the svg font names in order for these svg images to display correctly in HTML (double-checked the possible improvement manually) in order to not forget that step whenever an odg-image gets changed and exported to svg in the future. ---rony On 30.03.2020 15:04, Gil Barmwater wrote: > > Good to hear, thanks! > > Gil > > On 3/30/2020 8:59 AM, Rony G. Flatscher wrote: >> >> Dear Gil, >> >> just to let you know. With your latest updates it became possible to create >> the HTML rendering of >> the rexxpg book! Tested it by scrolling through all the HTML pages by >> continuously pressing the >> right (next) button! >> >> Also the rendering looks great! Including the index and cross-referenced >> links (tested randomly)! >> >> Thank you very much for all of your efforts! >> >> Kudos! >> >> ---rony >> >> >> On 28.03.2020 18:25, Gil Barmwater wrote: >>> >>> Hi Rony, >>> >>> Thanks for trying the new version of the package and I am happy that I >>> haven't broken the PDF >>> generation :-).� Now to the problems you found with the HTML generation >>> :-(. >>> >>> I had only tried generating RXMATH so it might be expected that there are >>> issues that show up >>> with other books. I'll begin digging into it later. I seem to remember >>> seeing the message about >>> adjustColumnWidths while doing the PDF generation so I need to revisit my >>> notes to see what I >>> might have done about it. If that function error caused the process to >>> abort, then that might >>> explain the missing files. I hope to report back shortly... >>> >>> Gil >>> >>> On 3/28/2020 11:51 AM, Rony G. Flatscher wrote: >>>> >>>> Dear Gil: >>>> >>>> sorry for coming back late, currently I am not the master of my time >>>> allotted to ooRexx... >>>> >>>> Since yesterday evening, after reading your e-mail, I was eager to get my >>>> hands on your version >>>> 2.0 and test it! Thank you also for taking the time and making a delta to >>>> 1.2 available for >>>> those who have been using that version already! >>>> >>>> I was able to create the PDF versions as with the earlier version and >>>> everything was >>>> straight-forward! Everyone, and I mean really everyone has become able to >>>> produce the PDF books >>>> from the ooRexx documentation trunk, *super* and many thanks! >>>> >>>> The next step, of course was to test doc2HTML.cmd to create the HTML >>>> rendering of the books. In >>>> general the files got created, however "index.html" is not present which >>>> would load the book's >>>> title page. Also "doc2HTML.cmd" output had a warning "No >>>> adjustColumnWidths" function >>>> avalable". Unzipped the full package and repeated the process with the >>>> same result, here the >>>> output of "doc2HTML.cmd": >>>> >>>> G:\oorexx.tmp\gilDocs\orxbldoc-2.0>doc2html >>>> 16:22:55 - Transforming >>>> F:\work\svn\oorexx\docs\trunk\rexxpg\en-US\rexxpg.xml into >>>> HTML_folders\rexxpg\ >>>> This may take up to 10+ minutes for the largest documents! >>>> No adjustColumnWidths function available. >>>> 16:26:42 - 35 HTML files were created >>>> >>>> The created HTML files look great! Using the previous or next arrows work >>>> sometimes. However >>>> pressing the up-arrow (link text: "next.html#") does not work. Klicking >>>> the Home button yields >>>> an error page (index.html is not found). >>>> >>>> Doing a coarse, random klicking-around at least the following files are >>>> not present: >>>> "index.html", "tour.html" (target for the link "Chapter 2, A Quick Tour of >>>> Traditional Rexx."), >>>> "concept.html" (target for the link "Chapter 3, Into the Object World.") >>>> in "next.html". To >>>> ease spot further missing files, here the list of the files for "rexxpg": >>>> >>>> Directory of G:\oorexx.tmp\gilDocs\orxbldoc-2.0\HTML_folders\rexxpg >>>> >>>> 28.03.2020 16:26 <DIR> . >>>> 28.03.2020 16:26 <DIR> .. >>>> 28.03.2020 16:26 5�679 assignm.html >>>> 28.03.2020 16:26 2�241 builtin.html >>>> 28.03.2020 16:26 2�267 clear.html >>>> 28.03.2020 16:26 <DIR> Common_Content >>>> 28.03.2020 16:26 2�240 crossplat.html >>>> 28.03.2020 16:26 2�271 devtool.html >>>> 28.03.2020 16:26 2�166 dossier.html >>>> 28.03.2020 16:26 4�447 element.html >>>> 28.03.2020 16:26 2�395 english.html >>>> 28.03.2020 16:26 2�357 fewrule.html >>>> 28.03.2020 16:26 2�319 helpGettingHelp.html >>>> 28.03.2020 16:26 <DIR> images >>>> 28.03.2020 16:26 2�288 interp.html >>>> 28.03.2020 16:26 10�816 looks.html >>>> 28.03.2020 16:26 3�881 meet.html >>>> 28.03.2020 16:26 2�427 next.html >>>> 28.03.2020 16:26 2�778 oop.html >>>> 28.03.2020 16:26 2�173 pr01s01.html >>>> 28.03.2020 16:26 4�598 pr01s01s01.html >>>> 28.03.2020 16:26 3�147 pr01s01s02.html >>>> 28.03.2020 16:26 7�351 pr01s03s01.html >>>> 28.03.2020 16:26 2�286 pr01s03s02.html >>>> 28.03.2020 16:26 2�416 pr01s03s03.html >>>> 28.03.2020 16:26 2�648 pref-rexxpg-Preface.html >>>> 28.03.2020 16:26 5�760 readsy.html >>>> 28.03.2020 16:26 2�103 relinf.html >>>> 28.03.2020 16:26 2�423 rexxos2.html >>>> 28.03.2020 16:26 4�265 rules.html >>>> 28.03.2020 16:26 2�352 string.html >>>> 28.03.2020 16:26 5�160 strings.html >>>> 28.03.2020 16:26 4�564 teaser.html >>>> 28.03.2020 16:26 3�947 test.html >>>> 28.03.2020 16:26 7�175 torexx.html >>>> 28.03.2020 16:26 2�212 typeles.html >>>> 28.03.2020 16:26 3�832 which.html >>>> 28.03.2020 16:26 4�418 xfunct.html >>>> 28.03.2020 16:26 4�265 xwrite.html >>>> 35 File(s) 127�667 bytes >>>> 4 Dir(s) 11�585�458�176 bytes free >>>> >>>> Best regards, >>>> >>>> ---rony >>>> >>>> >>>> On 27.03.2020 20:11, Gil Barmwater wrote: >>>>> >>>>> This is to announce that version 2 of the new documentation build package >>>>> is now available >>>>> here <https://www.dropbox.com/s/s5d9mwx63xru1tk/orxbldoc.zip?dl=0>. For >>>>> those like Rony and >>>>> P.O. who have the previous version already, the changed/added files may >>>>> be downloaded here >>>>> <https://www.dropbox.com/sh/2teduvgutl8wofb/AAAJ77lC5I6zURpa8UBb7Yu-a?dl=0>. >>>>> >>>>> This version adds the ability to also build the HTML versions of our >>>>> documents. A number of >>>>> issues with those versions produced by Publican have been corrected as >>>>> well. The command to >>>>> build HTML document files is DOC2HTML [whichdoc]. If you have already run >>>>> docprep <whichdoc>, >>>>> you do not need to specify the argument. The multiple files that are >>>>> produced are placed in >>>>> HTML_folders\<whichdoc>\. >>>>> >>>>> Other changes in this version are the addition of two small ooRexx >>>>> program to verify that >>>>> output files were actually produced to avoid potentially misleading >>>>> messages and more >>>>> informative messages about the length of time the transform steps might >>>>> take. >>>>> >>>>> -- >>>>> Gil Barmwater >>
_______________________________________________ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel
