Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

EPUB files generated by Quarto cannot be imported into Kindle Previewer #11948

Open
jenslaufer opened this issue Jan 24, 2025 · 0 comments
Open
Assignees
Labels
bug Something isn't working epub Issues with the ePub format.

Comments

@jenslaufer
Copy link

jenslaufer commented Jan 24, 2025

Bug description

I created a test book using Quarto (and Bookdown).

While the EPUB file generated by Bookdown can be imported into the Kindle Previewer, the EPUB file from Quarto fails (unfortunately without providing a clear log output)

Steps to reproduce

Without Building

In the release folder, there are three files:

  1. bookdown.epub
    The result of building with Bookdown. Import SUCCESS into Kindle Previewer.

  2. quarto.epub
    The result of building with Quarto. Import FAILED into Kindle Previewer.

  3. quarto-modified.epub
    After comparing the results of the Bookdown and Quarto builds, it was found that the Quarto xhtml has additional CSS styling in each xhtml file, despite a stylesheet already being imported. Removing this additional CSS resolved the issue, and the import succeeded. Import SUCCESS into Kindle Previewer.

Building Files from Scratch (Not necessary, just for the curious)"

  1. Clone the project: test book
  2. Run build.sh in the project directory.

Expected behavior

Kindle Previewer should successfully import an EPUB file generated by Quarto.

Actual behavior

Kindle Previewer import fails without providing a clear error message.

Your environment

Docker environment (have a look to the Dockerfile in the project)

FROM rocker/tidyverse AS builder

RUN apt update &&\
    apt -y upgrade &&\ 
    apt autoremove -y &&\ 
    wget https://github.com/quarto-dev/quarto-cli/releases/download/v1.6.40/quarto-1.6.40-linux-amd64.deb -O quarto.deb &&\
    apt install -y ./quarto.deb &&\
    rm ./quarto.deb &&\
    quarto install tinytex


COPY ./book-quarto /book

WORKDIR /book
RUN quarto render --to epub

FROM scratch AS export

COPY --from=builder /book/_book/ /

Quarto check output

Quarto book generation is successful, and the book is readable on the Calibre eBook reader.

@jenslaufer jenslaufer added the bug Something isn't working label Jan 24, 2025
@mcanouil mcanouil added the epub Issues with the ePub format. label Jan 24, 2025
@cderv cderv self-assigned this Jan 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working epub Issues with the ePub format.
Projects
None yet
Development

No branches or pull requests

3 participants