#!/bin/sh
##
## Script to check WCAG 1.0 Checklist on openacs (test descriptions)
## -----------------------------------------------------------------
## Copyright (C) 2008 Hector Romojaro
##
##-------------------------------------------------------------------------------##
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
#
##-------------------------------------------------------------------------------##

### Descriptions for each test (DESC_1_1 = Description for test 1.1) ######################
# Priority 1
DESC_1_1='[1.1] Provide a text equivalent for every non-text element.'
DESC_1_1_VERBOSE='(alt attribute for img, applet, area and input tags)
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-text-equivalent '
DESC_2_1='[2.1] Ensure that all information conveyed with color is also available without color.'
DESC_2_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-color-convey"
DESC_4_1='[4.1] Clearly identify changes in the natural language of a document text and any text equivalents (e.g., captions).'
DESC_4_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-identify-changes"
DESC_6_1='[6.1] Organize documents so they may be read without style sheets.'
DESC_6_1_VERBOSE='For example, when an HTML document is rendered without associated style sheets, it must still be possible to read the document.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-order-style-sheets'
DESC_6_2='[6.2] Ensure that equivalents for dynamic content are updated when the dynamic content changes.'
DESC_6_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-dynamic-source"
DESC_7_1='[7.1] Until user agents allow users to control flickering, avoid causing the screen to flicker.'
DESC_7_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-flicker"
DESC_14_1='[14.1] Use the clearest and simplest language appropriate for a site content.'
DESC_14_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-simple-and-straightforward"
DESC_1_2='[1.2] Provide redundant text links for each active region of a server-side image map.'
DESC_1_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-redundant-server-links"
DESC_9_1='[9.1] Provide client-side image maps instead of server-side image maps except where the regions cannot be defined with an available geometric shape.'
DESC_9_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-client-side-maps"
DESC_5_1='[5.1] For data tables, identify row and column headers.'
DESC_5_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-table-headers"
DESC_5_2='[5.2] For data tables that have two or more logical levels of row or column headers, use markup to associate data cells and header cells.'
DESC_5_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-table-structure"
DESC_12_1='[12.1] Title each frame to facilitate frame identification and navigation.'
DESC_12_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-frame-titles"
DESC_6_3='[6.3] Ensure that pages are usable when scripts, applets, or other programmatic objects are turned off or not supported.'
DESC_6_3_VERBOSE="If this is not possible, provide equivalent information on an alternative accessible page.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-scripts"
DESC_1_3='[1.3] Until user agents can automatically read aloud the text equivalent of a visual track, provide an auditory description of the important information of the visual track of a multimedia presentation.'
DESC_1_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-auditory-descriptions"
DESC_1_4='[1.4] For any time-based multimedia presentation, synchronize equivalent alternatives with the presentation.'
DESC_1_4_VERBOSE="(e.g. a movie or animation with captions or auditory descriptions of the visual tracks).
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-synchronize-equivalents"
DESC_11_4='[11.4] If, after best efforts, you cannot create an accessible page, provide a link to an alternative page that uses W3C technologies, is accessible, has equivalent information (or functionality), and is updated as often as the inaccessible (original) page.'
DESC_11_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-alt-pages"

