From d458d7524690dd8fa7ba7548b3830b8def4cac02 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ioan-Cristian=20C=C3=8ERSTEA?= Date: Sun, 12 May 2024 18:07:23 +0300 Subject: [PATCH] Added support for EPUB builds MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This pull requests adds `asciidoctor-epub3` as a Ruby package to be installed to support EPUB builds. It also updates the documentation to address an issue with EPUB CSS decoding: SASS (asciidoctor-epub3 dependency) relies on the environment encoding when decoding CSS files. Signed-off-by: Ioan-Cristian CÎRSTEA --- Dockerfiles/ubuntu2204 | 1 + README.md | 4 +++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/Dockerfiles/ubuntu2204 b/Dockerfiles/ubuntu2204 index 2a9d407..bbec2f0 100644 --- a/Dockerfiles/ubuntu2204 +++ b/Dockerfiles/ubuntu2204 @@ -58,6 +58,7 @@ RUN export DEBIAN_FRONTEND=noninteractive && \ asciidoctor-lists \ asciidoctor-mathematical \ asciidoctor-pdf \ + asciidoctor-epub3 \ asciidoctor-kroki \ citeproc-ruby \ coderay \ diff --git a/README.md b/README.md index 46ae1b4..f7eecfa 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ To build the documentation, execute the following steps: # clone the upstream repository of the documentation (see The Branches) # run the build within the container from within the riscv-isa-manual directory -docker run -it -v $(pwd)/riscv-isa-manual:/build riscvintl/riscv-docs-base-container-image:latest /bin/sh -c 'cd ./build; make' +docker run -it -v $(pwd)/riscv-isa-manual:/build riscvintl/riscv-docs-base-container-image:latest /bin/sh -c 'EXPORT LANG=C.utf8; cd ./build; make' ``` The build artifacts will be located within the `riscv-isa-manual` in the `build` directory, for instance: @@ -118,6 +118,8 @@ To build the documentation, execute the following steps: docker run -it -v $(pwd)/riscv-isa-manual:/build riscvintl/riscv-docs-base-container-image:latest /bin/bash # within the container +# asciidoctor-epub3's dependency SASS fails to parse SCSS files due to the encoding being set to ANSI_X3.4-1968 +export LANG=C.utf8 cd ./build make ```