I'm building on Windows only, using an ancient, unsupported version of publican plus fop for Windows I changed some settings, like single-page formatting and added a crude manual cleaning-step which removes a lot of annoying whitespace around examples. Windows was (and still seems) the only way to get a decent PDF. PDFs built on Ubuntu had several major issues (reported at https://www.redhat.com/archives/publican-list/2016-August/msg00004.html) which I didn't understand well enough to be able to fix. Also the build would take some ten times longer than on Windows and I'm doing all the editing on Windows, so a build capability on Windows is really a must for me.
My old installation notes for publican on Windows are here, but I'm not sure how complete these are ~~~ Install Publican https://fedorahosted.org/releases/p/u/publican/ Tars and SRPMs: https://fedorahosted.org/releases/p/u/publican/ Publican-Installer-3.0.exe Install FOP https://xmlgraphics.apache.org/fop/download.html http://www.apache.org/dyn/closer.cgi/xmlgraphics/fop http://mirror.cc.columbia.edu/pub/software/apache/xmlgraphics/fop/binaries/fop-1.1-bin.zip add "version: 5.0" to docs/trunk/rexxref/publican.cfg either add Publican path to PATH: set path="\Program Files (x86)\Publican;"%PATH%, or use "\Program Files (x86)\Publican;publican.exe" instead of "publican" either add FOP path to PATH: set path=\FOP\fop-1.1;%PATH%, or create a BAT file (within your PATH) that redirects publican build --formats=pdf --langs=en-US --common_content=".." ~~~ On Tue, Dec 25, 2018 at 3:38 PM Rick McGuire <object.r...@gmail.com> wrote: > I'll give it a go...how are you building the docs now if not this way? > > Rick > > On Tue, Dec 25, 2018 at 9:30 AM Erich Steinböck < > erich.steinbo...@gmail.com> wrote: > >> I tried this some two or three years ago, and it was a miserable >> experience. >> I've attached below my notes from back then. >> >> If you want to give it a try, please note down each step as accurately as >> possible. If we get somewhere, I'll add the steps required to our Wiki. >> >> I tried getting help for a few things by posting to the publican-list >> publican-l...@redhat.com >> >> The publican-list archives are to be found at >> https://www.redhat.com/archives/publican-list/ >> >> ~~~ >> sudo apt install publican >> # this will install fop, but fop is deprecated by publican, it wants >> wkhtmltopdf >> # installing wkhtmltopdf doesn't seem to work, as publican requires a >> 'patched' version >> # see >> https://www.redhat.com/archives/publican-list/2014-April/msg00003.html >> >> # in case we've already tried to install wkhtmltopdf: >> # >> http://stackoverflow.com/questions/18758589/wkhtmltopdf-installation-error-on-ubuntu >> sudo apt-get remove --purge wkhtmltopdf >> >> # now let's install 'patched' wkhtmltopdf: >> sudo apt-get install openssl build-essential xorg libssl-dev >> # http://wkhtmltopdf.org/downloads.html >> wget >> http://download.gna.org/wkhtmltopdf/0.12/0.12.3/wkhtmltox-0.12.3_linux-generic-amd64.tar.xz >> tar xf wkhtmltox-0.12.3_linux-generic-amd64.tar.xz >> cd wkhtmltox/bin >> sudo chown root:root wkhtmltopdf >> sudo cp wkhtmltopdf /usr/local/bin/wkhtmltopdf >> wkhtmltopdf --version # wkhtmltopdf 0.12.3 (with patched qt) >> >> # to avoid "failed loading image" errors and unexplained "wkhtmltopdf >> died" errors >> # https://www.redhat.com/archives/publican-list/2013-August/msg00005.html >> ulimit -n 8192 >> ~~~ >> >> >> >> On Tue, Dec 25, 2018 at 1:28 PM Rick McGuire <object.r...@gmail.com> >> wrote: >> >>> I have a working Ubuntu 18.10 now running in VirtualBox. It would be >>> nice to be able to build the docs on VM as well. Is there a guide for what >>> needs to be installed for this? >>> >>> Rick >>> _______________________________________________ >>> 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 >> > _______________________________________________ > 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