Re: Any Web Authoring Tools that work with VO?

2012-04-27 Thread Benjamin Hawkes-Lewis
On Fri, Apr 27, 2012 at 2:06 PM, Martin McCormick
mar...@x.it.okstate.edu wrote:
        I am looking for a way besides manually cobbling html
 together to build web pages with forms that users could fill in
 to help us provide automated services that we presently must
 manually suffer through.

It's not entirely clear what your problem with manually cobbling html
together is that you are trying to solve, or that a different editor
is going to help.

If your problem is repetitive labor, maybe what you need is a
templating system like Jinja2 to allow you to reuse code.

If your problem is time to market, maybe what you need is a full-blown
web application framework like Django, which would typically include a
templating system, prebuilt widgets, and utilities for processing form
submissions and interacting with databases?

If your problem is not knowing the right HTML to use, maybe you need a
good resource on HTML like:

   http://www.w3.org/wiki/Web_Standards_Curriculum

We have no way to tell the customer what he/she should enter. They
don't know what we want so nobody's happy.

Is your problem that you're not sure how to encode names and
descriptions for form fields in HTML?

Use label elements to name controls. Associate labels with controls
with for and id attributes.

Use p elements to provide additional text help for controls.
Associate paragraphs with controls using the id and
aria-describedby attributes.

Use fieldset to group controls. Use legend to name field sets.

Does this example help?

  h1Title for the form/h1
  pGeneral introduction to the form./p
  form action=submission-url
method=POST
fieldset
  legendShort name for a group of form controls/legend
  label for=unique-control-identifierShort name for an
individual control:/label
  input name=name-to-use-when-submitting-the-form
 id=unique-control-identifier
 aria-describedby=unique-additional-help-identifier
  p id=unique-additional-help-identifierAdditional help for
the control goes here./p
/fieldset
input type=submit value=Short name for submit button
  /form

Alternatively, if you're not sure how to design forms to be easy to
use, I recommend _Web Form Design: Filling in the Blanks_ by Luke
Wroblewski:

   http://www.lukew.com/resources/web_form_design.asp

--
Benjamin Hawkes-Lewis
--- Mac Access At Mac Access Dot Net ---

To reply to this post, please address your message to mac-access@mac-access.net

You can find an archive of all messages postedto the Mac-Access forum at 
either the list's own dedicated web archive:
http://mail.tft-bbs.co.uk/pipermail/mac-access/index.html
or at the public Mail Archive:
http://www.mail-archive.com/mac-access@mac-access.net/.
Subscribe to the list's RSS feed from:
http://www.mail-archive.com/mac-access@mac-access.net/maillist.xml

The Mac-Access mailing list is guaranteed malware, spyware, Trojan, virus and 
worm-free!

Please remember to update your membership options periodically by visiting the 
list website at:
http://mail.tft-bbs.co.uk/mailman/listinfo/mac-access/options/


Re: turning PDF into text

2011-12-19 Thread Benjamin Hawkes-Lewis
On Mon, Dec 19, 2011 at 9:28 PM, Paula Hobley paula.hob...@bigpond.com wrote:
 I am looking for an application that will turn my pdf documents into text.
 Can anybody recommend anything?  I know ABBY Fine Reader is out there, but I
 don't want to actually scan books, just turn pdf images into text.

ABBY can work from an opened PDF file.

Having bought ABBY, I've actually ended up using PDFPenPro instead. I
think it behaves much more like a Mac application than ABBY. However,
I don't know how well it plays with VoiceOver.

--
Benjamin Hawkes-Lewis
--- Mac Access At Mac Access Dot Net ---

To reply to this post, please address your message to mac-access@mac-access.net

You can find an archive of all messages postedto the Mac-Access forum at 
either the list's own dedicated web archive:
http://mail.tft-bbs.co.uk/pipermail/mac-access/index.html
or at the public Mail Archive:
http://www.mail-archive.com/mac-access@mac-access.net/.
Subscribe to the list's RSS feed from:
http://www.mail-archive.com/mac-access@mac-access.net/maillist.xml

The Mac-Access mailing list is guaranteed malware, spyware, Trojan, virus and 
worm-free!

Please remember to update your membership options periodically by visiting the 
list website at:
http://mail.tft-bbs.co.uk/mailman/listinfo/mac-access/options/


Re: navigating to a longdesc link in an image

2011-12-11 Thread Benjamin Hawkes-Lewis
On Thu, Dec 8, 2011 at 6:28 PM, Carolyn Wagner wagner...@verizon.net wrote:
 I cannot share the url of the page I am working with, but I can tell you that 
 a link was added under the image linking to a long description page, in 
 addition to the longdesc attribute in the image tag.

