Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

UniWiki:Manual of Style/Accessibility: Difference between revisions

From EVE University Wiki
Djavin novienta (talk | contribs)
Created page with "{{UMoS guideline}} Web accessibility is the goal of making web pages easier to navigate and read. While this is primarily intended to assist t..."
 
Djavin novienta (talk | contribs)
Line 8: Line 8:
The guidelines to follow are [[UniWiki:Manual of Style/Layout]] and [[UniWiki:Manual of Style/Lead section#Elements of the lead]].
The guidelines to follow are [[UniWiki:Manual of Style/Layout]] and [[UniWiki:Manual of Style/Lead section#Elements of the lead]].


=== Headings ===
== Headings ==
{{Shortcut|WP:BADHEAD|WP:GOODHEAD}}


Headings should be descriptive and in a consistent order (See also—References—Further reading—External links).
Headings should be descriptive and in a consistent order.


Headings should be nested sequentially, starting with level 2 (<code>==</code>), then level 3 (<code>===</code>) and so on (level 1 is not used, as this is the auto-generated page title)Do not skip parts of the sequence, such as selecting levels for emphasis; this is not the purpose of headings.
Headings should be nested sequentially, starting with level 1 (<code>=</code>) or level 2 (<code>==</code>), then level 3 (<code>===</code>) and so on.  Avoid skipping parts of the sequence, such as selecting levels for emphasis; this is not the purpose of headings. The exception to this guideline is when multiple level 2 heading in sequence would unnecessarily break up the page, such as the presence of several short sections in a row.


{| class="wikitable"
Do not make pseudo-headings using semicolon markup and try to avoid using bold markup. Screen readers and other machines can only use correctly formatted headings for navigation.
|+ style="padding-top: 10px;" | Heading use (and misuse) examples
|-
! scope="col" style="background: PaleGreen;" | Correct
! scope="col" style="background: Pink;" | Random/chaotic
! scope="col" style="background: Pink;" | Skipping levels
|- style="vertical-align: top;"
| style="width: 33%;" |
<poem>
''&#91;Article lead here&#93;''
<code>==Section==</code> ''&#91;level 2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code>==Section==</code> ''&#91;2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code>====Sub-sub-section====</code> ''&#91;4&#93;''
<code>==Section==</code> ''&#91;2&#93;''</poem>
| style="width: 33%;" |
<poem>
''&#91;Article lead here&#93;''
<code>====Section'''?'''====</code> ''&#91;4&#93;''
<code>===Section'''?'''===</code> ''&#91;3&#93;''
<code>==Section'''?'''==</code> ''&#91;2&#93;''
<code>==Section'''?'''==</code> ''&#91;2&#93;''
<code>====Section'''?'''====</code> ''&#91;4&#93;''
<code>===Section'''?'''===</code> ''&#91;3&#93;''</poem>
| style="width: 33%;" |
<poem>
''&#91;Article lead here&#93;''
''&#91;Level-2 section missing here&#93;''
<code>===Section'''?'''===</code> ''&#91;3&#93;''
<code>==Section==</code> ''&#91;2&#93;''
''&#91;Level-3 sub-section missing here&#93;''
<code>====Sub-section'''?'''====</code> ''&#91;4&#93;''
<code>==Section==</code> ''&#91;2&#93;''</poem>
|}
 
{{Shortcut|WP:PSEUDOHEAD}}
{{anchor|Pseudo-headings}}
Do not make pseudo-headings using semicolon markup and try to avoid using bold markup. Screen readers and other machines can only use correctly formatted headings for navigation. If you want to reduce the size of the table of contents (TOC), use {{t|TOC limit}} instead. In cases where {{t|TOC limit}} cannot be used because of lower-level headings elsewhere in the article, then using bold for the headings causes the least annoyance for screen reader users.
 
{| class="wikitable"
|+ style="padding-top: 10px;" | Heading use (and misuse) examples
|-
! scope="col" style="background: PaleGreen;" | Correct pseudo-headings
! scope="col" style="background: Pink;" | Incorrect pseudo-headings
|- style="vertical-align: top;"
| style="width: 50%;" |
<poem>
''&#91;Article lead here&#93;''
<code>==Section==</code> ''&#91;level 2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code><nowiki>'''Pseudo-heading'''</nowiki></code>
<code>==Section==</code> ''&#91;2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code>====Sub-sub-section====</code> ''&#91;2&#93;''
</poem>
| style="width: 50%;" |
<poem>
''&#91;Article lead here&#93;''
<code>==Section==</code> ''&#91;level 2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code><nowiki>;Pseudo-heading</nowiki></code>
<code>==Section==</code> ''&#91;2&#93;''
<code>===Sub-section===</code> ''&#91;3&#93;''
<code><nowiki><small>==Sub-sub-section==</small></nowiki></code> ''&#91;3&#93;''</poem>
|}


=== Floating elements ===
=== Floating elements ===