provide PDF/eBook version (continuous integration)

[VladimirAlexiev]

Is it possible to provide a single assembled version of RAM 4.0 as eBook (ideally) or PDF? This will make it so much easier to read and understand the whole RAM.

• Would be even nicer if this can be created through some continuous integration process, maybe on a monthly basis
• Loosely related to #180, which was to prepare a piece-wise markdown version for review on github
• issues should still be raised against specific markdown files/sections, i.e. eBook/PDF numbering cannot be expected to be stable

[ssteinbuss]

Hi @VladimirAlexiev ,

great that you are interested in the RAM document. As of today a pdf version is not yet planned, but in the meanwhile, you might try our gitbook version which has at least better readability.

[VladimirAlexiev]

Thanks @ssteinbuss ! I much prefer epub to pdf:

• searched for "gitbook to epub"
• gitbook has PDF export, but as a beta feature, available with a Pro or Enterprise plan
• https://github.com/GitbookIO/gitbook is a CLI by gitbook, but is deprecated and not updated for 4 years. Nevertheless, I tried the following:
  • installed npm install gitbook-cli -g
  • ran gitbook -help, that returned some commands but not gitbook epub
  • ran gitbook -V. This showed "CLI version: 2.3.2" then started "Installing GitBook 3.2.3", but failed

    npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287
    if (cb) cb.apply(this, arguments)
             ^
    TypeError: cb.apply is not a function
    18
    at FSReqCallback.oncomplete (node:fs:199:5)

• "maybe this is useful: Gitbook2PDF @ github.com" but another user reports failure
• tried installing https://www.forgebox.io/view/gitbook-exporter but got this error https://ortussolutions.atlassian.net/browse/COMMANDBOX-1522

[VladimirAlexiev]

Got answer:

CommandBox doesn’t support Java 18 yet (due to bundled libraries that don’t support it). Please use Java 11. If you need Java 18 on your machine, put the Java 11 in a folder called jre in the same directory as box.exe and it will use it.

thanks! I guess that’s why you have downloads with bundled JRE. Will try.