From bf2f5e10c3c33c16e09b5183be767d85a9392fa2 Mon Sep 17 00:00:00 2001
From: Alex Cabal <alex@alexcabal.com>
Date: Sun, 13 Mar 2022 19:53:15 -0400
Subject: [PATCH] Add Kobo FAQ

---
 www/ebooks/ebook.php               |  2 +-
 www/help/how-to-use-our-ebooks.php | 15 +++++++++++----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/www/ebooks/ebook.php b/www/ebooks/ebook.php
index 48f120b5..fd6a5307 100644
--- a/www/ebooks/ebook.php
+++ b/www/ebooks/ebook.php
@@ -209,7 +209,7 @@ catch(InvalidEbookException $ex){
 							<li property="schema:encoding" typeof="schema:MediaObject">
 								<meta property="schema:encodingFormat" content="application/kepub+zip"/>
 								<p>
-									<span><a property="schema:contentUrl" href="<?= $ebook->KepubUrl ?>" class="kobo" download=""><span property="schema:description">kepub</span></a></span> <span>—</span> <span>Kobo devices and apps.</span>
+									<span><a property="schema:contentUrl" href="<?= $ebook->KepubUrl ?>" class="kobo" download=""><span property="schema:description">kepub</span></a></span> <span>—</span> <span>Kobo devices and apps. You may also be interested in our <a href="/help/how-to-use-our-ebooks#kobo-faq">Kobo FAQ</a>.</span>
 								</p>
 							</li>
 							<? } ?>
diff --git a/www/help/how-to-use-our-ebooks.php b/www/help/how-to-use-our-ebooks.php
index dc20cb58..1331ec0a 100644
--- a/www/help/how-to-use-our-ebooks.php
+++ b/www/help/how-to-use-our-ebooks.php
@@ -176,13 +176,20 @@ require_once('Core.php');
 				</li>
 			</ul>
 		</section>
+		<section id="kobo-faq">
+			<h2>Kobo FAQ</h2>
+			<ul>
+				<li>
+					<p><b>Why do you offer a separate kepub file, when Kobos can open S.E.’s compatible epub files?</b></p>
+					<p>It’s true that Kobos can open and read regular epub files like the compatible epubs we offer for download. But doing so triggers Kobo’s bad ebook renderer, which based on A.D.E. Your ebooks are going to look bad because the renderer Kobo selects for plain epubs is bad.</p>
+					<p>When Kobo opens kepub files—which are still epub files, but specially prepared with extra Kobo-specific markup—Kobo uses their advanced Webkit-based renderer to render the ebook. This renderer is very good, and has support for a lot of advanced ebook rendering features that our specially-prepared kepub files take advantage of. Your ebooks will look very good when you use the kepub files instead of the compatible epub files.</p>
+					<p>We very much wish that Kobo would allow plain epubs to be presented to readers using their good renderer, and not A.D.E. You can <a href="https://help.kobo.com/hc/en-us/requests/new">contact Kobo</a> to let them know you’d like that, too.</p>
+				</li>
+			</ul>
+		</section>
 		<section id="kindle-faq">
 			<h2>Kindle FAQ</h2>
 			<ul>
-				<li>
-					<p><b>How do I transfer ebooks to my Kindle?</b></p>
-					<p>Scroll up to see!</p>
-				</li>
 				<li>
 					<p><b>Why don’t you provide mobi files <em>instead of</em> azw3 files?</b></p>
 					<p>Mobi ebooks are an older ebook file format, and they don’t support many basic features you’d expect from a beautiful ebook, like hyphenation. Since the file format is so old—dating back to 2007—its support for the latest ebook technology is poor, making it much harder for us to produce well-formatted ebooks in that file format.</p>