# eBook Add-on

**URL:** <https://discuss.write.as/t/ebook-add-on/1271>\
**Category:** Labs\
**Created:** [April 15, 2020, 6:14pm UTC](https://discuss.write.as/t/ebook-add-on/1271 "2020-04-15T18:14:27Z")\
**Posts on this page:** 20\
**Page:** 4

<div class="post-metadata">

**Author:** ![writecropley](https://discuss.write.as/user_avatar/discuss.write.as/writecropley/32/2222_2.png) [@writecropley](https://discuss.write.as/u/writecropley)\
**Post date:** [September 12, 2022, 10:59pm UTC](https://discuss.write.as/t/ebook-add-on/1271/64 "2022-09-12T22:59:18Z")

</div>

I am no longer using this feature at all what so ever, no need to copy me in further.

---

<div class="post-metadata">

**Author:** ![matt](https://discuss.write.as/user_avatar/discuss.write.as/matt/32/2760_2.png) [@matt](https://discuss.write.as/u/matt)\
**Post date:** [October 11, 2022, 4:42pm UTC](https://discuss.write.as/t/ebook-add-on/1271/65 "2022-10-11T16:42:11Z")

</div>

Hey, give this a try again. I’ve extended the time allowed to generate the ebooks, so it may take a bit, but it shouldn’t timeout and show you that message anymore.

Let me know if you still have any trouble!

---

<div class="post-metadata">

**Author:** ![Kroeber](https://discuss.write.as/user_avatar/discuss.write.as/kroeber/32/1738_2.png) [@Kroeber](https://discuss.write.as/u/Kroeber)\
**Post date:** [October 11, 2022, 8:11pm UTC](https://discuss.write.as/t/ebook-add-on/1271/66 "2022-10-11T20:11:36Z")

</div>

Hi @matt thank you for your help.  
This is the error I am getting now:

 ![Captura de ecrã 2022-10-11 211033](https://discuss.write.as/uploads/default/original/2X/7/721847c2fc9726f7ba2ddbec7b0c8d978938658c.png)

---

<div class="post-metadata">

**Author:** ![matt](https://discuss.write.as/user_avatar/discuss.write.as/matt/32/2760_2.png) [@matt](https://discuss.write.as/u/matt)\
**Post date:** [October 11, 2022, 8:16pm UTC](https://discuss.write.as/t/ebook-add-on/1271/67 "2022-10-11T20:16:06Z")

</div>

Thanks – can you try one more time now?

---

<div class="post-metadata">

**Author:** ![Kroeber](https://discuss.write.as/user_avatar/discuss.write.as/kroeber/32/1738_2.png) [@Kroeber](https://discuss.write.as/u/Kroeber)\
**Post date:** [October 11, 2022, 10:12pm UTC](https://discuss.write.as/t/ebook-add-on/1271/68 "2022-10-11T22:12:51Z")

</div>

It worked perfectly :))) ty so much, Matt!

---

<div class="post-metadata">

**Author:** ![matt](https://discuss.write.as/user_avatar/discuss.write.as/matt/32/2760_2.png) [@matt](https://discuss.write.as/u/matt)\
**Post date:** [October 11, 2022, 10:14pm UTC](https://discuss.write.as/t/ebook-add-on/1271/69 "2022-10-11T22:14:59Z")

</div>

Glad to help! Thank you for your patience with it!!

---

<div class="post-metadata">

**Author:** ![playgroundtourist](https://discuss.write.as/user_avatar/discuss.write.as/playgroundtourist/32/1110_2.png) [@playgroundtourist](https://discuss.write.as/u/playgroundtourist)\
**Post date:** [November 25, 2022, 9:32am UTC](https://discuss.write.as/t/ebook-add-on/1271/70 "2022-11-25T09:32:29Z")

</div>

This works for me, too, thanks for the update! What is the advantage of this export instead of a simple PDF export? What is different when I export to .epub directly?

---

<div class="post-metadata">

**Author:** ![PaoloAmoroso](https://discuss.write.as/user_avatar/discuss.write.as/paoloamoroso/32/1659_2.png) [@PaoloAmoroso](https://discuss.write.as/u/PaoloAmoroso)\
**Post date:** [November 25, 2022, 5:21pm UTC](https://discuss.write.as/t/ebook-add-on/1271/71 "2022-11-25T17:21:33Z")

</div>

ePub is a reflowable text format best suited to mobile and small screens, PDF a fixed layout format.

---

<div class="post-metadata">

**Author:** ![playgroundtourist](https://discuss.write.as/user_avatar/discuss.write.as/playgroundtourist/32/1110_2.png) [@playgroundtourist](https://discuss.write.as/u/playgroundtourist)\
**Post date:** [November 26, 2022, 8:33am UTC](https://discuss.write.as/t/ebook-add-on/1271/72 "2022-11-26T08:33:22Z")

</div>

Thanks for the quick reply. Do you know what it will do with pictures? I have the issue that my uploaded pictures are just a bit too big to fit two horizontal ones on one page in a PDF export. It works if I scale down text size by 10 degrees, but this also decreases font size, which is not what I wanted. Would pictures be scaled automatically?

---

<div class="post-metadata">

**Author:** ![PaoloAmoroso](https://discuss.write.as/user_avatar/discuss.write.as/paoloamoroso/32/1659_2.png) [@PaoloAmoroso](https://discuss.write.as/u/PaoloAmoroso)\
**Post date:** [November 26, 2022, 12:13pm UTC](https://discuss.write.as/t/ebook-add-on/1271/73 "2022-11-26T12:13:49Z")

</div>

Does Write.as support PDF export? If so I’m not familiar with it and don’t know how it may handle images.

---

<div class="post-metadata">

**Author:** ![playgroundtourist](https://discuss.write.as/user_avatar/discuss.write.as/playgroundtourist/32/1110_2.png) [@playgroundtourist](https://discuss.write.as/u/playgroundtourist)\
**Post date:** [November 26, 2022, 1:58pm UTC](https://discuss.write.as/t/ebook-add-on/1271/74 "2022-11-26T13:58:47Z")

</div>

Oh, you’re right, I just print the blog page from my browser, then write.as has nothing to do with it, of course.

---

<div class="post-metadata">

**Author:** ![sfsspace](https://discuss.write.as/letter_avatar_proxy/v4/letter/s/df705f/32.png) [@sfsspace](https://discuss.write.as/u/sfsspace)\
**Post date:** [December 8, 2022, 7:21pm UTC](https://discuss.write.as/t/ebook-add-on/1271/75 "2022-12-08T19:21:12Z")

</div>

Here is what I get when I try it.

There is an error with [About SFSS — SFSS](https://sfss.space/about)

I don’t know how to fix it.  
Otherwise, the ebook looks great.

 ![Screenshot_2022-12-08-20-18-03-40_528fcc6268b5cf6bef0c8d3ef9270e11](https://discuss.write.as/uploads/default/original/2X/b/b98bad147f223e94a0214e241188cfa4d43273b9.jpeg)

---

<div class="post-metadata">

**Author:** ![suitbertmonz](https://discuss.write.as/user_avatar/discuss.write.as/suitbertmonz/32/2494_2.png) [@suitbertmonz](https://discuss.write.as/u/suitbertmonz)\
**Post date:** [December 14, 2022, 10:19am UTC](https://discuss.write.as/t/ebook-add-on/1271/76 "2022-12-14T10:19:01Z")

</div>

I have made my first try with the .epub-add-on. Looks great! Thanks a lot! But I am missing all those photos embedde to my post-articles. Any parameter to be set? I have used: [https://write.as/xxx/tag:yyy.epub](https://write.as/xxx/tag:yyy.epub)

---

<div class="post-metadata">

**Author:** ![justinf](https://discuss.write.as/user_avatar/discuss.write.as/justinf/32/1242_2.png) [@justinf](https://discuss.write.as/u/justinf)\
**Post date:** [April 11, 2023, 1:14pm UTC](https://discuss.write.as/t/ebook-add-on/1271/77 "2023-04-11T13:14:12Z")

</div>

> [@matt](#):
>
> Snap.as images should work just fine in the ebooks! Assuming you’re using Markdown to include them, or valid XHTML `<img />` tags.

Using the “fancy” editor to insert images, not markdown.

---

<div class="post-metadata">

**Author:** ![suitbertmonz](https://discuss.write.as/user_avatar/discuss.write.as/suitbertmonz/32/2494_2.png) [@suitbertmonz](https://discuss.write.as/u/suitbertmonz)\
**Post date:** [April 11, 2023, 3:03pm UTC](https://discuss.write.as/t/ebook-add-on/1271/78 "2023-04-11T15:03:00Z")

</div>

Just give [https://monz.photos/tag:fotografie.epub](https://monz.photos/tag:fotografie.epub) a try, please! There are no images to be seen in the eBook. So what is going wrong?

---

<div class="post-metadata">

**Author:** ![sfsspace](https://discuss.write.as/letter_avatar_proxy/v4/letter/s/df705f/32.png) [@sfsspace](https://discuss.write.as/u/sfsspace)\
**Post date:** [June 15, 2023, 9:22am UTC](https://discuss.write.as/t/ebook-add-on/1271/79 "2023-06-15T09:22:45Z")

</div>

So, I have a custom domain ([https://sfss.space](https://sfss.space)). For those who have one, you have to add /.epub to the original domain.

Here’s the result in my case:  
[https://write.as/science-fiction-short-stories/.epub](https://write.as/science-fiction-short-stories/.epub)

Two things:

1. There are posts/chapters I want to exclude (archives section for example). I’ll do that by editing the book with Calibre, I think that will do the trick). Or better, Ill create another blog containing only the posts I want.

2. I have an error messages on certain pages and I don’t understand why… If someone has an idea on how to solve it, Id be very grateful.

---

<div class="post-metadata">

**Author:** ![sfsspace](https://discuss.write.as/letter_avatar_proxy/v4/letter/s/df705f/32.png) [@sfsspace](https://discuss.write.as/u/sfsspace)\
**Post date:** [June 15, 2023, 9:25am UTC](https://discuss.write.as/t/ebook-add-on/1271/80 "2023-06-15T09:25:36Z")

</div>

(“error on line 13 at column 34: attribute id redefined - below is the rendering of the page up to the first error”)

---

<div class="post-metadata">

**Author:** ![sfsspace](https://discuss.write.as/letter_avatar_proxy/v4/letter/s/df705f/32.png) [@sfsspace](https://discuss.write.as/u/sfsspace)\
**Post date:** [June 17, 2023, 10:12am UTC](https://discuss.write.as/t/ebook-add-on/1271/81 "2023-06-17T10:12:27Z")

</div>

Fixed the error by going to line 13 and erasing the html tags

---

<div class="post-metadata">

**Author:** ![rhubarb](https://discuss.write.as/user_avatar/discuss.write.as/rhubarb/32/964_2.png) [@rhubarb](https://discuss.write.as/u/rhubarb)\
**Post date:** [August 19, 2023, 4:08pm UTC](https://discuss.write.as/t/ebook-add-on/1271/82 "2023-08-19T16:08:04Z")

</div>

Are you still working on epub export, @matt ?

I found some bugs, that might benefit from your attention. 🪳 In order to reproduce them, download [https://write.as/blog/tag:Updates.epub](https://write.as/blog/tag:Updates.epub) and validate with [EPUBCheck](https://www.w3.org/publishing/epubcheck/).

On my machine it resulted in 41 [error messages](https://www.w3.org/publishing/epubcheck/docs/messages/).

Duplicate elements:

- 3x `RSC-016 Fatal Error while parsing file: Attribute "id" was already specified for element "h2".`

Forbidden elements:

- 1x `CSS-001 The "unicode-bidi" property must not be included in an EPUB Style Sheet`

Missing elements:

- 1x `OPF-053 Date value "" does not follow recommended syntax as per http://www.w3.org/TR/NOTE-datetime:zero-length string.`
- 1x `RSC-005 Error while parsing file: character content of element "dc:date" invalid; must be a string with length at least 1 (actual length was 0)`
- 1x `RSC-005 Error while parsing file: Element "title" must not be empty.`

Remote resources not properly referenced or declared:

- 5x `RSC-006 Remote resource reference is not allowed in this context; resource […] must be located in the EPUB container.`
- 4x `OPF-014 The property "remote-resources" should be declared in the OPF file.`

Broken links:

- 18x `RSC-007 Referenced resource […] could not be found in the EPUB.`
- 7x `RSC-026 URL […] leaks outside the container (it is not a valid-relative-ocf-URL-with-fragment string)`

From my own experiments with [pandoc](https://pandoc.org) I’ve learned that creating a properly formatted epub has its unique challenges. It might sound trivial, but an epub is not a website. It is a self-contained entity with a peculiar structure and wrapping.

Hope this helps.

---

<div class="post-metadata">

**Author:** ![rhubarb](https://discuss.write.as/user_avatar/discuss.write.as/rhubarb/32/964_2.png) [@rhubarb](https://discuss.write.as/u/rhubarb)\
**Post date:** [August 19, 2023, 4:52pm UTC](https://discuss.write.as/t/ebook-add-on/1271/83 "2023-08-19T16:52:30Z")

</div>

Hi @sfsspace, most of the errors that [EPUBCheck](https://www.w3.org/publishing/epubcheck/) reports for your EPUB are already mentioned in [this post](https://discuss.write.as/t/ebook-add-on/1271/82). Some of them are formal and technical details, that @matt should be able to fix quickly.

More interesting is the question, how exported epubs should handle non-text content:

a) Images that are hosted on snap.as should be included by default in the exported epub, especially if they were uploaded from the same user account as the text. I can’t think of a legal or technical reason not to do it.

b) Embedded content from other sources, like Youtube, could be replaced by a placeholder with an external link to the resource. That’s a design decision for Matt.

[Previous page](https://discuss.write.as/t/ebook-add-on/1271.md?page=3)

[Next page](https://discuss.write.as/t/ebook-add-on/1271.md?page=5)
