Creating accessible ebooks from word docs

Creating accessible ebooks from word docs

[Praats]

[-- Attachment #1.1: Type: text/plain, Size: 1334 bytes --]

Hi,

I've been converting docx files into the ePub format using Pandoc. The 
eBooks I am creating are for people who are visually impaired, the screen 
reader on the tablet reads out the text to the person using the tablet.

When I add images, ideally the screen reader should let the visually 
impaired person know that there is an image, and describe the image to 
them. Which can be done using the "alt" attribute within the <img> tag when 
creating eBooks from a HTML document

I wanted to know if there was a way by which I could add the "alt text" in 
the word document directly for every single image. As the people who will 
be using Pandoc to convert docx files into ePub files are not familiar with 
HTML tags

Any help will be appreciated. Thank you!

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-b6bb-8781af11a963%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 1864 bytes --]

Re: Creating accessible ebooks from word docs

[Rich Morin]

> On Feb 5, 2017, at 18:58, Praats <prathiksha.30-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> I wanted to know if there was a way by which I could add the "alt text"
> in the word document directly for every single image. 

If Pandoc already has a solution, great.  If not, it shouldn't be all
that hard to write a script that adds the tags to the EPUB document.
Feel free to contact me off-list if you wish to pursue this option.

-r

 -- 
http://www.cfcl.com/rdm           Rich Morin           rdm-go8te9J4rpw@public.gmane.org
http://www.cfcl.com/rdm/resume    San Bruno, CA, USA   +1 650-873-7841

Software system design, development, and documentation

Re: Creating accessible ebooks from word docs

[John MacFarlane]

The docx reader extracts the alt element from the "descr"
attribute of Word images (drawings etc.).  I'm not sure
what you need to do in Word to ensure that this attribute
is set, but maybe someone else here can help with that.

+++ Praats [Feb 05 17 18:58 ]:
>   Hi,
>   I've been converting docx files into the ePub format using Pandoc. The
>   eBooks I am creating are for people who are visually impaired, the
>   screen reader on the tablet reads out the text to the person using the
>   tablet.
>   When I add images, ideally the screen reader should let the visually
>   impaired person know that there is an image, and describe the image to
>   them. Which can be done using the "alt" attribute within the <img> tag
>   when creating eBooks from a HTML document
>   I wanted to know if there was a way by which I could add the "alt text"
>   in the word document directly for every single image. As the people who
>   will be using Pandoc to convert docx files into ePub files are not
>   familiar with HTML tags
>   Any help will be appreciated. Thank you!
>
>   --
>   You received this message because you are subscribed to the Google
>   Groups "pandoc-discuss" group.
>   To unsubscribe from this group and stop receiving emails from it, send
>   an email to [1]pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To post to this group, send email to
>   [2]pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
>   To view this discussion on the web visit
>   [3]https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-
>   b6bb-8781af11a963%40googlegroups.com.
>   For more options, visit [4]https://groups.google.com/d/optout.
>
>References
>
>   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   2. mailto:pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org
>   3. https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-b6bb-8781af11a963-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer
>   4. https://groups.google.com/d/optout

Re: Creating accessible ebooks from word docs

[Drew Keller]

[-- Attachment #1.1: Type: text/plain, Size: 3191 bytes --]

If the docx reader does indeed extract that element, how can it be included 
in the converted document?

I'm converting docx to rst so maybe it is different, but I have set the 
description field in Word's "Alt Text" Description panel but the alt text 
and description text never comes through to the converted RST file.


On Monday, February 6, 2017 at 4:29:42 AM UTC-5, John MacFarlane wrote:
>
> The docx reader extracts the alt element from the "descr" 
> attribute of Word images (drawings etc.).  I'm not sure 
> what you need to do in Word to ensure that this attribute 
> is set, but maybe someone else here can help with that. 
>
> +++ Praats [Feb 05 17 18:58 ]: 
> >   Hi, 
> >   I've been converting docx files into the ePub format using Pandoc. The 
> >   eBooks I am creating are for people who are visually impaired, the 
> >   screen reader on the tablet reads out the text to the person using the 
> >   tablet. 
> >   When I add images, ideally the screen reader should let the visually 
> >   impaired person know that there is an image, and describe the image to 
> >   them. Which can be done using the "alt" attribute within the <img> tag 
> >   when creating eBooks from a HTML document 
> >   I wanted to know if there was a way by which I could add the "alt 
> text" 
> >   in the word document directly for every single image. As the people 
> who 
> >   will be using Pandoc to convert docx files into ePub files are not 
> >   familiar with HTML tags 
> >   Any help will be appreciated. Thank you! 
> > 
> >   -- 
> >   You received this message because you are subscribed to the Google 
> >   Groups "pandoc-discuss" group. 
> >   To unsubscribe from this group and stop receiving emails from it, send 
> >   an email to [1]pandoc-discus...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >   To post to this group, send email to 
> >   [2]pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:>. 
> >   To view this discussion on the web visit 
> >   [3]
> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2- 
> >   b6bb-8781af11a963%40googlegroups.com. 
> >   For more options, visit [4]https://groups.google.com/d/optout. 
> > 
> >References 
> > 
> >   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:> 
> >   2. mailto:pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org <javascript:> 
> >   3. 
> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-b6bb-8781af11a963-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer 
> >   4. https://groups.google.com/d/optout 
>
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/2791ec38-a373-44d6-abf8-d70ddf71c0d7%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 6666 bytes --]

