├── .gitignore ├── CONTRIBUTING.md ├── LICENSE.md ├── README.md ├── UX-Guide-Metadata ├── bin │ └── 1.0 │ │ ├── publish-principles.sh │ │ └── publish-techniques.sh ├── principles │ └── index.html └── techniques │ ├── README.md │ ├── epub-metadata │ └── index.html │ ├── media │ ├── image1.png │ └── image2.svg │ └── onix-metadata │ └── index.html ├── a11y-meta-display-guide ├── 2.0 │ ├── README.md │ ├── draft │ │ ├── README.md │ │ ├── common │ │ │ ├── acknowledgements.html │ │ │ └── js │ │ │ │ └── add_ids.js │ │ ├── guidelines │ │ │ ├── README.md │ │ │ ├── index.html │ │ │ └── media │ │ │ │ └── MetadataProcessing.png │ │ ├── localizations │ │ │ ├── README.md │ │ │ ├── crosscheck strings epub-onix-canonical_json.xlsx │ │ │ ├── en-US │ │ │ │ └── display_guide_vocabulary_w3c_en-US.json │ │ │ └── index.html │ │ └── techniques │ │ │ ├── README.md │ │ │ ├── epub-metadata │ │ │ └── index.html │ │ │ └── onix-metadata │ │ │ └── index.html │ ├── guidelines │ │ ├── guidelines-draft-note-20240906.html │ │ ├── guidelines-draft-note-20241101.html │ │ ├── guidelines-draft-note-20250220.html │ │ ├── index.html │ │ └── media │ │ │ ├── MetadataEcosystem.jpg │ │ │ └── MetadataProcessing.png │ ├── implementations │ │ └── index.html │ └── techniques │ │ ├── epub-metadata │ │ ├── epub-metadata-draft-note-20240906.html │ │ ├── epub-metadata-draft-note-20241101.html │ │ ├── epub-metadata-draft-note-20250220.html │ │ └── index.html │ │ └── onix-metadata │ │ ├── index.html │ │ ├── onix-metadata-draft-note-20240906.html │ │ ├── onix-metadata-draft-note-20241101.html │ │ └── onix-metadata-draft-note-20250220.html ├── 2.1 │ ├── README.md │ └── draft │ │ ├── README.md │ │ ├── common │ │ ├── acknowledgements.html │ │ └── js │ │ │ └── add_ids.js │ │ ├── guidelines │ │ ├── README.md │ │ ├── index.html │ │ └── media │ │ │ └── MetadataProcessing.png │ │ ├── localizations │ │ ├── README.md │ │ └── index.html │ │ └── techniques │ │ ├── README.md │ │ ├── epub-metadata │ │ └── index.html │ │ └── onix-metadata │ │ └── index.html ├── bin │ ├── README.md │ ├── canonical-json-extract-ids.xsl │ ├── canonical-json-extract-strings.xsl │ ├── extract-ids-from-guidelines.xsl │ ├── extract-ids-from-techniques.xsl │ ├── libs │ │ ├── vnu │ │ │ ├── CHANGELOG.md │ │ │ ├── LICENSE │ │ │ ├── README.md │ │ │ ├── index.html │ │ │ └── vnu.jar │ │ └── xml2csv-1.1.jar │ ├── publish-drafts.sh │ ├── strings-crosscheck.sh │ └── update-canonical-json.sh └── implementations │ ├── graphics │ ├── catalogo-lia │ │ └── display.png │ ├── daisy-viewer │ │ └── display.png │ ├── readium-mobile │ │ └── display.png │ └── thorium-desktop │ │ └── display.png │ └── index.html ├── drafts ├── a11y-crosswalk-MARC │ └── index.html ├── audio-playback │ └── index.html ├── page-source-id │ ├── css │ │ └── common.css │ ├── index.html │ └── js │ │ └── css-inline.js ├── schema-a11y-summary │ └── index.html └── zero-tolerance-conformance │ └── index.html ├── epub-a11y-meta-guide └── 1.0 │ ├── draft │ └── index.html │ └── index.html ├── templates └── cg-note.html └── w3c.json /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | **/.DS_Store 3 | UX-Guide-Metadata/bin/_tmp/ 4 | 5 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Publishing Working Group 2 | 3 | Contributions to this repository are intended to become part of Recommendation-track documents governed by the 4 | [W3C Patent Policy](http://www.w3.org/Consortium/Patent-Policy-20040205/) and 5 | [Software and Document License](http://www.w3.org/Consortium/Legal/copyright-software). To make substantive contributions to specifications, you must either participate 6 | in the relevant W3C Working Group or make a non-member patent licensing commitment. 7 | 8 | If you are not the sole contributor to a contribution (pull request), please identify all 9 | contributors in the pull request comment. 10 | 11 | To add a contributor (other than yourself, that's automatic), mark them one per line as follows: 12 | 13 | ``` 14 | +@github_username 15 | ``` 16 | 17 | If you added a contributor by mistake, you can remove them in a comment with: 18 | 19 | ``` 20 | -@github_username 21 | ``` 22 | 23 | If you are making a pull request on behalf of someone else but you had no part in designing the 24 | feature, you can remove yourself with the above syntax. 25 | -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- 1 | All documents in this Repository are licensed by contributors under the 2 | [W3C Software and Document License](http://www.w3.org/Consortium/Legal/copyright-software). 3 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | ![W3C Logo](https://www.w3.org/Icons/w3c_home) 3 | 4 | # Publishing Accessibility Task Force 5 | 6 | This is the repository for the Accessibility Task Force of the Publishing Community Group. 7 | 8 | ## Participation 9 | 10 | To join the task force, please first become a member of the [Publishing Community Group](https://www.w3.org/community/publishingcg/). 11 | 12 | ## Meetings 13 | 14 | Task force meetings are announced on the Publishing Community Group's [public mailing list](https://lists.w3.org/Archives/Public/public-publishingcg/). All members of the group are welcome to join. 15 | 16 | [Minutes of the task force meetings](https://github.com/w3c/publ-a11y/wiki/Minutes-of-Publishing-CG-Accessibility-Task-Force-Meetings) 17 | 18 | ## Documents 19 | 20 | The Accessibility Task Force maintains the following documents in this repository: 21 | 22 | - Accessibility Metadata Display Guide for Digital Publications ([Project Page](https://github.com/w3c/publ-a11y/tree/main/a11y-meta-display-guide/2.1)) 23 | - [Editor's Draft](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/) 24 | - [Latest Version](https://www.w3.org/publishing/a11y/metadata-display-guide/guidelines/) 25 | - EPUB Techniques 26 | - [Editor's Draft](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/) 27 | - [Latest Version](https://www.w3.org/publishing/a11y/metadata-display-guide/techniques/epub/) 28 | - ONIX Techniques 29 | - [Editor's Draft](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/) 30 | - [Latest Version](https://www.w3.org/publishing/a11y/metadata-display-guide/techniques/onix/) 31 | - Accessibility Properties Crosswalk 32 | - [Editor's Draft](https://w3c.github.io/publ-a11y/drafts/a11y-crosswalk-MARC/) 33 | - Publishing Guide to Audio Playback and Text-To-Speech 34 | - [Editor's Draft](https://w3c.github.io/publ-a11y/drafts/audio-playback/) 35 | - [Latest Version](https://www.w3.org/publishing/a11y/audio-playback/) 36 | - Page Source Identification 37 | - [Editor's Draft](https://w3c.github.io/publ-a11y/drafts/page-source-id/) 38 | - [Latest Version](https://www.w3.org/publishing/a11y/page-source-id/) 39 | - Accessibility Summary Authoring Guidelines for EPUB Publications 40 | - [Editor's Draft](https://w3c.github.io/publ-a11y/drafts/schema-a11y-summary/) 41 | - [Latest Version](https://www.w3.org/publishing/a11y/schema-a11y-summary/) 42 | - Zero-Tolerance Accessibility Conformance Approaches for Publishing 43 | - [Editor's Draft](https://w3c.github.io/publ-a11y/drafts/zero-tolerance-conformance/) 44 | 45 | ## Contributing to the Repository 46 | 47 | Use the standard fork, branch, and pull request workflow to propose changes to the specification. Please make branch names informative—by including the issue or bug number for example. 48 | 49 | Editorial changes that improve the readability of the spec or correct spelling or grammatical mistakes are welcome. 50 | 51 | Please read [CONTRIBUTING.md](CONTRIBUTING.md), about licensing contributions. 52 | 53 | -------------------------------------------------------------------------------- /UX-Guide-Metadata/bin/1.0/publish-principles.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | # Script for creating static version for the principles document 4 | # It starts from the published draft (in the main branch): https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/principles/ 5 | # It generates the static version 6 | # It runs nuchecker and link checker 7 | # The output is a zip folder that can be sent to W3C staff for publishing on the website 8 | 9 | # input 10 | read -p 'Publishing date (format YYYY-MM-DD): ' publishDate 11 | 12 | # pre-run: cleans and temporary directory... 13 | BASEDIR=$(dirname "$0") 14 | rm -rf $BASEDIR/_tmp 15 | mkdir $BASEDIR/_tmp 16 | 17 | # copies the content to the temporary directory 18 | printf "\nCopying the content to the temporary directory..." 19 | cp -a $BASEDIR/../draft/principles/. $BASEDIR/_tmp/ 20 | rm $BASEDIR/_tmp/*.md 21 | 22 | # generates the static version 23 | printf "\nGenerating static version..." 24 | curl \ 25 | -G \ 26 | --data-urlencode "type=respec" \ 27 | --data-urlencode "url=https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/principles/?specStatus=CG-FINAL&publishDate=$publishDate" \ 28 | https://labs.w3.org/spec-generator/ \ 29 | -o $BASEDIR/_tmp/index.html 30 | 31 | # generates the static version 32 | printf "\nReplacing URLs..." 33 | sed 's#\.\./#https://www.w3.org/publishing/a11y/UX-Guide-metadata/#g' $BASEDIR/_tmp/index.html > $BASEDIR/_tmp/index-mod.html 34 | mv $BASEDIR/_tmp/index-mod.html $BASEDIR/_tmp/index.html 35 | #sed 's#\./#https://www.w3.org/publishing/a11y/UX-Guide-metadata/principles/#g' $BASEDIR/_tmp/index-mod.html > $BASEDIR/_tmp/index.html 36 | #rm -f $BASEDIR/_tmp/index-mod.html 37 | 38 | # runs nuchecker 39 | nuVersion=$(java -jar libs/vnu/vnu.jar --version) 40 | printf "\nRunning Nu Html Checker version $nuVersion..." 41 | java -jar libs/vnu/vnu.jar \ 42 | $BASEDIR/_tmp/index.html 43 | 44 | if [ $? -gt 0 ] 45 | then 46 | exit 1 47 | fi 48 | 49 | # runs link checker 50 | # installed via commands: 51 | # cpan install App::cpanminus 52 | # cpanm W3C::LinkChecker@4.81 53 | # cpan install Mozilla::CA 54 | # tried to install version 5.0.0 on mac, but I got errors 55 | checklinkVersion=$(checklink --version) 56 | printf "\nRunning $checklinkVersion..." 57 | checklink \ 58 | --summary \ 59 | --broken \ 60 | "https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/principles/?specStatus=CG-FINAL&publishDate=$publishDate" 61 | 62 | if [ $? -gt 0 ] 63 | then 64 | exit 1 65 | fi 66 | 67 | # generates the zip 68 | printf "\nZipping..." 69 | cd $BASEDIR/_tmp 70 | zip -r $BASEDIR/../UX-Guide-Metadata-principles.zip . -x ".DS_Store" -x "__MACOSX" -x "**/.DS_Store" 71 | 72 | printf "\nZip ready in /UX-Guide-Metadata-principles.zip" 73 | 74 | # cleaning 75 | rm -rf $BASEDIR/_tmp -------------------------------------------------------------------------------- /UX-Guide-Metadata/bin/1.0/publish-techniques.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | # Script for creating static version for the techniques documents 4 | # It starts from the published draft (in the main branch): 5 | # - https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/epub-metadata/ 6 | # - https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/onix-metadata/ 7 | # It generates the static version 8 | # It runs nuchecker and link checker 9 | # The output saved in the "live" directory UX-Guide-Metadata/techniques 10 | 11 | # input 12 | read -p 'Publishing date (format YYYY-MM-DD): ' publishDate 13 | techniques=( "epub" "onix" ) 14 | 15 | # pre-run: cleans and temporary directory... 16 | BASEDIR=$(dirname "$0") 17 | rm -rf $BASEDIR/../techniques 18 | mkdir $BASEDIR/../techniques 19 | 20 | # copies the content to the temporary directory 21 | printf "\nCopying the content to the temporary directory..." 22 | cp -a $BASEDIR/../draft/techniques/. $BASEDIR/../techniques/ 23 | 24 | ## Array Loop 25 | for technique in "${techniques[@]}" 26 | do 27 | printf "\n\nWorking on technique $technique..." 28 | 29 | # generates the static version 30 | printf "\nGenerating static version..." 31 | curl \ 32 | -G \ 33 | --data-urlencode "type=respec" \ 34 | --data-urlencode "url=https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/$technique-metadata/?specStatus=CG-FINAL&publishDate=$publishDate" \ 35 | https://labs.w3.org/spec-generator/ \ 36 | -o $BASEDIR/../techniques/$technique-metadata/index.html 37 | 38 | # generates the static version 39 | # generates the static version 40 | printf "\nReplacing URLs..." 41 | sed 's#\.\./\.\./#https://www.w3.org/publishing/a11y/UX-Guide-metadata/#g' $BASEDIR/../techniques/$technique-metadata/index.html > $BASEDIR/../techniques/$technique-metadata/index-mod.html 42 | sed 's#\.\./#https://www.w3.org/publishing/a11y/UX-Guide-metadata/techniques/#g' $BASEDIR/../techniques/$technique-metadata/index-mod.html > $BASEDIR/../techniques/$technique-metadata/index.html 43 | sed 's#\./#https://www.w3.org/publishing/a11y/UX-Guide-metadata/techniques/$technique-metadata/#g' $BASEDIR/../techniques/$technique-metadata/index.html > $BASEDIR/../techniques/$technique-metadata/index-mod.html 44 | mv $BASEDIR/../techniques/$technique-metadata/index-mod.html $BASEDIR/../techniques/$technique-metadata/index.html 45 | 46 | # runs nuchecker 47 | nuVersion=$(java -jar libs/vnu/vnu.jar --version) 48 | printf "\nRunning Nu Html Checker version $nuVersion..." 49 | java -jar libs/vnu/vnu.jar \ 50 | $BASEDIR/../techniques/$technique-metadata/index.html 51 | 52 | if [ $? -gt 0 ] 53 | then 54 | exit 1 55 | fi 56 | 57 | # runs link checker 58 | # installed via commands: 59 | # cpan install App::cpanminus 60 | # cpanm W3C::LinkChecker@4.81 61 | # cpan install Mozilla::CA 62 | # tried to install version 5.0.0 on mac, but I got errors 63 | checklinkVersion=$(checklink --version) 64 | printf "\nRunning $checklinkVersion..." 65 | checklink \ 66 | --summary \ 67 | --broken \ 68 | "https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/$technique-metadata/?specStatus=CG-FINAL&publishDate=$publishDate" 69 | 70 | if [ $? -gt 0 ] 71 | then 72 | exit 1 73 | fi 74 | 75 | done 76 | 77 | # copies the content to the temporary directory 78 | printf "\nFixing readme links..." 79 | sed 's#https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/#https://www.w3.org/publishing/a11y/UX-Guide-metadata/#g' $BASEDIR/../techniques/README.md > $BASEDIR/../techniques/README-mod.md 80 | mv $BASEDIR/../techniques/README-mod.md $BASEDIR/../techniques/README.md -------------------------------------------------------------------------------- /UX-Guide-Metadata/principles/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Redirecting to https://www.w3.org/publishing/a11y/UX-Guide-metadata/principles/ 5 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /UX-Guide-Metadata/techniques/README.md: -------------------------------------------------------------------------------- 1 | ## Display Techniques for Displaying Accessibility Metadata 2 | - [Display Techniques for EPUB Accessibility Metadata](https://www.w3.org/publishing/a11y/UX-Guide-metadata/techniques/epub-metadata/) 3 | - [Display Techniques for ONIX Accessibility Metadata](https://www.w3.org/publishing/a11y/UX-Guide-metadata/techniques/onix-metadata/) 4 | 5 | 6 | -------------------------------------------------------------------------------- /UX-Guide-Metadata/techniques/media/image1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/UX-Guide-Metadata/techniques/media/image1.png -------------------------------------------------------------------------------- /UX-Guide-Metadata/techniques/media/image2.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | Layer 1 5 | 6 | 7 | 8 | 9 | 10 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/README.md: -------------------------------------------------------------------------------- 1 | # Accessibility Metadata Display Guide for Digital Publications 2.0 2 | 3 | ## Latest published drafts 4 | 5 | * [Guidelines](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/guidelines/) 6 | * Techniques: 7 | * [Display Techniques for EPUB Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/techniques/epub-metadata/) 8 | * [Display Techniques for ONIX Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/techniques/onix-metadata/) 9 | 10 | 11 | ## Editor's drafts 12 | 13 | * [Guidelines](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/guidelines/) 14 | * Techniques: 15 | * [Display Techniques for EPUB Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/techniques/epub-metadata/) 16 | * [Display Techniques for ONIX Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/techniques/onix-metadata/) 17 | 18 | ## Experiments 19 | 20 | - [Accessibility metadata display processor](https://daisy.github.io/a11y-meta-viewer/) - processes a package document or onix record according to the algorithms in the techniques 21 | - [display localisations](https://rawcdn.githack.com/w3c/publ-a11y/main/a11y-meta-display-guide/2.0/draft/localizations/index.html) 22 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/README.md: -------------------------------------------------------------------------------- 1 | #Accessibility Metadata Display Guide for Digital Publications 2.0 2 | 3 | * [Current Editor's Draft - Guidelines](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/guidelines/) 4 | * [Current Editor's Draft - Techniques](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/techniques/): 5 | * [Display Techniques for EPUB Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/techniques/epub-metadata/) 6 | * [Display Techniques for ONIX Accessibility Metadata 2.0](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/techniques/onix-metadata/) 7 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/common/acknowledgements.html: -------------------------------------------------------------------------------- 1 |
2 |

Acknowledgements

3 | 4 |

The leadership and editing contributions of the following individuals were central to producing this guide:

5 | 6 | 16 | 17 |

The following members of the Publishing Community Group contributed to the development of this document:

18 | 19 | 31 |
32 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/common/js/add_ids.js: -------------------------------------------------------------------------------- 1 | 2 | function addStringIDs() { 3 | 4 | var id_elements = document.querySelectorAll('code[id]'); 5 | var code_array = [...id_elements]; 6 | 7 | code_array.forEach(code => { 8 | var id_span = document.createElement('span'); 9 | id_span.classList.add('str-id') 10 | id_span.appendChild(document.createTextNode('[ID: ' + code.id + ']')); 11 | code.insertAdjacentElement('afterEnd', id_span); 12 | }); 13 | } 14 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/guidelines/README.md: -------------------------------------------------------------------------------- 1 | # User Experience Guide for Displaying Accessibility Metadata 2.0 2 | [Current Editor's Draft](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.0/draft/guidelines/) 3 | 4 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/guidelines/media/MetadataProcessing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/a11y-meta-display-guide/2.0/draft/guidelines/media/MetadataProcessing.png -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/localizations/README.md: -------------------------------------------------------------------------------- 1 | # Localization folder for User Experience Guide for Displaying Accessibility Metadata 2.0 2 | 3 | ## Folder and file structure 4 | Each identical language and country is in a dedicated folder. 5 | 6 | Each file has the same first part display_guide_vocabulary_ and a variant suffix composed of the responsible organisation sort name (per example: w3c_) and the 4 letters language code (per example: en-US). 7 | 8 | ## FAQ 9 | This is a placeholder to provide answers to common questions that can be opened as localization new issue (neds a GitHub account) or sent directly to gautier.chomel@edrlab.org. 10 | 11 | 12 | 13 | 14 | 15 | 16 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/localizations/crosscheck strings epub-onix-canonical_json.xlsx: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/a11y-meta-display-guide/2.0/draft/localizations/crosscheck strings epub-onix-canonical_json.xlsx -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/localizations/en-US/display_guide_vocabulary_w3c_en-US.json: -------------------------------------------------------------------------------- 1 | { 2 | "metadata": { 3 | "author": "W3C Publishing Community Group Accessibility Task Force", 4 | "language": "en-US", 5 | "variant": "canonical", 6 | "version": "2.0.b", 7 | "audience": "general", 8 | "description": "Original wording discussed by a large group representing different actors of the English-speaking geographies. It has been improved after proof of concept implementations and panel testers" 9 | }, 10 | "ways-of-reading": { 11 | "ways-of-reading-title": "Ways of reading", 12 | "ways-of-reading-nonvisual-reading-alt-text": { 13 | "compact": "Has alternative text", 14 | "descriptive": "Has alternative text descriptions for images" 15 | }, 16 | "ways-of-reading-nonvisual-reading-no-metadata": { 17 | "compact": "No information about nonvisual reading is available", 18 | "descriptive": "No information about nonvisual reading is available" 19 | }, 20 | "ways-of-reading-nonvisual-reading-none": { 21 | "compact": "Not readable in read aloud or dynamic braille", 22 | "descriptive": "The content is not readable as read aloud speech or dynamic braille" 23 | }, 24 | "ways-of-reading-nonvisual-reading-not-fully": { 25 | "compact": "Not fully readable in read aloud or dynamic braille", 26 | "descriptive": "Not all of the content will be readable as read aloud speech or dynamic braille" 27 | }, 28 | "ways-of-reading-nonvisual-reading-readable": { 29 | "compact": "Readable in read aloud or dynamic braille", 30 | "descriptive": "All content can be read as read aloud speech or dynamic braille" 31 | }, 32 | "ways-of-reading-prerecorded-audio-complementary": { 33 | "compact": "Prerecorded audio clips", 34 | "descriptive": "Prerecorded audio clips are embedded in the content" 35 | }, 36 | "ways-of-reading-prerecorded-audio-no-metadata": { 37 | "compact": " No information about prerecorded audio is available", 38 | "descriptive": " No information about prerecorded audio is available" 39 | }, 40 | "ways-of-reading-prerecorded-audio-only": { 41 | "compact": "Prerecorded audio only", 42 | "descriptive": " Audiobook with no text alternative" 43 | }, 44 | "ways-of-reading-prerecorded-audio-synchronized": { 45 | "compact": "Prerecorded audio synchronized with text", 46 | "descriptive": "All the content is available as prerecorded audio synchronized with text" 47 | }, 48 | "ways-of-reading-visual-adjustments-modifiable": { 49 | "compact": "Appearance can be modified", 50 | "descriptive": " Appearance of the text and page layout can be modified according to the capabilities of the reading system (font family and font size, spaces between paragraphs, sentences, words, and letters, as well as color of background and text)" 51 | }, 52 | "ways-of-reading-visual-adjustments-unknown": { 53 | "compact": "No information about appearance modifiability is available", 54 | "descriptive": " No information about appearance modifiability is available" 55 | }, 56 | "ways-of-reading-visual-adjustments-unmodifiable": { 57 | "compact": "Appearance cannot be modified", 58 | "descriptive": "Text and page layout cannot be modified as the reading experience is close to a print version, but reading systems can still provide zooming options" 59 | } 60 | }, 61 | "conformance": { 62 | "conformance-title": "Conformance", 63 | "conformance-details-title": "Detailed conformance information", 64 | "conformance-a": { 65 | "compact": "This publication meets minimum accessibility standards", 66 | "descriptive": "The publication contains a conformance statement that it meets the EPUB Accessibility and WCAG 2 Level A standard" 67 | }, 68 | "conformance-aa": { 69 | "compact": "This publication meets accepted accessibility standards", 70 | "descriptive": "The publication contains a conformance statement that it meets the EPUB Accessibility and WCAG 2 Level AA standard" 71 | }, 72 | "conformance-aaa": { 73 | "compact": "This publication exceeds accepted accessibility standards", 74 | "descriptive": "The publication contains a conformance statement that it meets the EPUB Accessibility and WCAG 2 Level AAA standard" 75 | }, 76 | "conformance-certifier": { 77 | "compact": "The publication was certified by", 78 | "descriptive": "The publication was certified by " 79 | }, 80 | "conformance-certifier-credentials": { 81 | "compact": "The certifier's credential is ", 82 | "descriptive": "The certifier's credential is " 83 | }, 84 | "conformance-details-certification-info": { 85 | "compact": "The publication was certified on ", 86 | "descriptive": "The publication was certified on " 87 | }, 88 | "conformance-details-certifier-report": { 89 | "compact": "For more information refer to the certifier's report", 90 | "descriptive": "For more information refer to the certifier's report" 91 | }, 92 | "conformance-details-claim": { 93 | "compact": "This publication claims to meet", 94 | "descriptive": "This publication claims to meet" 95 | }, 96 | "conformance-details-epub-accessibility-1-0": { 97 | "compact": " EPUB Accessibility 1.0", 98 | "descriptive": " EPUB Accessibility 1.0" 99 | }, 100 | "conformance-details-epub-accessibility-1-1": { 101 | "compact": " EPUB Accessibility 1.1", 102 | "descriptive": " EPUB Accessibility 1.1" 103 | }, 104 | "conformance-details-level-a": { 105 | "compact": " Level A", 106 | "descriptive": " Level A" 107 | }, 108 | "conformance-details-level-aa": { 109 | "compact": " Level AA", 110 | "descriptive": " Level AA" 111 | }, 112 | "conformance-details-level-aaa": { 113 | "compact": " Level AAA", 114 | "descriptive": " Level AAA" 115 | }, 116 | "conformance-details-wcag-2-0": { 117 | "compact": " WCAG 2.0", 118 | "descriptive": " Web Content Accessibility Guidelines (WCAG) 2.0" 119 | }, 120 | "conformance-details-wcag-2-1": { 121 | "compact": " WCAG 2.1", 122 | "descriptive": " Web Content Accessibility Guidelines (WCAG) 2.1" 123 | }, 124 | "conformance-details-wcag-2-2": { 125 | "compact": " WCAG 2.2", 126 | "descriptive": " Web Content Accessibility Guidelines (WCAG) 2.2" 127 | }, 128 | "conformance-no": { 129 | "compact": "No information is available", 130 | "descriptive": "No information is available" 131 | }, 132 | "conformance-unknown-standard": { 133 | "compact": "Conformance to accepted standards for accessibility of this publication cannot be determined", 134 | "descriptive": "Conformance to accepted standards for accessibility of this publication cannot be determined" 135 | } 136 | }, 137 | "navigation": { 138 | "navigation-title": "Navigation", 139 | "navigation-index": { 140 | "compact": "Index", 141 | "descriptive": "Index with links to referenced entries" 142 | }, 143 | "navigation-no-metadata": { 144 | "compact": "No information is available", 145 | "descriptive": "No information is available" 146 | }, 147 | "navigation-page-navigation": { 148 | "compact": "Go to page", 149 | "descriptive": "Page list to go to pages from the print source version" 150 | }, 151 | "navigation-structural": { 152 | "compact": "Headings", 153 | "descriptive": "Elements such as headings, tables, etc for structured navigation" 154 | }, 155 | "navigation-toc": { 156 | "compact": "Table of contents", 157 | "descriptive": "Table of contents to all chapters of the text via links" 158 | } 159 | }, 160 | "rich-content": { 161 | "rich-content-title": "Rich content", 162 | "rich-content-accessible-chemistry-as-latex": { 163 | "compact": "Chemical formulas in LaTeX", 164 | "descriptive": "Chemical formulas in accessible format (LaTeX)" 165 | }, 166 | "rich-content-accessible-chemistry-as-mathml": { 167 | "compact": "Chemical formulas in MathML", 168 | "descriptive": "Chemical formulas in accessible format (MathML)" 169 | }, 170 | "rich-content-accessible-math-as-latex": { 171 | "compact": "Math as LaTeX", 172 | "descriptive": "Math formulas in accessible format (LaTeX)" 173 | }, 174 | "rich-content-accessible-math-as-mathml": { 175 | "compact": "Math as MathML", 176 | "descriptive": "Math formulas in accessible format (MathML)" 177 | }, 178 | "rich-content-accessible-math-described": { 179 | "compact": "Text descriptions of math are provided", 180 | "descriptive": "Text descriptions of math are provided" 181 | }, 182 | "rich-content-closed-captions": { 183 | "compact": " Videos have closed captions", 184 | "descriptive": " Videos included in publications have closed captions" 185 | }, 186 | "rich-content-extended": { 187 | "compact": "Information-rich images are described by extended descriptions", 188 | "descriptive": "Information-rich images are described by extended descriptions" 189 | }, 190 | "rich-content-open-captions": { 191 | "compact": " Videos have open captions", 192 | "descriptive": " Videos included in publications have open captions" 193 | }, 194 | "rich-content-transcript": { 195 | "compact": "Transcript(s) provided", 196 | "descriptive": "Transcript(s) provided" 197 | }, 198 | "rich-content-unknown": { 199 | "compact": "No information is available", 200 | "descriptive": "No information is available" 201 | } 202 | }, 203 | "hazards": { 204 | "hazards-title": "Hazards", 205 | "hazards-flashing": { 206 | "compact": "Flashing content", 207 | "descriptive": "The publication contains flashing content which can cause photosensitive seizures" 208 | }, 209 | "hazards-motion": { 210 | "compact": "Motion simulation", 211 | "descriptive": "The publication contains motion simulations that can cause motion sickness" 212 | }, 213 | "hazards-no-metadata": { 214 | "compact": "No information is available", 215 | "descriptive": "No information is available" 216 | }, 217 | "hazards-none": { 218 | "compact": "No hazards", 219 | "descriptive": "The publication contains no hazards" 220 | }, 221 | "hazards-sound": { 222 | "compact": "Sounds", 223 | "descriptive": "The publication contains sounds which can be uncomfortable" 224 | }, 225 | "hazards-unknown": { 226 | "compact": "The presence of hazards is unknown", 227 | "descriptive": "The presents of hazards is unknown" 228 | } 229 | }, 230 | "accessibility-summary": { 231 | "accessibility-summary-title": "Accessibility summary", 232 | "accessibility-summary-no-metadata": { 233 | "compact": "No information is available", 234 | "descriptive": "No information is available" 235 | } 236 | }, 237 | "legal-considerations": { 238 | "legal-considerations-title": "Legal considerations", 239 | "legal-considerations-exempt": { 240 | "compact": "Claims an accessibility exemption in some jurisdictions", 241 | "descriptive": "This publication claims an accessibility exemption in some jurisdictions" 242 | }, 243 | "legal-considerations-no-metadata": { 244 | "compact": "No information is available", 245 | "descriptive": "No information is available" 246 | } 247 | }, 248 | "additional-accessibility-information": { 249 | "additional-accessibility-information-title": "Additional accessibility information", 250 | "additional-accessibility-information-aria": { 251 | "compact": "ARIA roles included", 252 | "descriptive": "Content is enhanced with ARIA roles to optimize organization and facilitate navigation" 253 | }, 254 | "additional-accessibility-information-audio-descriptions": { 255 | "compact": "Audio descriptions", 256 | "descriptive": "Audio descriptions" 257 | }, 258 | "additional-accessibility-information-braille": { 259 | "compact": "Braille", 260 | "descriptive": "Braille" 261 | }, 262 | "additional-accessibility-information-color-not-sole-means-of-conveying-information": { 263 | "compact": "Color is not the sole means of conveying information", 264 | "descriptive": "Color is not the sole means of conveying information" 265 | }, 266 | "additional-accessibility-information-dyslexia-readability": { 267 | "compact": "Dyslexia readability", 268 | "descriptive": "Dyslexia readability" 269 | }, 270 | "additional-accessibility-information-full-ruby-annotations": { 271 | "compact": "Full ruby annotations", 272 | "descriptive": "Full ruby annotations" 273 | }, 274 | "additional-accessibility-information-high-contrast-between-foreground-and-background-audio": { 275 | "compact": "High contrast between foreground and background audio", 276 | "descriptive": "High contrast between foreground and background audio" 277 | }, 278 | "additional-accessibility-information-high-contrast-between-text-and-background": { 279 | "compact": "High contrast between foreground text and background", 280 | "descriptive": "High contrast between foreground text and background" 281 | }, 282 | "additional-accessibility-information-large-print": { 283 | "compact": "Large print", 284 | "descriptive": "Large print" 285 | }, 286 | "additional-accessibility-information-page-breaks": { 287 | "compact": "Page breaks included", 288 | "descriptive": "Page breaks included from the original print source" 289 | }, 290 | "additional-accessibility-information-ruby-annotations": { 291 | "compact": "Some Ruby annotations", 292 | "descriptive": "Some Ruby annotations" 293 | }, 294 | "additional-accessibility-information-sign-language": { 295 | "compact": "Sign language", 296 | "descriptive": "Sign language" 297 | }, 298 | "additional-accessibility-information-tactile-graphics": { 299 | "compact": "Tactile graphics included", 300 | "descriptive": "Tactile graphics have been integrated to facilitate access to visual elements for blind people" 301 | }, 302 | "additional-accessibility-information-tactile-objects": { 303 | "compact": "Tactile 3D objects", 304 | "descriptive": "Tactile 3D objects" 305 | }, 306 | "additional-accessibility-information-text-to-speech-hinting": { 307 | "compact": "Text-to-speech hinting provided", 308 | "descriptive": "Text-to-speech hinting provided" 309 | }, 310 | "additional-accessibility-information-ultra-high-contrast-between-text-and-background": { 311 | "compact": "Ultra high contrast between text and background", 312 | "descriptive": "Ultra high contrast between text and background" 313 | }, 314 | "additional-accessibility-information-visible-page-numbering": { 315 | "compact": "Visible page numbering ", 316 | "descriptive": "Visible page numbering " 317 | }, 318 | "additional-accessibility-information-without-background-sounds": { 319 | "compact": "Without background sounds", 320 | "descriptive": "Without background sounds" 321 | } 322 | } 323 | } 324 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/localizations/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | Display guide localization strings visualiser 6 | 7 | 55 | 127 | 128 | 129 |
130 |

How to use this page

131 |

132 | This page is part of the Accessibility Metadata Display Guide for Digital Publications 2.0 and complementary with the each of the techniques documents. 133 |

134 |

135 | The guidelines document provides details about Localization, localization strategy, how to contribute and how to choose localization files. 136 |

137 |

This page includes a selector that affects the content being presented.

138 |
139 |
140 |

Localization string selector

141 |

142 | The selector allows to choose a string that will be displayed in the following sections, changing the content and language of them. 143 |

144 | 149 |
150 |
151 | 152 | 153 | 154 | 339 | 340 | 341 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/draft/techniques/README.md: -------------------------------------------------------------------------------- 1 | # Display Techniques for Displaying Accessibility Metadata 2.0 2 | - [Editor's Draft for Display Techniques for EPUB Accessibility Metadata](https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/epub-metadata/) 3 | - [Editor's Draft for Display Techniques for ONIX Accessibility Metadata](https://w3c.github.io/publ-a11y/UX-Guide-Metadata/draft/techniques/onix-metadata/) 4 | 5 | 6 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/guidelines/media/MetadataEcosystem.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/a11y-meta-display-guide/2.0/guidelines/media/MetadataEcosystem.jpg -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/guidelines/media/MetadataProcessing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/a11y-meta-display-guide/2.0/guidelines/media/MetadataProcessing.png -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.0/implementations/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | Accessibility Metadata Display Guide for Digital Publications 2.0 — Implementation Report 6 | 7 | 8 | 9 | 10 |

This page has moved to ../../implementations/

11 | 12 | 13 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/README.md: -------------------------------------------------------------------------------- 1 | # Accessibility Metadata Display Guide for Digital Publications 2.1 2 | 3 | ## Latest published drafts 4 | 5 | No drafts have been published yet. 6 | 7 | 8 | ## Editor's drafts 9 | 10 | * [Guidelines](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/) 11 | * Techniques: 12 | * [Display Techniques for EPUB Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/) 13 | * [Display Techniques for ONIX Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/) 14 | 15 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/README.md: -------------------------------------------------------------------------------- 1 | #Accessibility Metadata Display Guide for Digital Publications 2.1 2 | 3 | * [Current Editor's Draft - Guidelines](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/) 4 | * [Display Techniques for EPUB Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/) 5 | * [Display Techniques for ONIX Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/) 6 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/common/acknowledgements.html: -------------------------------------------------------------------------------- 1 |
2 |

Acknowledgements

3 | 4 |

The leadership and editing contributions of the following individuals were central to producing this guide:

5 | 6 | 16 | 17 |

The following members of the Publishing Community Group contributed to the development of this document:

18 | 19 | 31 |
32 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/common/js/add_ids.js: -------------------------------------------------------------------------------- 1 | 2 | function addStringIDs() { 3 | 4 | var id_elements = document.querySelectorAll('code[id]'); 5 | var code_array = [...id_elements]; 6 | 7 | code_array.forEach(code => { 8 | var id_span = document.createElement('span'); 9 | id_span.classList.add('str-id') 10 | id_span.appendChild(document.createTextNode('[ID: ' + code.id + ']')); 11 | code.insertAdjacentElement('afterEnd', id_span); 12 | }); 13 | } 14 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/guidelines/README.md: -------------------------------------------------------------------------------- 1 | # User Experience Guide for Displaying Accessibility Metadata 2.1 2 | [Current Editor's Draft](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/) 3 | 4 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/guidelines/media/MetadataProcessing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/w3c/publ-a11y/5ee2f5ccbadb4c36fc8bfb3a8dee7ecd43170bf9/a11y-meta-display-guide/2.1/draft/guidelines/media/MetadataProcessing.png -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/localizations/README.md: -------------------------------------------------------------------------------- 1 | # Localization folder for User Experience Guide for Displaying Accessibility Metadata 2.1 2 | 3 | ## Folder and file structure 4 | Each identical language and country is in a dedicated folder. 5 | 6 | Each file has the same first part display_guide_vocabulary_ and a variant suffix composed of the responsible organisation sort name (per example: w3c_) and the 4 letters language code (per example: en-US). 7 | 8 | ## FAQ 9 | This is a placeholder to provide answers to common questions that can be opened as localization new issue (neds a GitHub account) or sent directly to gautier.chomel@edrlab.org. 10 | 11 | 12 | 13 | 14 | 15 | 16 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/localizations/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | Display guide localization strings visualiser 6 | 7 | 55 | 127 | 128 | 129 |
130 |

How to use this page

131 |

132 | This page is part of the Accessibility Metadata Display Guide for Digital Publications 2.1 and complementary with the each of the techniques documents. 133 |

134 |

135 | The guidelines document provides details about Localization, localization strategy, how to contribute and how to choose localization files. 136 |

137 |

This page includes a selector that affects the content being presented.

138 |
139 |
140 |

Localization string selector

141 |

142 | The selector allows to choose a string that will be displayed in the following sections, changing the content and language of them. 143 |

144 | 149 |
150 |
151 | 152 | 153 | 154 | 339 | 340 | 341 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/2.1/draft/techniques/README.md: -------------------------------------------------------------------------------- 1 | # Display Techniques for Accessibility Metadata 2.1 2 | * [Display Techniques for EPUB Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/) 3 | * [Display Techniques for ONIX Accessibility Metadata 2.1](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/) 4 | 5 | 6 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/README.md: -------------------------------------------------------------------------------- 1 | # Publishing scripts 2 | 3 | These bash scripts were developed to simplify the document publishing process. 4 | 5 | ## Requirements 6 | 7 | On mac you have to install `checklink` (I've tried to install version 5.0.0 on mac, but I got errors). These terminal commands should work: 8 | 9 | ``` 10 | sudo cpan install App::cpanminus 11 | sudo cpanm W3C::LinkChecker@4.81 12 | sudo cpan install Mozilla::CA 13 | ``` 14 | 15 | ## publish-guidelines.sh 16 | 17 | Script for creating static version for the guidelines document. It starts from the published draft (in the main branch): [https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/guidelines/) 18 | 19 | It generates the static version, it runs nuchecker and link checker. 20 | 21 | The output is a zip folder that can be sent to W3C staff for publishing on the website. 22 | 23 | ## publish-techniques.sh 24 | 25 | Script for creating static version for the techniques documents. It starts from the published draft (in the main branch): 26 | 27 | - [https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/epub-metadata/) 28 | - [https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/](https://w3c.github.io/publ-a11y/a11y-meta-display-guide/2.1/draft/techniques/onix-metadata/) 29 | 30 | It generates the static versions, it runs nuchecker and link checker. 31 | 32 | The output saved in the "live" directory `a11y-meta-display-guide/2.1/techniques`. -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/canonical-json-extract-ids.xsl: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | ways-of-reading 12 | conformance 13 | navigation 14 | rich-content 15 | hazards 16 | accessibility-summary 17 | legal-considerations 18 | additional-accessibility-information 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/canonical-json-extract-strings.xsl: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | W3C Publishing Community Group Accessibility Task Force 17 | en-US 18 | canonical 19 | 20 | general 21 | Original wording discussed by a large group representing different actors of the English-speaking geographies. It has been improved after proof of concept implementations and panel testers 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/extract-ids-from-guidelines.xsl: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/extract-ids-from-techniques.xsl: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | -------------------------------------------------------------------------------- /a11y-meta-display-guide/bin/libs/vnu/CHANGELOG.md: -------------------------------------------------------------------------------- 1 | With a few exceptions, this is a record of mainly just user-facing 2 | changes — that is, either changes to the actual behavior of the checker, 3 | or changes to any options/interfaces the checker exposes for developers. 4 | 5 | # 20.6.30 6 | 30 June 2020 7 | - CLI: Add new `--stdout` option, to report all messages to stdout 8 | - CLI: Ensure the `--version` option reports the actual version 9 | - CLI: Actually check SVG files, rather than just seeming to (bug fix) 10 | - CSS: Improvements in `calc()`, `min()`/`max()` checking, more 11 | - Allow `height` and `width` attributes for SVG `symbol` element 12 | - Allow `capture` attribute for the `input[type=file]` element 13 | - Allow `disabled` attribute for the `link[rel=stylesheet]` element 14 | - Treat custom elements as labelable elements for `label[for]` handling 15 | - ARIA: Fix bug that disallowed implicit combobox/listbox for `select` 16 | - ARIA: Improve error message for `alt`-less `img` with ARIA attributes 17 | - ARIA: Allow `section[role=doc-glossary]` 18 | 19 | # 20.3.16 20 | 16 March 2020 21 | - Disallow `accept-charset` values other than `UTF-8` 22 | - Disallow object[typemustmatch] 23 | - Allow SVG feDropShadow element (from Filter Effects spec) 24 | - Allow `loading` attribute for the `img` element (lazy loading) 25 | - Allow `rel=modulepreload` for the `link` element 26 | - Allow `integrity` attribute on link[rel=preload|modulepreload] 27 | - Allow `integrity` attribute on script[type=module] 28 | - Allow `autofocus` as a global attribute 29 | - Allow `inputmode` as a global attribute 30 | - Allow `nonce` as a global attribute 31 | - Allow `allow-downloads` in iframe[sandbox] 32 | - Allow heading content within `legend` element 33 | - Allow negated media features in `media` and `sizes` attributes 34 | - Align `autocomplete` checking with current spec 35 | - CSS: Improve support for color values 36 | - ARIA: Allow implicit roles to satisfy owned-by requirements 37 | - ARIA: Add proper ARIA checking for the `math` element 38 | - ARIA: Align all role checking with current HTML-ARIA spec 39 | - Add option to specify additional script for Web-based checker 40 | - CLI: Make --errors-only option take precedence over --Werror 41 | - CLI: Enable checking standard input as SVG or CSS 42 | - Include binary runtime images in release (alternative to jar/war) 43 | - Dockerfile: Switch to using binary runtime image rather than jar 44 | - Add checker.py script to repo (for building/testing/running checker) 45 | - Add option to bind to specific IP address (rather than all interfaces) 46 | 47 | # 18.11.5 48 | 05 November 2018 49 | - Fix bugs that can cause the command-line checker to emit broken JSON output 50 | - Allow `dppx` and `x` and units in media queries 51 | 52 | # 18.8.29 53 | 29 August 2018 54 | - CSS: Allow unit-less values for stroke-width and other from-SVG props 55 | - CSS: Bring checking up to date w/ CSS Align3; support font-display 56 | 57 | # 18.7.23 58 | 23 July 2018 59 | - Disable logging in the language detector 60 | 61 | # 18.7.22 62 | 22 July 2018 63 | - Allow the `decoding` attribute for the `img` element 64 | - Allow the `allow` attribute for the `iframe` element (initial support) 65 | - Align ARIA checking further with ARIA in HTML spec requirements 66 | - Restore the language-detection feature to vnu.jar command-line checker 67 | - Ensure vnu.jar is always runnable under Java8, even if built under Java9 68 | 69 | # 18.3.0 70 | 24 March 2018 71 | - Add new major (optional) feature to command-line checker, Web-based checker, 72 | and network API to check CSS documents (in addition to HTML documents) 73 | - Add new major feature to check that `style` element contents and `style` 74 | attribute values in HTML documents are valid CSS 75 | - Add new (optional) feature to command-line checker to check SVG documents 76 | - Add new option to command-line checker for specifying User-Agent string 77 | - Add Dockerfile to Docker Hub https://hub.docker.com/r/validator/validator/ 78 | - Add ability to Web-based checker to check SVG documents by file upload 79 | - Emit error (not warning) for HTML4/XHTML1 strict doctypes 80 | - Further restrict `script[type]` and `style[type]` 81 | - Allow the `autocapitalize` global attribute 82 | - Allow the `slot` attribute (for Shadow DOM interaction) 83 | - Allow the `allowpaymentrequest` attribute for the `iframe` element 84 | - Allow only one non-hidden `main` element per document 85 | - Allow only `html`, `body`, `div`, `form`, custom elements as `main` ancestor 86 | - Allow `` end tag to be omitted 87 | - Allow `role=none` where `role=presentation` is allowed 88 | - Allow `role=rowgroup` element to be contained in `role=table` element 89 | - Allow `role=row` element to be contained in `role=table` element 90 | - Allow more values for `aria-haspopup` per current ARIA spec 91 | - Allow more ARIA states & properties for `role=menuitem` 92 | - Allow CSP `prefetch-src` directive (updated to Salvation 2.4.0) 93 | - Disallow all character encodings other than UTF-8 94 | - Disallow `script[charset]` 95 | - Disallow nested interactive ARIA roles 96 | - Disallow the `dropzone` attribute 97 | - Disallow the `menuitem` element 98 | - Fix bug that caused the checker to incorrectly treat `input[type]` values 99 | case-sensitively when doing particular checks 100 | 101 | # 17.11.1 102 | 07 October 2017 103 | - Fix bug that made the vnu.jar `--Werror` option not work as expected 104 | - Make vnu.jar exit 0 if all errors have been filtered out 105 | 106 | # 17.11.0 107 | 06 October 2017 108 | - Allow DPUB roles on more elements (per ARIA in HTML spec updates) 109 | - Add `--Werror` option to the vnu.jar command-line checker. The option 110 | causes the checker to exit non-zero if any warnings are encountered 111 | (even if there are no errors). 112 | - Fix mismatch that caused message-filtering failures 113 | - Fix memory leak in language detector (patch from @tgyurci) 114 | - Stop reporting HTML4-specific parse errors for HTML4-doctype docs 115 | 116 | # 17.9.0 117 | 20 August 2017 118 | - Allow `script[nomodule]` 119 | - Allow `hover`, `any-hover`, `pointer`, and `any-pointer` media features 120 | - Allow `@scope`, `@updateviacache`, `@workertype` for `link[rel=serviceworker]` 121 | - Allow `&;` (don’t report it as “`&` did not start a character reference”) 122 | - Add `acceptlanguage` query parameter, to specify an Accept-Language 123 | request-header value for checker to send when fetching remote documents 124 | - Update CSP checking to Salvation 2.3.0 125 | https://github.com/shapesecurity/salvation/releases/tag/v2.3.0 126 | 127 | # 17.7.0 128 | 26 June 2017 129 | - Add new major feature to filter out (drop/ignore/suppress) errors/warnings 130 | by regex. See https://github.com/validator/validator/wiki/Message-filtering 131 | - Replace a case of “Attribute "foo" not allowed on element "param" **in this 132 | context**” wording in error message with “Attribute "foo" not allowed on 133 | element "param" **at this point**” (for consistent working for that error 134 | between the command-line checker and the web-based checker). 135 | - Disallow the `contextmenu` attribute and `type=contextmenu` and `type=toolbar` 136 | for the `menu` element. 137 | - Allow `link[rel=serviceworker]` 138 | - Allow floating-point numbers in attribute values to start with decimal point 139 | - Allow `a[href]` in SVG wherever `a[xlink:href]` is allowed 140 | - Allow the `focusable` and `tabindex` attributes on SVG elements 141 | - Fix bug that disallowed `progress` & `meter` as `label[for]` targets 142 | - Default to text/html for checking file uploads 143 | - Emit warnings for use of `rel={copyright,previous}` 144 | - Prevent Bulgarian ➡ Russian misidentifications in language detector 145 | - Skip figcaption elements when running the language detector 146 | 147 | # 17.3.0 148 | 26 March 2017 149 | - Allow `color` attribute with `link[rel="mask-icon"]` 150 | - Allow `meta[name]` to have `itemref`/`itemscope`/`itemtype`/`itemid` 151 | - Allow `allow-top-navigation-by-user-activation` in `iframe[sandbox]` 152 | - Stop hiding “sectioning roots” headings in “Heading-level outline” 153 | - Change error for `role=none` with `img[alt=""]` to warning 154 | - Fix from @xfq for longstanding bug in “Show source” behavior in Web UI 155 | - Fix from @xfq for controlling some runtime params for HTTP behavior 156 | - Fix from @zcorpan to drop unneeded warning for `` 157 | - Make “Corrupt GZIP trailer” a non-error 158 | - Add `--asciiquotes` option to vnu.jar command-line checker 159 | - Skip lang detection of elements w/ lang attributes not matching `html[lang]` 160 | - Drop Bulgarian lang detection, to prevent Russian misidentification 161 | - Update Estonian/Catalan lang profiles, to prevent Russian misidentification 162 | - Update ICU4J to 58.2 163 | 164 | # 17.2.1 165 | 06 February 2017 166 | - Fix bug in language detector that when running the vnu.jar command-line 167 | checker on a list of documents caused it to sometimes misidentify the 168 | language of the 2nd, 3rd, 4th, etc., documents. The bug also caused the 169 | memory used by the checker to increase as the number of documents 170 | checked at the same time increased, and caused performance to degrade. 171 | - Allow `aria-required` attribute everywhere `required` attribute is allowed 172 | - Add `--exit-zero-always` option to vnu.jar command-line checker 173 | - Fix longstanding bug around code for identifying overlapping cells in 174 | table-integrity checker (the bug somewhat frequently gets hit when checking 175 | Wikipedia pages but otherwise in the wild gets hit only extremely rarely) 176 | 177 | # 17.2.0 178 | 30 January 2017 179 | - Fix bug that broke vnu.jar command-line checking of URLs 180 | - Fix bug in `rel="shortcut icon"` checking 181 | - Add `nu.client.EmbeddedValidator` for use as library by other Java apps 182 | - Disallow `tfoot` before `tbody` 183 | 184 | # 17.1.0 185 | 15 January 2017 186 | This release adds the following changes to the vnu.jar command-line 187 | checker that had already been made available in the Web-based checker in 188 | the 17.0.1 release. 189 | - Allow **custom elements** (names containing “-”; e.g., ``) 190 | - Allow anything in `template` element subtrees (exclude from checking) 191 | 192 | # 17.0.1 193 | 08 January 2017 194 | - New language-detection feature; warns for missing/wrong `html[lang]` 195 | - New option `--no-langdetect` for `vnu.jar` disables language detection 196 | - Allow **custom elements** (names containing “-”; e.g., ``) 197 | - Allow the `is` attribute (for custom elements) 198 | - Allow **ARIA 1.1** roles/states/properties 199 | - Warn for viewport values that restrict resizing 200 | - Allow `div` in `dl`, to group `dt`+`dd` sets 201 | - Allow anything in `template` element subtrees (exclude from checking) 202 | - Allow `link[rel=preload]` in body 203 | - Disallow `sizes` attribute on non-icon `link` 204 | - Allow `` 205 | - Allow comments before doctype (warning dropped) 206 | - Allow `