(This tool is no longer in active development)

Web Accessibility Toolbar

This repo contains the Web Accessibility Toolbar (WAT) including an Inno Setup file for creating a "setup.exe"-style installer.

There's reference documentation that explains what you can do with the toolbar and includes keyboard shortcuts.

Currently this repo does not contain the source for the toolbar DLL, but this is only the "shell" for the code; you can change virtually anything by editing the scripts and then building the setup program with Inno Setup.

Editable Files

These are the files that you can edit to modify the WAT.

Accessibility_Toolbar.xml

This is an xml file which creates the menu's and menu items in the WAT UI. You can add/remove/modify the UI via this file. The text labels for the UI controls are provided via variable (res_id) references to the Translation.ini

For example: The WAT > Structure > headings feature is represented as this in the XML file:

<item resid="head1_struc" image="-1" />

Translation.ini

Contains all the text strings provided in the UI and the functions. Also includes mappings to invoke the scripts and inbuilt features via the UI.

Scripts directory

The majority of the WAT functionality is powered by JS or WS files. (WS just being a windows scripting host version -- but written in JS). You can think of the features as bookmarklets, as this is how most of them started life. You can modify an exsiting feature by changing its corresponding script file.

For example: The WAT > Structure > headings is powered by Headings.js, so you hack on that script to change the behaviour of the feature.

Icons directory

Icons can be added to menus/menu buttons/menu items.

For example: The Structure menu button (from the XML file Accessibility_Toolbar.xml)

<button type="button" resid="Structure" accesskey="6" image="structure.bmp">

Building

You must have Inno Setup installed to build a setup.exe-style installer.

You can build an installer for 32-bit machines, or one for 64-bit machines (which also includes the 32-bit binaries, so you can use IE in 32- or 64-bit mode). There are two ways to do this.

• Easy: Double-click on build32.bat or build64.bat. This will open a command prompt window in which the installer build progress will be displayed. When the build is complete, you can press any key to close the window.

  Note for network folder users: Windows doesn't get on well with launching batch files from network folders (as cmd.exe doesn't support UNC paths), so you can either explore the folder via a mapped drive, or open a command prompt window in the network folder and type the name of the batch file.

• 1337: Open Web-Accessibility-Toolbar.iss; the comments in the file explain how to make a build (you only need to change one line of the file).

Development Info

Please use tabs for indentation (we recommend a tabstop of four).

Before committing, please remember to build and test, and consider incrementing the version number (it's in wat/Translation.ini under the "Version" key and currently it is the release date, but it needn't be).

The file wat/Translation.ini is in UTF-16, which Git can't cope with. However, you can use an external diff tool, such as vimdiff (or mvimdiff if you have MacVim).

• To use vimdiff:

  git config --global diff.tool vimdiff
  

• To use mvimdiff takes a little extra work:

  git config --global diff.tool gvimdiff
  git config --global difftool.gvimdiff.path `which mvimdiff`
  

The use of --global changes the setting in your home directory, rather than just the current repository; if you only want to change this setting for the WAT repository, drop the --global part.

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.