On Thu, Dec 16, 2021 at 10:37 AM Richard Haines <richard_c_haines@xxxxxxxxxxxxxx> wrote: > > On Mon, 2021-12-13 at 20:01 -0500, Paul Moore wrote: > > On Mon, Dec 13, 2021 at 5:16 AM Richard Haines > > <richard_c_haines@xxxxxxxxxxxxxx> wrote: > > > > > > Build an epub document. > > > > > > Signed-off-by: Richard Haines <richard_c_haines@xxxxxxxxxxxxxx> > > > --- > > > BUILD.md | 23 +++++++++++++++----- > > > CONTRIBUTING.md | 10 ++++----- > > > Makefile | 48 +++++++++++++++++++++++++++++++++++------ > > > README.md | 9 ++++---- > > > src/cover.md | 16 ++++++++++++++ > > > src/cover_epub.md | 2 ++ > > > src/metadata.yaml | 14 ++++++++++++ > > > src/styles_epub.css | 52 > > > +++++++++++++++++++++++++++++++++++++++++++++ > > > src/styles_html.css | 8 +++++++ > > > src/styles_pdf.css | 8 +++++++ > > > src/title.md | 16 -------------- > > > 11 files changed, 169 insertions(+), 37 deletions(-) > > > create mode 100644 src/cover.md > > > create mode 100644 src/cover_epub.md > > > create mode 100644 src/styles_epub.css > > > > I had to do some merge fixups due to the logo change, and I added a > > few missing oxford commas (*cough*) but like others I had mixed > > results rendering the EPUB on my Linux system. Thankfully the HTML > > and PDF formats still looked good. > > > > However, one of the more unfortunate things is that when I tried to > > read the EPUB on my Kindle it failed miserably; although oddly enough > > the PDF worked fine, the text was just a bit too small to read > > comfortably. I think it would be good to be able to generate a > > Kindle > > compatible EPUB before we merge this. > > Thanks for merging the first three patches. > As you have probably guessed I don't have a Kindle, although I did use > Calibre to convert EPUB to: > > AZW3 (KF8) - This was readable using Foliate and Calibre E-Book Viewer > with no problems (however the links to the examples didn't work with > the Calibre E-Book Viewer). > > MOBI - This was only readable using Calibre E-Book Viewer, however the > tables lost their boarders. > > So this Calibre command converts to AZW3: > > ebook-convert SELinux_Notebook.epub SELinux_Notebook.azw3 > > Will this work on your Kindle with no issues ?? The command format is > described in [1] and there are many options. > > [1] https://manual.calibre-ebook.com/generated/en/ebook-convert.html Thanks for your patience and your continued work on this Richard. I'm testing out the new patchset now and hope to be able to report back soon, i.e. tonight assuming no interruptions. As far as Kindles and the various ebook formats go, the reason I mentioned the Kindle is simply because it seems to be one of the most popular ebook hardware devices and as such I figure it would be important that The Notebook render correctly there. However, I'm well outside the realm of my expertise, so if anyone can correct me, please do so :) It has been my experience, and I'm assuming that of most Linux/SELinux folks, that if I'm reading something on a proper computer that needs more formatting than what plaintext can provide a PDF is preferable. Is it common for people to choose ebooks over PDFs when reading on a larger computer screen? -- paul moore www.paul-moore.com