Re: Creating accessible ebooks from word docs

[Jesse Rosenthal]

Drew Keller <drew.keller.work-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> writes:

> If the docx reader does indeed extract that element, how can it be included 
> in the converted document?
>
> I'm converting docx to rst so maybe it is different, but I have set the 
> description field in Word's "Alt Text" Description panel but the alt text 
> and description text never comes through to the converted RST file.

It's a fairly recent feature -- what version of pandoc are you using?

Re: Creating accessible ebooks from word docs

[Drew Keller]

[-- Attachment #1.1: Type: text/plain, Size: 1423 bytes --]

Ah, that was the issue. It looks to have been added in 1.19

I had installed pandoc from homebrew which installed 1.18.

Manually installed the latest release and it did indeed extract the alt 
text from the description field.

Thanks for your help!

On Wednesday, February 8, 2017 at 2:45:30 PM UTC-5, Jesse Rosenthal wrote:
>
> Drew Keller <drew.kel...-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org <javascript:>> writes: 
>
> > If the docx reader does indeed extract that element, how can it be 
> included 
> > in the converted document? 
> > 
> > I'm converting docx to rst so maybe it is different, but I have set the 
> > description field in Word's "Alt Text" Description panel but the alt 
> text 
> > and description text never comes through to the converted RST file. 
>
> It's a fairly recent feature -- what version of pandoc are you using? 
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/ee3b3090-cd0d-45d7-80e4-8e7ce775a019%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 2298 bytes --]

Re: Creating accessible ebooks from word docs

[Praats]

[-- Attachment #1.1: Type: text/plain, Size: 3373 bytes --]

Where is the "Alt Text" field in Word to add a description text?

On Thursday, February 9, 2017 at 6:26:37 AM UTC+11, Drew Keller wrote:
>
> If the docx reader does indeed extract that element, how can it be 
> included in the converted document?
>
> I'm converting docx to rst so maybe it is different, but I have set the 
> description field in Word's "Alt Text" Description panel but the alt text 
> and description text never comes through to the converted RST file.
>
>
> On Monday, February 6, 2017 at 4:29:42 AM UTC-5, John MacFarlane wrote:
>>
>> The docx reader extracts the alt element from the "descr" 
>> attribute of Word images (drawings etc.).  I'm not sure 
>> what you need to do in Word to ensure that this attribute 
>> is set, but maybe someone else here can help with that. 
>>
>> +++ Praats [Feb 05 17 18:58 ]: 
>> >   Hi, 
>> >   I've been converting docx files into the ePub format using Pandoc. 
>> The 
>> >   eBooks I am creating are for people who are visually impaired, the 
>> >   screen reader on the tablet reads out the text to the person using 
>> the 
>> >   tablet. 
>> >   When I add images, ideally the screen reader should let the visually 
>> >   impaired person know that there is an image, and describe the image 
>> to 
>> >   them. Which can be done using the "alt" attribute within the <img> 
>> tag 
>> >   when creating eBooks from a HTML document 
>> >   I wanted to know if there was a way by which I could add the "alt 
>> text" 
>> >   in the word document directly for every single image. As the people 
>> who 
>> >   will be using Pandoc to convert docx files into ePub files are not 
>> >   familiar with HTML tags 
>> >   Any help will be appreciated. Thank you! 
>> > 
>> >   -- 
>> >   You received this message because you are subscribed to the Google 
>> >   Groups "pandoc-discuss" group. 
>> >   To unsubscribe from this group and stop receiving emails from it, 
>> send 
>> >   an email to [1]pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>> >   To post to this group, send email to 
>> >   [2]pandoc-...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>> >   To view this discussion on the web visit 
>> >   [3]
>> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2- 
>> >   b6bb-8781af11a963%40googlegroups.com. 
>> >   For more options, visit [4]https://groups.google.com/d/optout. 
>> > 
>> >References 
>> > 
>> >   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>> >   2. mailto:pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>> >   3. 
>> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-b6bb-8781af11a963-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer 
>> >   4. https://groups.google.com/d/optout 
>>
>>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/bc32e6fc-7eed-4b99-9921-05c1166b6aba%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 6242 bytes --]

