search

riscv / docs-dev-guide

Documentation developer guide
https://lists.riscv.org/g/sig-documentation
Creative Commons Attribution 4.0 International
87 stars 30 forks source link

Ruby 2.5.9? #5

Closed tariqkurd-repo closed 3 years ago

tariqkurd-repo commented 3 years ago

ALERT: Ensure that you are using Ruby 2.5.9 for all gems that you install for the Asciidoctor toolchain.

http://rubyinstaller.org/

does this mean that I should download ruby 2.5.9 from rubyinstaller.org? Because that version isn't apparently available.

tariqkurd-repo commented 3 years ago

except for the mathematical gem all is working

elisa-riscv commented 3 years ago

If another version of Ruby is working OK on your machine that's great.

Are you on a Windows machine?

I am using RVM with 2.5.9 on MacOS Big Sur (11.4).

elisa-riscv commented 3 years ago

I'm making note of the fact that the Ruby Asciidoctor toolchain makes use of Prawn for building PDF output, and that Prawn went for a few years without updates, then was updated in 2020. It looks like there will be another update in 2021. I have not yet looked into the details and wonder if some of the Ruby gems that are essential for specific features required for professional level pdfs will likewise be updated. Until that time the most promising workaround is to make use of Cygwin.

elisa-riscv commented 3 years ago

I am closing this issue and leaving #4 open because of the direct and intertwined relationship between the two issues.