# Priority 2
DESC_2_2='[2.2] Ensure that foreground and background color combinations provide sufficient contrast when viewed by someone having color deficits or when viewed on a black and white screen. [Priority 2 for images, Priority 3 for text].'
DESC_2_2_VERBOSE="Colors should not be defined with names.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-color-contrast"
DESC_3_1='[3.1] When an appropriate markup language exists, use markup rather than images to convey information.'
DESC_3_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-use-markup"
DESC_3_2='[3.2] Create documents that validate to published formal grammars.'
DESC_3_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-identify-grammar"
DESC_3_3='[3.3] Use style sheets to control layout and presentation.'
DESC_3_3_VERBOSE="<i> and <b> should be changed for <em> and <strong>.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-style-sheets"
DESC_3_4='[3.4] Use relative rather than absolute units in markup language attribute values and style sheet property values.'
DESC_3_4_VERBOSE="Avoid absolute units: in, cm, mm, pt, pc.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-relative-units"
DESC_3_5='[3.5] Use header elements to convey document structure and use them according to specification.'
DESC_3_5_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-logical-headings"
DESC_3_6='[3.6] Mark up lists and list items properly.'
DESC_3_6_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-list-structure"
DESC_3_7='[3.7] Mark up quotations. Do not use quotation markup for formatting effects such as indentation.'
DESC_3_7_VERBOSE="<q> and <blockquote> should be used only for quotations, not for indentation
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-quotes"
DESC_6_5='[6.5] Ensure that dynamic content is accessible or provide an alternative presentation or page.'
DESC_6_5_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-fallback-page"
DESC_7_2='[7.2] Until user agents allow users to control blinking, avoid causing content to blink (i.e., change presentation at a regular rate, such as turning on and off).'
DESC_7_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-blinking"
DESC_7_4='[7.4] Until user agents provide the ability to stop the refresh, do not create periodically auto-refreshing pages.'
DESC_7_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-no-periodic-refresh"
DESC_7_5='[7.5] Until user agents provide the ability to stop auto-redirect, do not use markup to redirect pages automatically. Instead, configure the server to perform redirects.'
DESC_7_5_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-no-auto-forward"
DESC_10_1='[10.1] Until user agents allow users to turn off spawned windows, do not cause pop-ups or other windows to appear and do not change the current window without informing the user.'
DESC_10_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-pop-ups"
DESC_11_1='[11.1] Use W3C technologies when they are available and appropriate for a task and use the latest versions when supported.'
DESC_11_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-latest-w3c-specs"
DESC_11_2='[11.2] Avoid deprecated features of W3C technologies.'
DESC_11_2_VERBOSE='(Deprecated tags: <applet>,<center>,<applet>,<basefont>,<dir>,<font>,<isindex>,<menu>,<s>,<strike>,<u>)
Deprecated tags: http://www.w3.org/TR/REC-html40/index/elements.html
Deprecated attributes (only on some tags, check exceptions carefully!): 
align (caption,  iframe, img, input, object, legend, table, hr, div, h*, p) 
alink (body) 
background (body) 
bgcolor (table, tr, td, th, body) 
border (img, object) 
clear (br) 
compact (dl, menu, ol, ul) 
height (td, th) 
hspace (img, object) 
language (script) 
link (body) 
noshade (hr) 
nowrap (td,th) 
size (hr) 
start (ol) 
text (body)
type (li,ol,ul) 
value (li) 
version (html) 
vlink (body) 
vspace (img, object) 
width (hr, td, th, pre)
Deprecated attributes: http://www.w3.org/TR/REC-html40/index/attributes.html
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-deprecated'
DESC_12_3='[12.3] Divide large blocks of information into more manageable groups where natural and appropriate.'
DESC_12_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-group-information"
DESC_13_1='[13.1] Clearly identify the target of each link.'
DESC_13_1_VERBOSE="Links MAY have a title attribute.
http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-meaningful-links"
DESC_13_2='[13.2] Provide metadata to add semantic information to pages and sites.'
DESC_13_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-use-metadata"
DESC_13_3='[13.3] Provide information about the general layout of a site (e.g., a site map or table of contents).'
DESC_13_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-site-description"
DESC_13_4='[13.4] Use navigation mechanisms in a consistent manner.'
DESC_13_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-clear-nav-mechanism"
DESC_5_3='[5.3] Do not use tables for layout unless the table makes sense when linearized. Otherwise, if the table does not make sense, provide an alternative equivalent (which may be a linearized version).'
DESC_5_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-table-for-layout"
DESC_5_4='[5.4] If a table is used for layout, do not use any structural markup for the purpose of visual formatting.'
DESC_5_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-table-layout"
DESC_12_2='[12.2] Describe the purpose of frames and how frames relate to each other if it is not obvious by frame titles alone.'
DESC_12_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-frame-longdesc"
DESC_10_2='[10.2] Until user agents support explicit associations between labels and form controls, for all form controls with implicitly associated labels, ensure that the label is properly positioned.'
DESC_10_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-unassociated-labels"
DESC_12_4='[12.4] Associate labels explicitly with their controls.'
DESC_12_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-associate-labels"
DESC_6_4='[6.4] For scripts and applets, ensure that event handlers are input device-independent.'
DESC_6_4_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-keyboard-operable-scripts"
DESC_7_3='[7.3] Until user agents allow users to freeze moving content, avoid movement in pages'
DESC_7_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-avoid-movement"
DESC_8_1='[8.1] Make programmatic elements such as scripts and applets directly accessible or compatible with assistive technologies [Priority 1 if functionality is important and not presented elsewhere, otherwise Priority 2.]'
DESC_8_1_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-directly-accessible"
DESC_9_2='[9.2] Ensure that any element that has its own interface can be operated in a device-independent manner.'
DESC_9_2_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-keyboard-operable"
DESC_9_3='[9.3] For scripts, specify logical event handlers rather than device-dependent event handlers.'
DESC_9_3_VERBOSE="http://www.w3.org/TR/WCAG10/wai-pageauth.html#tech-device-independent-events"

# Priority 3
DESC__=''
DESC___VERBOSE=""

