blob: 89b744c8de4a69767a17cbff62375e95fad6ffdd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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
|
# FiveUI
FiveUI is an extensible tool for evaluating HTML user interfaces
against sets of codified UI Guidelines.
## Installation and getting started
FiveUI is a basic browser extension with support for Firefox and
Google Chrome. If you're familiar with browser extensions, you can
quickly install FiveUI from the binaries:
- Chrome: [fiveui.crx](http://galoisinc.github.com/FiveUI/binaries/fiveui.crx)
- FireFox: [fiveui.xpi](http://galoisinc.github.com/FiveUI/binaries/fiveui.xpi)
The [Installation Guide](doc/manual_src/install.md) describes the
installation process for Firefox and Google Chrome.
After you've installed FiveUI, take a look at the [Getting Started
Guide](doc/manual_src/gettingStarted.md) to learn about Rule Sets and
setting URL Patterns to match web sites to codified guidelines.
## Building FiveUI
Most (if not all) the FiveUI dependencies are included in the
repository, so building FiveUI should be as simple as running:
$ make
In the top-level FiveUI repository root. On success, this will put
the generated extensions in the `contexts` directory.
### Chrome signing key
Note that you will need to first place a Chrome key in:
contexts\chrome\fiveui.pem
before the chrome extension will build successfully.
## Running the tests
The testing target relies on:
- a virtual framebuffer (xvfb)
- Mozilla Firefox
- Google Chrome
- a recent Java runtime.
- Apache Maven
If those are installed, then you should be able to run the test target
from the top-level repository root as well:
$ make test
If that fails to work on your system, then please let us know so we
can make the testing process more robust.
# Repository layout
This is the repository for the FiveUI project.
```
binaries : A directory holding the latest extension binaries
build : Helper scripts for building and packaging FiveUI
tools : Third-party build tools
contexts : Implementation details for supported contexts (Firefox, Chrome, etc.)
testrunner : Browser-automation tests and testing infrastructure
profiles : Sample user profiles for web browsers. Used for testing.
exampleData : Sample web pages and rule sets for testing.
doc : FiveUI Documentation
ruleSets : A growing collection of codified Guidelines
```
|