- 1 NOTE: This page is being edited right now. Please check back in an hour or so
- 2 Overview
- 3 Vocabulary
- 4 Use of extensions on bookFormat
- 5 AccessFeature in more depth
- 6 Example Markup
- 7 Issues Tracker and Open Issues
- 8 Discussion and Related Work
NOTE: This page is being edited right now. Please check back in an hour or so
Making Accessible Content Discoverable
The A11yMetadata Project seeks to extend schema.org by including new properties to address the accessibility and discoverability of resources on the Web.
A majority of properties and terms in this proposal are a subset derived from the IMS Global Learning Consortium's Access For All specification. IMS Global Learning Consortium has licensed these properties to schema.org under the Creative Commons Attribute-ShareAlike License (version 3.0) so that they can be used under schema.org‘s corresponding terms and conditions. Any other organizations or initiatives that would like to adopt IMS Global’s AccessForAll for other purposes are requested to coordinate directly with IMS Global.
V.5 was submitted on April 15, 2013
V.6 was finalized on September 8, 2013. The major changes are simplifications: moving displayTransformability from a property to a property value of mediaFeature, adding a few more mediaFeature properties, reordering some items and making clear that two properties are only for use on softwareApplication and its subclasses. This simplicity does not detract from the information model, but eases adoption. The two samples were also updated to reflect these changes. V.6 was never fully publicized, but became a working model for the group.
Changes are being made for a .7 specification, which is expected to be published on November 8, 2013. There was a significant amount of work that went into this, but the net is minor changes and simplifications through the extensions mechanism and much better descriptions, There are a number of refinements to the properties, simplifying some with the use of extensions, adding new property values and renaming some of the properties to new names. While most of these are simple refinements in definition or name changes, some of the these name changes will impact all existing tagged documents. The most significant of these is to change mediaFeature to accessFeature and controlFlexibility to accessFlexibility. Details of these changes can be seen in the minutes of the working group in October and November 2013. We also changed the sense of values in accessHazard to allow both negative and positive assertions. This addresses issues 1, 2 and 3, as well as 8. This may be called V1.0 when done.The work was segmented into sections that were agreed upon by all and properties that needed more refinement and coordination with other efforts. The current proposal is segmented into a 1.0 proposal for four properties and a proposal for future effort, which will commence once 1.0 is adopted. Our current focus is on the adoption of 1.0.
There is now an Open Issues wiki page that will track issues as we drive to completion. Open items will be noted on this page, and the tracker will contain them all.
The accepted vocabulary so far is at WebSchemas/Accessibility. This page is to track ongoing work, alongside the Issue tracker (see below)
The "extended" proposal (post 1.0)
There were a few properties that are still under consideration, but have been deferred for a later release (V1.1). accessMode needs more work to allow both the source and the augmented access mode. The is/has adaptation links work will be done in concert with the Bibex group, with details and timing left to be determined. See also the Issues page (which will be edited down to the resolved issues for 1.0 and the open issues for future).
|Property||Expected Type||Expected Values||Description|
||An access mode through which the intellectual content of a described resource or adaptation is communicated. The IMS model defines this as "The human sensory perceptual system or cognitive faculty through which a person may process or perceive information." If adaptations for the resource are known, the access modes of those adaptations are not included. The accessModes after visual in the list are all refinements of what is presented in the visual mode. Note that there is also a discussion of an augmentedAccessMode for future effort.|
|hasAdaptation||URL||Identifier of a resource that is an adaptation, for accessibility purposes, for this resource. (to be handled with Bibex)|
|isAdaptationOf||URL||Identifier of a resource for which this is an adaptation for accessibility purposes. (to be handled with Bibex)|
Use of extensions on bookFormat
The current use of bookFormat uses an enumeration for the type, but it only goes one level deep (EBook, Hardcover, Paperback)
This proposal also requests the expansion of bookFormat to include the following extensions of EBook and Paperback:
- EBook/PDF and other formats, mobi, etc.
AccessFeature in more depth
The property accessFeature has multiple property values. Each of these is worth a short description. First, there are three types of accessFeatures: transform, structure and augmentation.
- Transform acccessFeatures are transformations of or enhancements to content that make it more accessible without changing the access mode. A large print book is a good example of this.
- Structure accessFeatures describe the access aids that are provided to work within the media, such as the use of a table of contents, index or other items to be able to navigate to a point in content easily without linear scanning.
- Augmentation accessFeatures make the content in one accessMode available in a different one. The augmentation type that most people are familiar with is alternativeText, which people have learned to apply to HTML images. While transform and structure accessFeatures do not require intelligence to apply, an augmentation normally will. As such, their quality cannot always be counted on.
There are three tables below, one for each of the types of accessFeatures. The extensions that can be used are unique to each of the types.
AccessFeature for transformation
Transform accessFeatures either state how content is available in a transformed state or is set up so that a user can transform it. These properties derive from WCAG 2.0 section 1.4 and surrounding areas. Common refinement/extensions of the property value are
- /nnn (a specific pointsize, common for large print)
- /CSSEnabled - that the resource has been designed to be mutable through CSS in an appropriate viewer
- /yellowOnBlack or other specific common color combinations (for high contrast)
|Expected Values||Transformed Access Mode||Description|
||Visual, Textual||can add most comment colors as extensions, such as highContrast/yellowOnBlack, greenOnBlack, whiteOnBlack and blackOnWhite or just say /CSSEnabled if CSS is set up to allow these changes to be customized by the user.|
||Visual, Textual||can add specific pointsize, as in largePrint/18 or just /CSSEnabled. Printed books (Visual) would never use the /CSSEnabled: that would be limited to electronic texts. A physical book would, if any extension, use a pointsize.|
||Textual||either /CSSEnabled or the extension /taggedPDF if the PDF allows resize and reflow.|
||Textual||The document is set up for CSS display transformability.|
||Auditory|| For prerecorded audio content that contains primarily speech in the foreground.
AccessFeature for structure
There is only one property value for structuralNavigation, which is listed below.
||table of contents or similar resource to allow higher-level document navigation, which can be extended as /tableofContents, /index, /headings, /tags, /bookmarks, /printedPageNumber if one wants to give more detail|
AccessFeature for augmentation
Augmentation is the most interesting of the accessFeatures. It explains how an intelligent actor (generally a person, but could be computer-based) will take the intellectual content of one access mode and make it available in a different access mode. One can debate whether the source or the destination access mode is of more importance; I have chosen to organize this by the destination access mode that the source access mode was augmented to. Note that there is a common extension that is used to represent the refinement of the visual content types (see all of the /*OnVisual in access modes). so that one can express accessFeatures for specific parts of the visual content.
|Expected Values||Augmented Access Mode||Source Access Mode (before augmentation)||Description|
||Textual||Visual||alternative text is provided for visual content (e.g., the HTML alt attribute).|
||Textual||Visual||descriptions are provided for image-based visual content and/or complex structures such as tables, mathematics, diagrams or charts.|
||Textual||Visual||The use of one of these specific ASCII/XML encodings for mathematics or chemistry. These can have extensions specified, but are rarely needed.|
||Textual||Auditory||The addition of a separate transcript to convey the meaning of the audio.|
||Visual||Auditory||The addition of synchronized text (closed captions) to convey the meaning of the audio. Note that while many captions may be implemented as textual in the transport, users think of them as being a visual appearance.|
||Visual||Auditory||The presentation of audio in sign language in the visual presentation. The most likely extension is /sgn-en-us or other ISO 639 sign language code.|
||Auditory||Visual||Audio descriptions are available (e.g., via the HTML5 track element). Common extensions are for the various "onImage" refinements noted above.|
||Tactile||Visual or Textual||braille content or alternative is available (e.g., eBraille or print braille) This can have extensions for the different types of braille, /ASCII, /music, /math, /chem or /nemeth) (also consider /contracted and /gradeII or other nomenclature... pretty open)|
||Tactile||Visual||tactile graphics have been provided, as described in the BANA Guidelines and Standards for Tactile Graphics.|
||Tactile||Visual||tactile 3D objects have been defined and a 3D object or instructions to build one are available.|
Example 1 (Book)
The following example shows how the accessibility metadata will be used to enhance Bookshare records. Note that our markuup has advanced since this early illustrative example. A description and the process and a corpus of searchable books can be found at the accessibility metadata website.
More examples are referenced in the Discussion and Related Work section. Note that there has been discussion of the accessMode (which would have a value of textual and visual" and isAdaptation, which would be urn:isbn:9780030426599, but these are still in flux and have been removed from the example)
<div itemscope="" itemtype="http://schema.org/Book">
<meta itemprop="bookFormat" content="EBook/DAISY3"/>
<meta itemprop="accessibilityFeature" content="largePrint/CSSEnabled"/>
<meta itemprop="accessibilityFeature" content="highContrast/CSSEnabled"/>
<meta itemprop="accessibilityFeature" content="resizeText/CSSEnabled"/>
<meta itemprop="accessibilityFeature" content="displayTransformability"/>
<meta itemprop="accessibilityFeature" content="longDescription"/>
<meta itemprop="accessibilityFeature" content="alternativeText"/>
<meta itemprop="accessibilityControl" content="fullKeyboardControl"/>
<meta itemprop="accessibilityControl" content="fullMouseControl"/>
<meta itemprop="accessibilityHazard" content="noFlashing"/>
<meta itemprop="accessibilityHazard" content="noMotionSimulation"/>
<meta itemprop="accessibilityHazard" content="noSound"/>
<meta itemprop="accessibilityAPI" content="ARIA"/>
<dd itemprop="name">Holt Physical Science</dd>
<dd itemprop="description">NIMAC-sourced textbook</dd>
<dd itemprop="numberOfPages">598 Pages</dd>
<dd itemprop="publisher" itemtype="http://schema.org/Organization" itemscope="">Holt, Rinehart and Winston</dd>
<dt>Date of Addition:</dt>
<dd itemprop="copyrightHolder" itemtype="http://schema.org/Organization" itemscope="">Holt, Rinehart and Winston</dd>
<dd><meta itemprop="isFamilyFriendly" content="true"/>No</dd>
<dd><meta itemprop="inLanguage" content="en-US"/>English US</dd>
<dd><span itemprop="genre">Educational Materials</span></dd>
<dd>Sixth grade, Seventh grade, Eighth grade</dd>
<dd>This book is currently only available to public K-12 schools and organizations in the United States for use with students with an IEP, because it was created from files supplied by the NIMAC under these restrictions. Learn more in the NIMAC Support Center.</dd>
<div class="bookReviews" itemprop="aggregateRating" itemscope itemtype="http://schema.org/AggregateRating">
<h2>Reviews of Holt Physical Science (<span itemprop="reviewCount">0</span> reviews)</h2>
<span><span itemprop="ratingValue>0</span> - No Rating Yet</span>
(The source record can be found at https://www.bookshare.org/browse/book/190639.)
Example 2 (Video)
This example shows how the accessibility metadata can be used to augment a record for a video. Note that the access modes appear in the content for this page, but do not have accesssibility metadata tags added, as this is not in the 1.0 specification. Neither is hasAdapation, which would have a URL like to <a itemprop="hasAdaptation" href="http://www.teachersdomain.org/asset/echo07_vid_climate_dvs/">
<dl itemtype="http://schema.org/VideoObject" itemscope="">
<dd itemprop="name">Arctic Climate Perspectives</dd>
<dd itemprop="description">This video, adapted from material provided by the ECHO partners,
describes how global climate change is affecting Barrow, Alaska.</dd>
<!-- note that the spans in the next line are not in the immediate proposal -->
<dd><a itemprop="url" href="http://www.teachersdomain.org/asset/echo07_vid_climate">http://www.teachersdomain.org/asset/echo07_vid_climate</a>/</dd>
<dd><span itemprop="about">National K-12 Subject::Science::Earth and Space Science::Water Cycle, Weather,
and Climate::Structure and Composition of the Atmosphere, National K-12 Subject::Science::Earth and
Space Science::Water Cycle, Weather, and Climate::Climate</span></dd>
<dd>Grade 6, Grade 7, Grade 8, Grade 9</dd>
<dd><span itemprop="genre">Audio/Visual</span>, <span itemprop="genre">Movie/Animation</span></dd>
<dd>Download and Share, <a itemprop="useRightsUrl" href="http://www.teachersdomain.org/oerlicense/2/">http://www.teachersdomain.org/oerlicense/2/</a></dd>
Issues Tracker and Open Issues
This list will be updated afte rthe first meeting
- stuff (referring to open items, by name and number)
Discussion and Related Work
- Discussion List Google Group discussion list
- Accessibility Metadata Project primary site, including blog
- Additional Examples
- Live Examples: real marked up pages that can be searched
- A11yMetadata Crosswalk
- Additional long-form Resources for usage, especially
- IMS Global Access for All (AfA) Digital Resource Description (DRD) Version 3.0 Specification
- IMS Global Access For All (AfA) Digital Resource Description Specification Information Model
- Access for All XSD Schema Definition
- accessMode names are derived primarily from AfA AccessModeRequired.Type/existingAccessMode.
- mediaFeature names are derived primarily from AfA AdaptationTypeRequired.Type/adaptationRequest.