Skip to content

Commit d6661c1

Browse files
JJdeGrootJJdeGroot
committed
Improve Markdown formatting and improve CSS
1 parent bf7c589 commit d6661c1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

61 files changed

+399
-175
lines changed

‎.github/workflows/deploy.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ jobs:
3232
3333
# Install Netlify
3434
- name: Install Netlify
35-
run: npm install netlify-cli -g
35+
run: npm install netlify-cli --save-dev
3636

3737
# Run Node.js script
3838
- name: Run matf.js script
@@ -44,7 +44,7 @@ jobs:
4444
uses: stefanzweifel/git-auto-commit-action@v5
4545
with:
4646
commit_message: Add generated index.html
47-
47+
4848
# Upload artifacts
4949
- name: Upload Artifacts
5050
uses: actions/upload-artifact@v3

‎README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,3 +3,7 @@
33
This repository will be used to work on new resources.
44

55
The newest draft can be found at: [matfdraft.netlify.app](https://matfdraft.netlify.app/)
6+
7+
Upon push to the `main` branch, the `index.html` gets generated based on the `.md` files in the `wcag` folder.
8+
9+
You can manually generate `index.html` by running `node matf.js`

‎index.html‎

Lines changed: 166 additions & 76 deletions
Large diffs are not rendered by default.

‎matf.css‎

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
:root {
22
--background-color: #fff;
3+
--background-secondary-color: #eee;
34
--text-color: #000;
45
--link-color: #00f;
56
}
67
@media (prefers-color-scheme: dark) {
78
:root {
89
--background-color: #111;
10+
--background-secondary-color: #333;
911
--text-color: #eee;
1012
--link-color: #aaf;
1113
}
1214
}
1315
body {
1416
font-family: sans-serif;
17+
font-size: max(16px, 1rem);
1518
margin: 1em;
1619
padding: 0;
1720
background-color: var(--background-color);
1821
color: var(--text-color);
19-
}
20-
21-
a {
22-
color: var(--link-color);
22+
line-height: 2;
2323
}
2424

2525
h1, h2, h3, h4, h5, h6 {
@@ -28,11 +28,25 @@ h1, h2, h3, h4, h5, h6 {
2828
margin: 1em 0 0 0;
2929
}
3030

31+
a {
32+
color: var(--link-color);
33+
}
34+
35+
p {
36+
margin: 0 0 1em 0;
37+
}
38+
39+
blockquote {
40+
margin: 0;
41+
padding-left: 1em;
42+
border-left: 0.5em solid var(--background-secondary-color);
43+
}
44+
3145
section {
3246
margin: 2.5em 0;
3347
}
3448

3549
.container {
36-
max-width: 70em;
50+
max-width: 60em;
3751
margin: 0 auto;
3852
}

‎matf.js‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,10 @@ const readFiles = async (folder, extension) => {
2828

2929
// Execute
3030
readFiles('wcag', '.md').then(async map => {
31-
console.log(`File map: ${map}`);
31+
console.log('File map:', map);
3232

3333
const keys = Array.from(map.keys()).sort(semver.compare);
34-
console.log(`Sorted keys: ${keys}`);
34+
console.log('Sorted keys', keys);
3535

3636
let files = [];
3737
for (const key of keys) {

‎wcag/1.1.1.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1-
# Success Criterion 1.1.1 - Non-text Content - Level A
1+
## Success Criterion 1.1.1 Non-text Content
2+
3+
(Level A)
24

35
Placeholder

‎wcag/1.2.1.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
# Success Criterion 1.2.1 Audio-only and Video-only (Prerecorded) - Level A
1+
## Success Criterion 1.2.1 Audio-only and Video-only (Prerecorded)
2+
3+
(Level A)
24

35
This applies directly as written, and as described in [Intent from Understanding Success Criterion 1.2.1](https://www.w3.org/WAI/WCAG22/Understanding/audio-only-and-video-only-prerecorded#intent).
46

5-
## NOTE
6-
The alternative can be provided directly in the **[screen or view]** – or provided in an alternate version that meets the success criteria.
7+
> ### NOTE 1
8+
> The alternative can be provided directly in the **[screen or view]** – or provided in an alternate version that meets the success criteria.

‎wcag/1.2.2.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
# Success Criterion 1.2.2 - Captions (Prerecorded) - Level A
1+
## Success Criterion 1.2.2 - Captions (Prerecorded)
2+
3+
(Level A)
24

35
This applies directly as written, and as described in [Intent from Understanding Success Criterion 1.2.2](https://www.w3.org/WAI/WCAG22/Understanding/captions-prerecorded#intent).
46

5-
## NOTE
6-
The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “in some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.
7+
> ### NOTE 1
8+
> The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “in some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.

‎wcag/1.2.3.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
1-
# Success Criterion 1.2.3 - Audio Description or Media Alternative (Prerecorded) - Level A
1+
## Success Criterion 1.2.3 - Audio Description or Media Alternative (Prerecorded)
2+
3+
(Level A)
24

35
This applies directly as written, and as described in [Intent from Understanding Success Criterion 1.2.3](https://www.w3.org/WAI/WCAG22/Understanding/audio-description-or-media-alternative-prerecorded#intent).
46

5-
## NOTE 1
6-
The WCAG 2 definition of “[audio description](https://www.w3.org/TR/WCAG22/#dfn-audio-descriptions)” says that “audio description” is “also called ‘video description’ and ‘descriptive narration’”.
7+
> ### NOTE 1
8+
> The WCAG 2 definition of “[audio description](https://www.w3.org/TR/WCAG22/#dfn-audio-descriptions)” says that “audio description” is “also called ‘video description’ and ‘descriptive narration’”.
79
8-
## NOTE 2
9-
Secondary or alternate audio tracks are commonly used for this purpose.
10+
> ### NOTE 2
11+
> Secondary or alternate audio tracks are commonly used for this purpose.

‎wcag/1.2.4.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
1-
# Success Criterion 1.2.4 - Captions (Live) - Level AA
1+
## Success Criterion 1.2.4 - Captions (Live)
2+
3+
(Level AA)
24

35
This applies directly as written, and as described in [Intent from Understanding Success Criterion 1.2.4](https://www.w3.org/WAI/WCAG22/Understanding/captions-live#intent).
46

5-
## NOTE
6-
The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “In some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.>This applies directly as written, and as described in [Intent from Understanding Success Criterion 1.2.4](https://www.w3.org/WAI/WCAG22/Understanding/captions-live#intent).
7+
> ### NOTE 1
8+
> The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “In some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.
79
8-
## NOTE
9-
The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “In some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.
10+
> ### NOTE 2
11+
> The WCAG 2 definition of “[captions](https://www.w3.org/TR/WCAG22/#dfn-captions)” notes that “In some countries, captions are called subtitles”. They are also sometimes referred to as “subtitles for the hearing impaired.” Per the definition in WCAG 2, to meet this success criterion, whether called captions or subtitles, they would have to provide “synchronized visual and / or text alternative for both speech and non-speech audio information needed to understand the media [content](https://www.w3.org/TR/wcag2ict-22/#content-on-and-off-the-web)” where non-speech information includes “sound effects, music, laughter, speaker identification and location”.

0 commit comments

Comments
 (0)