RE: Request for partecipating in the project

[arthur miller]

Isn't epub developed to be electroncal version of printed books, so that electronicall books can keep same logical layout (chapters, paragraphs, pages, etc) as their physical counterparts? Probably not a deal breaker, but software documentation maybe is not really suitable for that kind of publishing.

I think Emacs help is great, but I really miss great overview over the API as found for example in javadoc. 

When it comes to accessibility I am not sure if epub offers you that much more of accessibility options then you get from in html, but I might be wrong. Anyway there is a good guide on making information accessible to visually impaired people: 

https://www.google.com/url?q=https://www.sabeusa.org/wp-content/uploads/2014/02/A-Guide-to-Making-Documents-Accessible-to-People-Who-are-Blind-or-Visually-Impaired.pdf&sa=U&ved=2ahUKEwjS-9e-0MrmAhWHlYsKHcJ9BZ0QFjACegQIBhAB&usg=AOvVaw3P809blo61Vmg1IzcMSZ6M

Just as a note.

Skickat från min Samsung Galaxy-smartphone.

-------- Originalmeddelande --------

Från: Tim Cross <address@hidden>

Datum: 2019-12-23 01:04 (GMT+01:00)

Till: Marcin Borkowski <address@hidden>

Kopia: arthur miller <address@hidden>, Sam Qasbah <address@hidden>, address@hidden

Ämne: Re: Request for partecipating in the project

There is no single ebook-friendly format. Different ebook readers are better/worse with different formats (mobi, epub, etc). Therefore, we probably need to be a little more explicit when talking about ebook formats.

One of the advantages of some ebook formats, such as epub, is that they can be more accessible for the blind and vision impaired than PDF or even HTML. There are at least two packages I'm aware of which will allow epub formatted books to also be read directly in Emacs. 

My experience with Calibre is that the quality of the output you get depends on both the quality of input (e.g. poorly structured or poorly tagged PDFs will result in poor conversion) and on the settings of Calibre itself (of which there is quite a lot). I'm not sure how well Emacs documentation will convert. My experience with PDFs generated from Latex is not good as Latex is very weak with respect to accessibility and generating modern tagged PDF documents.

On Mon, 23 Dec 2019 at 09:01, Marcin Borkowski <address@hidden> wrote:

On 2019-12-22, at 22:38, arthur miller <address@hidden> wrote:

> Skickat från min Samsung Galaxy-smartphone.
>
>
>> The ebook format allows you to consult the > manual with a smartphone, tablet or epub-> > reader.
>
> Both my smartphone and my tablet read Emacs manual perfectly fine in html format in browser, and I am sure if I wanted to read manuals in pdf format they would work perfectly fine too. What does epub brings that html or pdf does not? Personally I don't even like pdf.

AFAIK, ebook readers can render HTML, but work much better with
dediacted formats.

FWIW, I converted the Emacs manuals to an ebook-reader-friendly format
many years ago, and automatic conversion resulted in a very poor
experience.  If someone volunteers to do a better job than Calibri, I'm
all for it!!!

Best,

--
Marcin Borkowski
http://mbork.pl

--

regards,

Tim

--

Tim Cross