Add optimization when updating a SW registration results in the exact same script
[WebKit-https.git] / LayoutTests / imported / mathml-in-html5 / README.md
1 # Tests for the MathML in HTML5 implementation note
2
3 This repository contains tests for the
4 [MathML in HTML5 implementation note](http://www.mathml-association.org/MathMLinHTML5/).
5 We follow the formats and conventions of
6 [W3C's Test the Web Forward Project](http://testthewebforward.org/),
7 please read their documentation for details. The main goals are:
8 - helping implementers to verify conformance with the technical description
9   given in the MathML in HTML5 note.
10 - provide a set of automatable tests to integrate into the testing framework of
11   web browser developers.
12
13 ## Installation
14
15 You must at least install [git](http://git-scm.com/) and
16 [python](http://python.org/). Clone the repository with
17
18     $ git clone --recursive https://github.com/username/MathMLinHTML5-tests.git
19
20 If you cloned the repository without --recursive, you will likely have empty
21 `resources` and `tools` directories at the root of your cloned repo. You can
22 clone the submodules with these additional steps:
23
24     $ cd MathMLinHTML5-tests
25     $ git submodule update --init --recursive
26
27 Next, generate the MANIFEST.json file with the following command:
28
29     $ python tools/manifest/update.py
30
31 To verify the tests in your browser, you also need to setup a web server whose
32 root points to the root of the cloned repo. For a quick setup, you can just run
33 the `serve.py` Python script at the root:
34
35     $ python server.py
36
37 Finally, open `index.html` at the web server root to get an overview of all the
38 tests. Using W3C's wptserve has not been tried but the tests can easily be
39 imported into other automated testing framework anyway.
40
41 ## Note on Web fonts
42
43 Many of the tests verify OpenType features and require specific Web fonts for
44 that purpose. WOFF fonts are generated using the Python API of
45 [fontforge](https://github.com/fontforge/fontforge/). A recent enough version
46 of FontForge is necessary so that it includes fixes for [WOFF checkSumAdjustment](https://github.com/fontforge/fontforge/issues/926), [USE_TYPO_METRICS flag](https://github.com/fontforge/fontforge/pull/2274) and various bugs in OpenType
47 MATH.