Skip to content

GermanCentralLibraryForTheBlind/bacc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BACC

License: MIT

Digital equality for all users has an important role in our society. That means people with print disabilities need the same access to information, especially books, like other users. So it is necessary to consider accessibility issues right at the beginning of production of digital content. This paradigma is called “born accessible”. if content is “born digital,” it can-and should-be “born accessible.” BACC tries to help achieving this digital equality.

Today digital books are produced in EPUB 3. The BACC-tool will assist the eBook-EPUB3 production with focus on Accessibility requirements. It can check accessibility requirements automatically (not all) and so guarantee a base accessibility conformance.

Who should use BACC?

TODO

Live

http://bacc.dzb.de

Video DEMO

Technical details

TODO

Backend

BACC runs Ace by DAISY for programmatic EPUB accessibility reporting.

Frontend

Angular CLI version 1.2.6.

Setup

Requirements

BACC requires Node.js 7+ to run.

TODO

Install backend on Linux Ubuntu server

TODO : move to server.md

TODO: create bacc Docker

Prepare server

  • Node.js

    # Using Ubuntu
    curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
    sudo apt-get install -y nodejs
    
  • nginx

    sudo apt update
    sudo apt install nginx
    

    Backup! and replace with bacc\nginx\... configs todo:via script

    $ sudo nano /etc/nginx/sites-available/default 
    $ sudo nano /etc/nginx/nginx.conf
    $ sudo service restart nginx
    
  • yarn

    Note: Ubuntu 17.04 comes with cmdtest installed by default. If you’re getting errors from installing yarn, you may want to run sudo apt remove cmdtest first. Refer to this for more information.

    $ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
    $ echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
    $ sudo apt-get update && sudo apt-get install yarn
    
  • Chrome setup

    $ sudo apt-get update && sudo apt-get install libx11-xcb1 libxss1 libasound2 libxkbfile1
    

CHANGELOG

1.1.0

  • Fixed some accessibility pitfalls in the user interface, make more screenreader friendly
  • Added more useful hints

1.0.0

  • First official version 🎉

0.8.0

  • Added rules called hints that need some additional manual checking

0.7.0

  • Added meta data view, which signals if recommended meta data isnt set

0.6.0

  • Save actually checked reports to local disk

0.5.0

  • Localise violation (rule/check) descriptions - provides german localisation

0.4.0

  • BACC support screenreader users

0.4.0

  • BACC support screenreader users

0.3.0

  • Display the list of rules that used for the audit
  • Display information about BACC itself and user infractions in a separate info modal

0.2.0

  • Localisation labeling:
    • Frontend
    • Report

0.1.0

  • Audit EPUB

    • Upload EPUB via Drag and Drop
    • Start Audit automatically
    • Show state of audit
  • Report

    • Tab violations:
      • Display violation grouped via type of violation
      • Display details to every violation group
    • Tab outlines:
      • Display outline side by side viewer
    • Tab image descriptions:
      • Display images with attributes

0.0.0

  • Initial commit