unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* RE: Request for partecipating in the project
@ 2019-12-22 22:32 arthur miller
  2019-12-22 22:46 ` Marcin Borkowski
  0 siblings, 1 reply; 14+ messages in thread
From: arthur miller @ 2019-12-22 22:32 UTC (permalink / raw)
  To: Marcin Borkowski; +Cc: Sam Qasbah, emacs-devel@gnu.org

[-- Attachment #1: Type: text/plain, Size: 1484 bytes --]


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

You mean some special hardware, or you mean ordinary ebook apps?

On my tablet I just open online manual in Firefox. There is also manual in pdf format, can't device render pdfs?



Skickat från min Samsung Galaxy-smartphone.


-------- Originalmeddelande --------
Från: Marcin Borkowski <mbork@mbork.pl>
Datum: 2019-12-22 23:00 (GMT+01:00)
Till: arthur miller <arthur.miller@live.com>
Kopia: Sam Qasbah <samqasbah@gmail.com>, emacs-devel@gnu.org
Ämne: Re: Request for partecipating in the project


On 2019-12-22, at 22:38, arthur miller <arthur.miller@live.com> 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

[-- Attachment #2: Type: text/html, Size: 2488 bytes --]

^ permalink raw reply	[flat|nested] 14+ messages in thread
* RE: Request for partecipating in the project
@ 2019-12-23 16:04 arthur miller
  2019-12-23 16:43 ` Tim Cross
  0 siblings, 1 reply; 14+ messages in thread
From: arthur miller @ 2019-12-23 16:04 UTC (permalink / raw)
  To: Tim Cross, Mario Lang; +Cc: emacs-devel@gnu.org

[-- Attachment #1: Type: text/plain, Size: 1715 bytes --]





.


> epub is an HTML based format. Essentially it is an archive file of HTML and metadata.

XML, not html.

> So the issue isn't so much whether it is
> better than HTML but more about some of
> the tools available.

Might be that there are better applications for voice reading then Emacs, albeit I think that your target group is already reading Emacs manual in Emacspeak. I think I will try to set  up Emacspeak for myself, have not done it yet.

Anyway, I hinted that epub might not be THE best format for a reference like API docs. I don't think that structure of chapters and especially pages are very good structure for electronic documents, especially not for API docs or references. Do you miss "page structure" on Wikipedia?

Emacs self documentation is good and being able to lookup stuff directly from within your Emacs is priceless, but sometimes I miss an easy overview of the api, for example when I can't remember name of a function or similar.

By the way, what kind of hardware does not have a web browser nowadays? Is not like online Emacs manual is full of javascript and other stuff on the edge of the web technology.

Skickat från min Samsung Galaxy-smartphone





On Mon, 23 Dec 2019 at 17:34, Mario Lang <mlang@blind.guru> wrote:
Tim Cross <theophilusx@gmail.com<mailto:theophilusx@gmail.com>> writes:

> 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.

Please name an example where epub clearly is bettern then HTML.
I (a blind user) have never seen one until now.

--
CYa,
  ⡍⠁⠗⠊⠕


--
regards,

Tim

--
Tim Cross


[-- Attachment #2: Type: text/html, Size: 3125 bytes --]

^ permalink raw reply	[flat|nested] 14+ messages in thread
* RE: Request for partecipating in the project
@ 2019-12-22 21:38 arthur miller
  2019-12-22 22:00 ` Marcin Borkowski
  0 siblings, 1 reply; 14+ messages in thread
From: arthur miller @ 2019-12-22 21:38 UTC (permalink / raw)
  To: Sam Qasbah, emacs-devel@gnu.org

[-- Attachment #1: Type: text/plain, Size: 430 bytes --]





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.

[-- Attachment #2: Type: text/html, Size: 1020 bytes --]

^ permalink raw reply	[flat|nested] 14+ messages in thread
* Request for partecipating in the project
@ 2019-12-22 17:23 Sam Qasbah
  2019-12-24  4:13 ` Richard Stallman
  0 siblings, 1 reply; 14+ messages in thread
From: Sam Qasbah @ 2019-12-22 17:23 UTC (permalink / raw)
  To: emacs-devel

[-- Attachment #1: Type: text/plain, Size: 844 bytes --]

Hello.
I asked to host the "Emacs Manual in ePub Format" project on Savannah (
https://savannah.nongnu.org/task/?15492). I had a discussion with Ineiev,
who thinks this project should be part of Emacs (
https://lists.gnu.org/archive/html/savannah-register-public/2019-12/msg00036.html).
So I ask to participate in the "Emacs" project as compiler of the manual in
ePub2 format. The ebook format allows you to consult the manual with a
smartphone, tablet or epub-reader. It is not a simple conversion from texi
to epub, but a craft work of organizing and adapting the files, rewriting
the formatting and adding a cover with a "fascinating" flavor. For me,
participating in the "Emacs" project would be an opportunity to improve my
computer skills and to exchange experiences with top-level programmers. I
can also convert the "elisp ref" to ePub

[-- Attachment #2: Type: text/html, Size: 1067 bytes --]

^ permalink raw reply	[flat|nested] 14+ messages in thread

end of thread, other threads:[~2019-12-24  4:13 UTC | newest]

Thread overview: 14+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-12-22 22:32 Request for partecipating in the project arthur miller
2019-12-22 22:46 ` Marcin Borkowski
  -- strict thread matches above, loose matches on Subject: below --
2019-12-23 16:04 arthur miller
2019-12-23 16:43 ` Tim Cross
2019-12-23 17:19   ` T.V Raman
2019-12-22 21:38 arthur miller
2019-12-22 22:00 ` Marcin Borkowski
2019-12-23  0:03   ` Tim Cross
2019-12-23  1:50     ` arthur miller
2019-12-23  3:23       ` T.V Raman
2019-12-23  6:34     ` Mario Lang
2019-12-23 14:38       ` Tim Cross
2019-12-22 17:23 Sam Qasbah
2019-12-24  4:13 ` Richard Stallman

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).