Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Realized after I sent this that all the path references in my post refer to URLs so the \ should be /, even on Windows. Didn't want someone to try making the change and stubbing their toe! Gil Hi Erich, I decided to reply to your post first as it helps in replying to Rick's suggestion from a

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Hi Erich, I decided to reply to your post first as it helps in replying to Rick's suggestion from a bit earlier. My belief is that none of the changes will break the ability to build with Publican but I am unable to verify that, not having a working installation of Publican at my disposal. The

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Gil, can you give one example of a required change? Do you expect that any of the required changes will break the ability to build with Publican? ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

I suggest we create a branch of the docs and make any necessary changes to that version and these updates can be merged back into the trunk once we're confident we can switch over to the new tool set. Rick On Tue, Dec 17, 2019 at 2:00 PM Gil Barmwater wrote: > Thanks to all for the kind words.

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Thanks to all for the kind words. When I began working on this, my objective was to find a replacement set of tools and a procedure for the broken and unsupported Publican package that we have been using until now to build the ooRexx documentation. I was hoping to be able to create books that

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

I would like to add my voice to the chorus of approval. Great work Gil! Jon On Mon, 16 Dec 2019 at 19:13, Rony G. Flatscher wrote: > Gil: > > that is really a *great* achievement, thank you very much for all of your > efforts! This is really great for the ooRexx project! > > Whenever you want

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Gil: that is really a *great* achievement, thank you very much for all of your efforts! This is really great for the ooRexx project! Whenever you want "nit-picking" feedback, please let us know, the overall documentation is looking very professional and attractive already! Also, whenever you a

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

René, The process I'm using is for Windows but I believe it should be adaptable to Linux as well. That is to say there is a version of the transform tool set for Linux and Fop is just Java. My plan was to get the package together and then ask P.O. to try it out (heads up P.O.!). If we get tha

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Wow!  This looks absolutely great.  Wonderful work Gil, thanks. On 2019-12-16 07:40, Gil Barmwater wrote: As a result of Jon's request, I have now done the RxMath PDF as well. Doing another document helped me formalize the process so that I can automate it and it identified another small issu

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Hi Gil, that looks great! I hope we can build the docs on Jenkins so that will be available when we need it. Probably P.O. can help us with this. Do you only build doc on Windows or also Linux? best regards, René > On 16 Dec 2019, at 11:40, Gil Barmwater wrote: > > As a result of Jon's requ

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

As a result of Jon's request, I have now done the RxMath PDF as well. Doing another document helped me formalize the process so that I can automate it and it identified another small issue which I thought had been corrected. You can download the PDF here

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

