Rony,
I am unable to reproduce the problem with re-running doc2html that you
reported. I just did it with the rexxextensions book, opened the
index.html in my browser, closed the browser and reran doc2html. Worked
as expected. Perhaps you had one of the HTML files "open" when you tried it?
I will look at "fine tuning" the copying of the Common_Contents and
image directories to limit what is being copied. At the moment, I just
blanket copy the entire folders.
Gil
On 3/30/2020 11:06 AM, Rony G. Flatscher wrote:
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
--
Gil Barmwater
_______________________________________________
Oorexx-devel mailing list
Oorexx-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/oorexx-devel
