维基百科:格式手冊/無障礙
格式手冊 |
---|
灰字链接非正式指引,僅供參考 |
此條目可参照英語維基百科相應條目来扩充。 |
Web无障碍致力使網頁更易瀏覽與閱讀。雖然這主要旨在幫助身心障礙者,但亦能可以幫助所有讀者。我們旨在遵循WCAG標準2.0(即ISO/IEC 40500:2012),並以此提出以下建議。遵守這些內容會使條目更易閱讀與編輯。
2006年1月14日,维基媒体基金会理事会提议了以下反歧视政策:“维基媒体基金会禁止基于种族、肤色、性别、宗教、民族血统、年龄、残疾、性取向或任何其他受法律保护的特征而歧视现有或未来的用户和雇员。维基媒体基金会承诺遵守机会平等的原则,特别是在雇员关系的所有方面,包括就业、工资管理、雇员发展、晋升和调动”
,並断称,“维基媒体基金会的官员或工作人员或任何维基媒体项目的地方政策不得规避、侵蚀或忽视”
此政策。
條目結構
規範條目結構可讓用戶從頁面特定部分獲得期望內容,增加親和力;如果有盲人在搜索消歧義連結,沒有從頁面頂部搜索到任何內容,就可知道此處什麼也沒有,不必費時繼續閱讀下去。 期望內容是在頁面的特定部分。
規範是維基百科已形成的習慣,只需簡單遵循指引Wikipedia:版面指南和Wikipedia:格式手冊/序言章節#導言文字。
章節標題
章節標題應該是具體描述,且順序一致(參見—參考文獻—擴展閱讀—外部連結)。
章節標題應該嵌套遞進,以二級(==
)起頭,接下來是三級(===
)等(不應該用自動生成的一級標題),請勿隨機使用章節標題層級(比如選擇加重,這不是標題的目的),也不要跳級。
請不要使用加粗或分號語法的偽章節標題。螢幕閱讀器等機器只能使用正確格式的章節標題。如欲縮減目錄長度,請使用{{TOC limit}}。
正確 | 隨機/亂序 | 跳級 | 偽章節標題 |
---|---|---|---|
[這是條目序言] |
[這是條目序言] |
[這是條目序言] |
[這是條目序言] |
請勿濫用行首半形分號和粗體來「偽裝」標題,行首半形分號是定義列表專用。讀屏器和其他輔助工具僅能使用有章節標記(半形等號)的標題來導航定位。如欲縮小目錄,請用{{TOC limit}}。在{{TOC limit}}因為條目其他地方有低層級標題而無用的情況,才可妥協用粗體,但要先將子子子標題用粗體取代,因為這對讀屏器使用者構成的滋擾最少。必先窮盡其他解決方案,才可以使用偽標題。此為罕見情況。
可接受 | 錯誤 |
---|---|
[條目首段] |
[條目首段] |
浮動元素
在維基代碼中,浮動元素應置於所屬章節之內。比如,雖然維基語法中圖像置於頁面頂部,但可能被其它浮動元素推到目錄下方顯示。圖像也應插入其所屬的章節之內。(視乎所用平台,若將多張圖片「堆疊」在很少文字的旁邊,則可能會使某圖片被推擠到後面的章節。然而,此並非親和力問題,因為讀屏器總會在圖片源代碼的位置,將其alt=
讀出。)
解析度
維基百科條目應便於使用小螢幕設備,或低解析度顯示器的讀者訪問。我們將1024×768視作對其他使用者無可能不利影響的最低解析度;條目在該解析度下應無不必要的水平捲軸。這個問題有時會在螢幕兩邊同時出現多張圖像時出現;將圖像移至一側,即使這樣垂直捲軸會加長——注意不要同時在屏幕兩側加入圖像等浮動元素。大表格和圖像也會產生問題;有時無法避免水平捲軸的出現,但可設法調整表格,讓它朝垂直而非水平方向發展。
文字
刪除線
請勿在條目頁面及導航模板中用刪除線劃去任何文字。如有需要,请用「<!--」和「-->」注釋處理,或直接移除。大多數螢幕閱讀器默认不呈現文本屬性(粗體、斜體、下劃線)乃至語義文本屬性(強調、重要、文字刪除),帶刪除線的文字和正常文字阅读效果相同。然而,带刪除線的文字在維基百科內部討論中非常常見,建議在參與維基百科的方針和存废討論時,編輯啟用顯示文本属性。
如果条目有显然错误的内容,应该用注释处理,或者直接移除,不要使用删除线;也可用行内清理模板标记,并在讨论页提出意见。
符號
此章节需要編修,以確保本地化(字符集、音译要求)使用恰当。 |
不支援Unicode的螢幕閱讀器會將非Latin-1和Windows-1252的字元显示问号,即使對於最普及的螢幕閱讀器JAWS中,Unicode字元依然非常難以閱讀。
- 在名稱、地點、事物等原文相當重要的地方,如果原文使用的既非漢字也不是拉丁書寫系統文字,則請始終給出转写,即羅馬化。此功能在表示非罗马字语言的模板中可用,也可以在诸如{{transl}}}等模板中找到;这些模板还具有可访问性等其它优点(请参阅下文的“外语”章节)。
- 請勿使用♥(心形符號)等無法發音的符號;請以注有替代文本(
|alt=
)的圖像(如 )代之[1]。 - 對於在螢幕閱讀器上產生問題的符號,可能已經有了生成圖像和替代文字的模板。比如{{†}}。(有关更多信息,请参见Category:圖像插入模板)
字符序列必须足以传达文本的语义方面(最好是其他类似形式的内容); 不可使用只能使用CSS属性或Wiki标记语言区分的自定义“特殊符号”。
請勿使用需要交互來提供資訊的技術,比如工具提示(tooltip)或其他「懸停」文字。縮寫屬於例外,因此可以使用{{abbr}}模板來縮寫很長的術語。
不要在句中插入換行符(<br>
),會讓螢幕閱讀器難以編輯。句子后面允许插入单独的换行符,可能对某些编者有帮助。
字体大小
謹慎使用縮小和放大字体。字型大小通常是由頁面元素自動決定,如標題、列表標題、標準模板。改變字型大小時,應當用原字型的百分比大小(相對大小)描述,而不用像素或點數描述絕對大小,以便利預設使用較大字體的使用者。
避免在資訊框、導航模板和參考章節等已經為小字體元素的地方再次使用缩小字體。所以,<small>...</small>
標籤,及{{small}}
、{{smaller}}
等模板,不應用於該些頁面元素的純文字。無論何時都不應該使用比85%(或11像素)還小的字體。注意HTML的<small>...</small>
標籤還有小字條款的含義,不用作字體風格變化。
外語
非中文單詞或短語應以使用ISO 639語言代碼的{{lang}}包圍,比如:{{lang|fr|Assemblée nationale}}
,会显示为:
Assemblée nationale
或{{lang-fr|Assemblée nationale}}
,会显示为:
法語:Assemblée nationale
使用理由:{{lang}}
可以使語音合成器以正確的語言發音[2]。在中文維基百科中,對於日語如不使用模板,則日本漢字可能會被視作中文錯誤簡繁轉換。其它見Template:Lang/doc#使用理由的完整理由。
連結
- 建立好的連結描述,外部連結尤甚。(避免「點此!」「見此處」)[3][4]
- 不要用Unicode字元當圖符;以使用替代文字描述的圖符檔案代之。比如「→」等字元可能無法在螢幕閱讀器上重現為有效文字,讀者看到的可能是問號。
顏色
颜色最常见于维基百科条目的模板和表格。欲查看可用的颜色,请见颜色列表,关于如何使用颜色的技术帮助,请见Help:使用颜色。
条目中的颜色应用须牢记亲和力,如下:
- 确保颜色并非唯一传达重要信息的方式。特别的,请不要使用上色文字或背景,除非其状态还用指示另一事物,比如亲和性符号对应图例,或脚注标签。另外失明用户或读者通过打印物或非彩色装置或获得维基百科时,将无法获得此类信息。
- 对于我们的读者,链接应该如链接一样清晰可识别。
- 维基百科有读者为部分或全色盲。确保文字和背景的对比达到WCAG 2.0的AA等级,如可能则达到AAA等级。可以选择这些工具检查对比度是否正确:
- 色彩对比分析器使您能够挑选在页面上的颜色,并充分检查其对比度。但请务必只使用最新的“亮度”算法,而非过时的“色彩亮度/差”。
- 你还可以选择完全更新的斯努克的色彩对比工具。
- The Wikimedia Foundation Design team has provided a color palette with colors being marked towards level AA conformance. It is used for all user-interface elements across products and in the main Wikimedia themes, desktop and mobile. However, it does not consider linked text.
- The table at Wikipedia:格式手冊/無障礙/色彩表 shows the results for 14 hues of finding the darkest or lightest backgrounds that are AAA-compliant against black text, white text, linked text and visited linked text.
- Google's Chrome Canary has a color contrast debugger with visual guide and color-picker.
- 网上还有其它工具,但请在使用前检查它们是否更新。一些工具以WCAG 1.0算法为基础,而我们应该参考现今的WCAG 2.0算法。如果工具没有提到其基于WCAG 2.0,则假设它过时。
- {{Color contrast ratio}}
- 此外还有工具可以协助制作图形图表,或是地图等的配色方案。这些工具对于对比度亲和力检查并不严格,但其可以在特定任务上有帮助作用。
- 配色方案生成器(Paletton)可以协助在图表中选择好的颜色搭配。
- 色彩酿造师2.0提供了地图的安全配色方案和详细讲解。
- Light qualitative colour scheme provides a set of 9 colours that work for color blind users and with black text labels (among other palettes).
- There are some tools for simulating color-blind vision: toptal (webpage analysis) and coblis (local file analysis). There are also browser extensions for webpage analysis: Colorblinding (Chrome) NoCoffee (Chrome) NoCoffee (Firefox)
- A very simple open-source tool that can be helpful for choosing contrasting colours is Color Oracle, a "free color blindness simulator for Windows, Mac and Linux". It lets you view whatever is on your screen as it would be seen by someone with one of three types of colourblindness or in greyscale.
- 如果条目过度使用颜色,但你不知道如何亲自修复,则可请其他编辑协助。请将{{Overcolored}}放置于条目顶部。
块元素
列表
不要在列表项间用空行或表格列分断,即使是定义列表(以分号和冒号打头形成的列表)和無序列表。列表是用来把项目组合起来的,但分断会让MediaWiki理解为结束再新起列表。拆散分组会让屏幕阅读器读者误解与困惑,因为阅读器也会跟着播报多个列表。不当的格式还会让阅读列表消耗三倍以上的时间。
同樣,請勿列表之中,切換行首符號(分號、星號、井號)。回覆時,若對方行首混合用分號與星號(甚至井號),則需要先複製該串符號,後另加一個符號,以正確縮進。開新話題,則取消縮進即可(等同開一個新的HTML表)。
例如,在討論區,請遵循以下 最佳做法:
* 支持。我喜歡此想法。—User:Example
** 疑問:你為何喜歡?—User:Example2
*** 似乎合乎維基百科的精神。—User:Example
或 用無圓點的縮進:
: 支持。我喜歡此想法。—User:Example
:: 疑問:你為何喜歡?—User:Example2
::: 似乎合乎維基百科的精神。—User:Example
在回覆中隱藏圓點,也可以接受:
* 支持。我喜歡此想法。—User:Example
*: 疑問:你為何喜歡?—User:Example2
*:: 似乎合乎維基百科的精神。—User:Example
但 請勿將表格類型由點列表變成定義列表:
* 支持。我喜歡此想法。—User:Example
:: 疑問:你為何喜歡?—User:Example2
也 請勿用以下方法(同樣將表格類型由點列表變成定義列表):
* 支持。我喜歡此想法。—User:Example
:* 疑問:你為何喜歡?—User:Example2
亦 請勿在列表項之間隔空行:
* 支持。我喜歡此想法。—User:Example
** 疑問:你為何喜歡?—User:Example2
以及 請勿越級:
* 支持。我喜歡此想法。—User:Example
*** 疑問:你為何喜歡?—User:Example2
以下做法 不鼓勵:
: 支持。我喜歡此想法。—User:Example
:* 疑問:你為何喜歡?—User:Example2
因為加入的圓點,令列表變得更複雜,且令讀屏器較難跟上討論,因為可能將多出的圓點視為全新嵌套列表的開始。
Multiple paragraphs within list items
Normal MediaWiki list markup is unfortunately incompatible with normal MediaWiki paragraph markup. To put multiple paragraphs in a list item, separate them with {{pb}}
:
* This is one item.{{pb}}This is another paragraph within this item.
* This is another item.
Do not use line breaks to simulate paragraphs, because they have different semantics:
* This is one item.<br>This is the same paragraph, with a line break before it.
* This is another item.
Definitely do not attempt to use a colon to match the indentation level, since (as mentioned above) it produces three separate lists:
* This is one item. : This is an entirely separate list. * This is a third list.
Alternatively, you can use one of the HTML list templates to guarantee grouping. This is most useful for including block elements, such as formatted code, in lists:
{{bulleted list |1=This is one item: <pre> This is some code. </pre> This is still the same item. |2=This is a second item. }}
缩进
An accessible approach to indentation is the template {{block indent}}
for multi-line content; it uses CSS to indent the material. For single lines, a variety of templates exist, including {{in5}}
(a universal template, with the same name on all Wikimedia sites); these indent with various whitespace characters. Do not abuse the <blockquote>...</blockquote>
element or templates that use it (such as {{Quote}}
) for visual indentation; they are only for directly quoted material.
以英文冒号起头的行会缩进。比如这种用法会在讨论页的往来讨论中表示回复。该缩进用了HTML的定义列表。这在可亲和性和语义学都并不理想,但目前却广泛应用。缩进行之间不应插入空行,因为这表示列表的结束并开启新列表。如果确实需要空行,请插入一个以同样数量冒号起头的额外行。
A colon (:
) at the start of a line marks that line in the MediaWiki parser as the <dd>...</dd>
part of an HTML description list (<dl>...</dl>
).[a] The visual effect in most Web browsers is to indent the line. This is used, for example, to indicate replies in a threaded discussion on talk pages. However, this markup alone is missing the required <dt>
(term) element of a description list, to which the <dd>
(description/definition) pertains. As can be seen by inspecting the code sent to the browser, this results in broken HTML (i.e. it fails validation[5]). The result is that assistive technology, such as screen readers, will announce a description list that does not exist, which is confusing for any visitor unused to Wikipedia's broken markup. This is not ideal for accessibility, semantics, or reuse, but is currently commonly used, despite the problems it causes for users of screen readers.
Blank lines must not be placed between colon-indented lines of text – especially in article content. This is interpreted by the software as marking the end of a list and the start of a new one. If a blank line is needed, place the same number of colons on it as those preceding the text below the blank line, for instance:
: Text here. : : More text.
Another solution is new-paragraph markup, but it must be in one unbroken line in the wiki code:
- Text here.<p>More text.</p>
For more information on the weaknesses of colon-based description list markup – even for actual description lists –