As a result of Jon's request, I have now done the RxMath PDF as well. Doing another document helped me formalize the process so that I can automate it and it identified another small issue which I thought had been corrected. You can download the PDF here

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Jon, Yes, of course you are right, I need to do a more complex document to see if there are other issues in addition to those I've identified so far. Stay tuned... On 12/11/2019 2:19 PM, Jon Wolfers wrote: Hi Gil, Looks good to me, but I'm not sure what to look for.  Any chance of a doc wi

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Hi Gil, Looks good to me, but I'm not sure what to look for. Any chance of a doc with railroad diagrams? Jon On Wed, 11 Dec 2019, 19:00 Gil Barmwater, wrote: > Thanks for the feedback Rony. Anyone else have any comments? If not, I > will start posting comments on the issues I have found short

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Thanks for the feedback Rony. Anyone else have any comments? If not, I will start posting comments on the issues I have found shortly. 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 chec

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Wow, that is *fantastic* news!! Also, looking at your readme.pdf it looks terrific IMHO! Very curious what you have come up with to be able to generate the ooRexx 5.0 documentation yourself  (and also about the questions that you will pose in order to learn about the current problems from them

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

I know it has been over a month since I posted the note below but I now have a lot of progress to report! I have obtained the tools needed to build our docs - they are open source and seem well supported - and have successfully built one document using them on Windows 10. There are no dependenc

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> > Processing file tmp/en-US/xml_tmp/Feedback.xml -> > tmp/en-US/xml/Feedback.xml > As I wrote you will need to issue the publican build command from within one of the ooRexx docs directories, like rexxpg or rexxref. None of our ooRexx docs has a Feedback.xml __

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> Am 16.11.2019 um 21:38 schrieb Erich Steinböck : > > > I have followed this howto > The publican installation that we use to build ooRexx docs is be no means > "standard", it's in fact something that has almost become completely lost. > I believe the only way to install it is to follow what w

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> I have followed this howto > The publican installation that we use to build ooRexx docs is be no means "standard", it's in fact something that has almost become completely lost. I believe the only way to install it is to follow what was discussed in thread https://sourceforge.net/p/oorexx/mailman

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> Am 16.11.2019 um 20:27 schrieb Erich Steinböck : > > Can I download the common contents from Sourceforge? > Just check out https://svn.code.sf.net/p/oorexx/code-0/docs/trunk > > This checks out all ooRexx docs and also the oorexx directory,

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> > Can I download the common contents from Sourceforge? > Just check out https://svn.code.sf.net/p/oorexx/code-0/docs/trunk This checks out all ooRexx docs and also the oorexx directory, which is the common content There are no *.spec files in the Publican directory at all. Did you follow the thr

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

This is weird, it should be there. Can I download the common contents from Sourceforge? Can you have a look on your old Win7 machine (or in a backup) it if is in the place I pointed to? Hälsningar/Regards/Grüsse, P.O. Jonsson oor...@jonases.se > Am 16.11.2019 um 16:51 schrieb Erich Steinbö

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Hi P.O., Can someone send me the file *publican-oorexx.spec* used in the brand? > I know it should go into C:/Program Files (x86)/Publican/Common_Content/ > oorexx/ > I don't have a publican-oorexx.spec on my system, and also no oorexx directory in Publican\Common_Content\ When building, I call

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

I have tried a few things as well: I got stuck with the images in Pandoc so I have put it aside for the moment. Thinking Publican used to work in Windows 7 I tried to set up a working environment in a W7 instance in Virtualbox - and failed to make Publican 3.0.0 install :-( I then went on to d

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> Just so everyone doesn't think I've abandoned this effort, I > am pursuing another approach to building the docs. You can > expect an update when I've made some more progress. Mike ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.n

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Just so everyone doesn't think I've abandoned this effort, I am pursuing another approach to building the docs. You can expect an update when I've made some more progress. On 11/4/2019 4:16 PM, Gil Barmwater wrote: ?I will go back to docbook.org and do some more reading before proceeding any f

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Thinking that doing HTML first would be easier as it would not involve a second step - LaTex to PDF with MiKTex - I tried that next. Unfortunately, I get an error message and an empty document. Reading the article pointed to by P.O. I found the statement "Included Files If you have files that

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Hi P.O., great that you are also looking into this! On 03.11.2019 23:22, P.O. Jonsson wrote: > Hi Gil, nice to hear from you. > > I am shadowing your efforts on the Mac, I assume you are on Windows. > > I could install Pandoc and BasicTex (Latex on Mac) using Homebrew and render > the initial te

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

On 03.11.2019 18:32, Gil Barmwater wrote: > > Second update: attempted to use Chocolatey to install MikTex but got errors > doing so. I used > Chocolatey to uninstall MikTex and went to the website for the program > instead and downloaded the > package - its big, 201MB. Ran the installer which to

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Second update: attempted to use Chocolatey to install MikTex but got errors doing so. I used Chocolatey to uninstall MikTex and went to the website for the program instead and downloaded the package - its big, 201MB. Ran the installer which took a few minutes and then it said it needed to insta

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Good luck!! Rony G. Flatscher (mobil/e) > Am 02.11.2019 um 19:42 schrieb Gil Barmwater : > >  > Update: I've now been able to 1)install Chocolatey, 2)use Chocolatey to > install Pandoc, and 3) test that Pandoc works with basic files (as listed on > their website - https://pandoc.org/getting-s

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Update: I've now been able to 1)install Chocolatey, 2)use Chocolatey to install Pandoc, and 3) test that Pandoc works with basic files (as listed on their website - https://pandoc.org/getting-started.html). This included creating a LaTex file which I'd never seen before. My next step is to use

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> > markup that gets used is dictated by the team's normal practices, rather > than a formal definition? Yes, our ooRexx docs use plain Docbook, nothing more specific. > > ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.s

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

On Fri, 1 Nov 2019, at 19:14, Rony G Flatscher wrote: > > https://docbook.org/ seems to have links to the dtd/xsd definitions, > also a link to tools they seem to suggest/endorse. Ah, ok. So you're suggesting that the ooREXX docs use a standard docbook DTD. That would mean that which bits of

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

https://docbook.org/ seems to have links to the dtd/xsd definitions, also a link to tools they seem to suggest/endorse. —-rony Rony G. Flatscher (mobil/e) > Am 01.11.2019 um 16:51 schrieb Jeremy Nicoll : > > On Fri, 1 Nov 2019, at 14:00, Gil Barmwater wrote: >> >> Spent some time trying to g

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

The style sheets are part of the publican install. If pandoc is able to process docbook, it probably has style sheets of its own to manage the conversion. Rick On Fri, Nov 1, 2019 at 12:07 PM Gil Barmwater wrote: > Thanks Rick. I saw the Makefiles and had a quick look at them but missed > the f

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Thanks Rick. I saw the Makefiles and had a quick look at them but missed the fact that Publican did both the PDF and HTML builds. I guess that means we need to find where Publican gets the style-sheets and see what we need to convert for Pandoc to create Tex/PDF output. Unless it too supplies

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

On Fri, 1 Nov 2019, at 14:00, Gil Barmwater wrote: > > Spent some time trying to get my head around our documentation > process and here is where I'm at. We use DocBook for all our > documentation which consist of XML which contains the book content Presumably there's also some file(s) somewh

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

If you look in the directories for the individual publications, you'll see that each has a Makefile that generates the output. All of the work is really done by publican, which also provides the style-sheets used for both the FO and HTML conversions. The Makefiles are pretty simple: all: pdf html

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Spent some time trying to get my head around our documentation process and here is where I'm at. We use DocBook for all our documentation which consist of XML which contains the book content and XSL that describes the format.?? I've found the .xml files in the SVN repository but don't know wher

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

OK, did some reading at the suggested link and discovered a recommendation to use Chocolatey to install pandoc since it can also install other packages that pandoc might need like LaTex. That is the path I plan to pursue unless someone raises a red flag. Anyone have any experience with that pie

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> > Is the issue with the first stage of the processing or the the PDF > generation? Yes, in the first stage, before fop starts. ___ Oorexx-devel mailing list Oorexx-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/oorexx-devel

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Erich, Is the issue with the first stage of the processing or the the PDF generation? We might want to try converting the build to the the Apache FOP processor, which does appear to be more active than the old version we've been using. Rick On Wed, Oct 30, 2019 at 12:35 PM Erich Steinböck wrote

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Maybe pandoc to get docs into a format that can be used by: http://www.sphinx-doc.org/en/master/index.html I had problems getting ghc up to standards on OpenIndiana and Haiku OS? Needed it for http://www.rastersoft.com/programas/autovala.html Do not know if it is that way on OS/2? I know thes

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

On Wed, Oct 30, 2019 at 1:47 PM Gil Barmwater wrote: > OK, I'm going to show my ignorance here but it seems someone should at > least explore replacing the unsupported/broken publican with pandoc.?? I've > done some cursory searching and reading about pandoc and it seems to be a > "good" tool; i.

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

OK, I'm going to show my ignorance here but it seems someone should at least explore replacing the unsupported/broken publican with pandoc.?? I've done some cursory searching and reading about pandoc and it seems to be a "good" tool; i.e. it has many conversion options and seems to have a reaso

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

> > I'm not really that comfortable with relying on an old version of tools > that don't really have any support any more > 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 W

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Dear Rony,I followed this „Howto“https://jfearn.fedorapeople.org/en-US/Publican/4.0/html/Users_Guide/chap-Publican-Users_Guide-Installing_Publican.htmlto set up Publican (V4.3.2) on Fedora recently and made some tests. The „testbook“ builds fine but when I try to do something with ooRexx documentat

Re: [Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

There was a long discussion on how to get this set up that took place on this list back in January of this year. The net of this discussion was that while it was possible to build the docs on linux, the results were not as good as the version built on Windows. Getting a working setup on Windows req

[Oorexx-devel] Questions ad generating the documentation (publican, pandoc)

Following the communication in the past it seems that currently a special publican setup on Windows is necessary. Is there any "cheat-sheet"/"todo-list" documentation available on the Internet (did not find anything on the ooRexx wiki )? Would public