Interesting, thanks.

 I am curious how the aria-describedby attribute would be used. Would it be 
 included in the image tag, or a surrounding div tag? Do you have any example 
 you can point me to? Or can you provide an example of it used in source code?

In it's simplest form:

   img alt=Short text alternative aria-describedby=#long-text-alternative
   p id=long-text-alternative/p

Note:

   * Unlike with longdesc, typical AT setups will read the element
referenced by aria-describedby automatically when the image is
encountered. This is not always agreed to be an advantage.
   * The element referenced by aria-describedby can be anywhere on the
same page.
   * You can reference elements in different parts of the page using a
space separated list (#part1 #part2), and AT will join the text
together.
   * This technique is not suitable for text alternatives consisting
of structural markup like tables since only the text will be put in
the accessibility tree, not the structure.
   * You can add JS to hide or show the element when a button is
pushed (perhaps an info icon) to minimize visual impact. Even when
the element is hidden with CSS, AT should still read the content when
the image is encountered. This also has the advantage of hiding it
from the normal reading flow which will stop typical AT setups from
reading it again. In the future you should be able to use the HTML5
details element instead of JS.

--
Benjamin Hawkes-Lewis
--- Mac Access At Mac Access Dot Net ---

To reply to this post, please address your message to mac-access@mac-access.net

You can find an archive of all messages postedto the Mac-Access forum at 
either the list's own dedicated web archive:
http://mail.tft-bbs.co.uk/pipermail/mac-access/index.html
or at the public Mail Archive:
http://www.mail-archive.com/mac-access@mac-access.net/.
Subscribe to the list's RSS feed from:
http://www.mail-archive.com/mac-access@mac-access.net/maillist.xml

The Mac-Access mailing list is guaranteed malware, spyware, Trojan, virus and 
worm-free!

Please remember to update your membership options periodically by visiting the 
list website at:
http://mail.tft-bbs.co.uk/mailman/listinfo/mac-access/options/


Re: navigating to a longdesc link in an image

2011-12-07 Thread Benjamin Hawkes-Lewis
On Wed, Dec 7, 2011 at 5:52 PM, Carolyn Wagner wagner...@verizon.net wrote:
 Some images on the web provide an alternative text version that should 
 describe the image. In certain cases a description of more than 30 words is 
 necessary to describe the image so a longdesc attribute is added to the image 
 tag. Like this img src=myImage alt=a picture of me 
 longdesc=fulldesc.html The longdesc is a link to page that has a longer 
 detailed description of the image.

 I was wondering if there is a particular command or setting to link to the 
 longdesc from VoiceOver. Right now, VO only reads the alt text a picture of 
 me. But doesn't allow for me to link to the fulldesc.html page.

There's no VoiceOver command for accessing longdesc, and no Safari
or Chrome user interface for longdesc. So to access longdesc you'd
need some sort of add-on or script. (I'm not aware of any that have
been written for these programs.)

I'm a member of a group working on the next version of HTML. Currently
(and controversially), the current draft specification recommends
authors do not use longdesc. So I'm interested in use of longdesc
in the wild. Would you be able to provide the address of any webpages
that use a longdesc you'd like to access?

If you are the author of the page, would you consider other means of
providing the information such as:

* Providing a visible link to the long description after the image.
* Including a long description on the same page as the image. This
could be declaratively associated with the image using the
aria-describedby attribute. When JS is available, you could hide the
description by default and provide a button that shows it when
pressed.

An advantage of these approaches is that the long description is
available to everyone who might have trouble using the image using
widely implemented features. A disadvantage is that the availability
of the long description might not be advertised to screen reader users
who jump from image to image on the page. Also, obviously, these
approaches have an impact on the visual design of the page.

Also, what guidance are you following that suggests 30 words is the
maximum suitable length for an alt attribute? As an author, if you
wouldn't want to add a visible long description or visible link to the
long description, would you consider providing the whole long
description in the alt attribute? This is what the current HTML
draft spec suggests.

--
Benjamin Hawkes-Lewis
--- Mac Access At Mac Access Dot Net ---

To reply to this post, please address your message to mac-access@mac-access.net

You can find an archive of all messages postedto the Mac-Access forum at 
either the list's own dedicated web archive:
http://mail.tft-bbs.co.uk/pipermail/mac-access/index.html
or at the public Mail Archive:
http://www.mail-archive.com/mac-access@mac-access.net/.
Subscribe to the list's RSS feed from:
http://www.mail-archive.com/mac-access@mac-access.net/maillist.xml

The Mac-Access mailing list is guaranteed malware, spyware, Trojan, virus and 
worm-free!

Please remember to update your membership options periodically by visiting the 
list website at:
http://mail.tft-bbs.co.uk/mailman/listinfo/mac-access/options/