Re: Creating accessible ebooks from word docs

[Drew Keller]

[-- Attachment #1.1: Type: text/plain, Size: 3687 bytes --]

I added it using this 
method https://support.office.com/en-us/article/Add-alternative-text-to-a-picture-shape-chart-SmartArt-graphic-or-table-52327e7c-cecb-45d4-9367-f911aa442371

On Sunday, February 12, 2017 at 11:13:32 PM UTC-5, Praats wrote:
>
> Where is the "Alt Text" field in Word to add a description text?
>
> On Thursday, February 9, 2017 at 6:26:37 AM UTC+11, Drew Keller wrote:
>>
>> If the docx reader does indeed extract that element, how can it be 
>> included in the converted document?
>>
>> I'm converting docx to rst so maybe it is different, but I have set the 
>> description field in Word's "Alt Text" Description panel but the alt text 
>> and description text never comes through to the converted RST file.
>>
>>
>> On Monday, February 6, 2017 at 4:29:42 AM UTC-5, John MacFarlane wrote:
>>>
>>> The docx reader extracts the alt element from the "descr" 
>>> attribute of Word images (drawings etc.).  I'm not sure 
>>> what you need to do in Word to ensure that this attribute 
>>> is set, but maybe someone else here can help with that. 
>>>
>>> +++ Praats [Feb 05 17 18:58 ]: 
>>> >   Hi, 
>>> >   I've been converting docx files into the ePub format using Pandoc. 
>>> The 
>>> >   eBooks I am creating are for people who are visually impaired, the 
>>> >   screen reader on the tablet reads out the text to the person using 
>>> the 
>>> >   tablet. 
>>> >   When I add images, ideally the screen reader should let the visually 
>>> >   impaired person know that there is an image, and describe the image 
>>> to 
>>> >   them. Which can be done using the "alt" attribute within the <img> 
>>> tag 
>>> >   when creating eBooks from a HTML document 
>>> >   I wanted to know if there was a way by which I could add the "alt 
>>> text" 
>>> >   in the word document directly for every single image. As the people 
>>> who 
>>> >   will be using Pandoc to convert docx files into ePub files are not 
>>> >   familiar with HTML tags 
>>> >   Any help will be appreciated. Thank you! 
>>> > 
>>> >   -- 
>>> >   You received this message because you are subscribed to the Google 
>>> >   Groups "pandoc-discuss" group. 
>>> >   To unsubscribe from this group and stop receiving emails from it, 
>>> send 
>>> >   an email to [1]pandoc-discus...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>> >   To post to this group, send email to 
>>> >   [2]pandoc-...-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org 
>>> >   To view this discussion on the web visit 
>>> >   [3]
>>> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2- 
>>> >   b6bb-8781af11a963%40googlegroups.com. 
>>> >   For more options, visit [4]https://groups.google.com/d/optout. 
>>> > 
>>> >References 
>>> > 
>>> >   1. mailto:pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>>> >   2. mailto:pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org 
>>> >   3. 
>>> https://groups.google.com/d/msgid/pandoc-discuss/ee06dc3e-1b69-4fe2-b6bb-8781af11a963-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org?utm_medium=email&utm_source=footer 
>>> >   4. https://groups.google.com/d/optout 
>>>
>>>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To post to this group, send email to pandoc-discuss-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/0bc61979-082c-4b89-b3e0-35398158bce8%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[-- Attachment #1.2: Type: text/html, Size: 6638 bytes --]