Template:Version/doc
 | 此頁面是Template:Version的Template文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
使用方法
[编辑]该模板以一种标准化的格式呈现版本历史（版本）数据表格。
维基百科上的许多文章都使用不同颜色的表格来说明软件的版本或发布历史。该模板是由德国维基百科加入的模板，在那里它被用作彩色编码历史（版本）数据表格的当前标准。
这个模板在编辑 Wiki表格使用, 可以利用 快捷代码. 将图例添加到表中, 作为浮动的或非浮动的容器. 颜色可以给色盲或弱视的读者可见,这个模板在必要时使用替代信息来提高可访问性, 举个例子 使用“title”属性。 (可以查看 Wiki辅助工具)
当你在创建历史（版本）数据表格时, 要注意的是，内容也少也好，可读性也高: Wiki 不收集无意义的时间. 只有重要或重要的历史（版本）应该在维基百科中被记录下来. 可以查看 设计风格 进一步的了解。
简单的例子
[编辑]| 版本 | 年份 | 简介 |
|---|---|---|
| 1.0 | 2010 | 旧版本 |
| 1.8 | 2011 | 旧版本，仍被支援 |
| 2.0 RC | 2012 | 最新的预览版 |
| 2.0 | 2012 | 当前版本 |
| 3.0 | 2017 | 未来版本 |
格式： 舊版本 舊版本，仍被支援 当前版本 最新的预览版 未来版本 | ||
注意事项
[编辑]- 已经停止支持的版本(没有后续版本)
- 不支持也不开发的产品, 每个版本都有“旧版本，不支持”的描述。 由于版本阶段之间没有区别，因此使用该模板将缺乏任何意义。这样可以使用一句简单的话来描述，或者在信息框中使用
|discontinued=yes是最好的。
- 只有一个稳定支持版本(没有更早期版本)
- 当没有支持的以前的版本、预览版本或未来的版本，整个表将由最后一个绿色的红色版本组成。 在这种情况下，不建议使用此模板。
参数
[编辑]| 参数(Parameter) | 描述(Description) | 注释(Notes) | ||||||
|---|---|---|---|---|---|---|---|---|
1
|
数据类型(Data type) | 在这个指定的模板生成的内容的类型。以下每一项都表示这个内容的类型，且会改变内容的背景颜色。可以使用的代码包括有：
下面的任意一个该模板生成一个颜色图例（可以参见一下的例子）。可以使用的代码包括有：
可以查看以下简单的实例 | ||||||
2
|
文本(Text) | 在适当的地方显示文字，通常是特定版本的版本号或代号名称。当第一个未声明的参数（数据类型）默认被设置为有效的任 "o", "co", "c", "cp" or "p". | ||||||
show
|
图例选择(Legend options) | 在模板中指定的内容自动生成图例。当第一个未声明的参数（数据类型）默认被设置为有效的数据类型 "l", "lv", "t" or "tv"。 被设置的参数为 "l" 或者 "lv"如果此时拥有六项数据数据时，或者当数据类型为 "t" 或者 "tv"且拥有五项数据时. 可以适当的使用 "1" (展开显示该内容) 或使用 "0" (隐藏该内容的显示).
以下是当数据类型设置为“l”或“lv”，从左到右的： 格式：
舊版本 舊版本，仍被支援 当前版本 最新预览版本 未来版本
以下是当数据类型设置为“t”或“tv”中，从左到右的：
顶部单元格（标题/“图例”）无法隐藏。 | ||||||
style
|
CSS 代码 | 此参数是可选的。 可以使用CSS语句修改模板的格式、样式和布局。 使用此参数可以插入到表格单元格中，方便在单元格中强制执行CSS定义。 CSS语句与图例组合，指定的CSS可以适用于整个块。 | ||||||
sortKey
|
选项制表(Optional sorting key) | 此参数设置为"o", "co", "c", "cp" and "p" 才有效。 sortkey是用于更改某个表格单元格排序方式的较麻烦字符串。 例如，通常, 短语“ACME's Bow”用以A开头的短语排序。 将“Bow”的排序键加入到短语中，可以用“B”开头的其他短语（或者更精确地用“Bow”）对该短语进行排序。
有关排序表的一般信息, 请参阅 Help:Tables. |
常用的形式
[编辑]图例
[编辑]{{Version|l}}{{Version|lv}}
{{Version|t}}{{Version|tv}}
设置各个版本的显示
{{Version|l}}{{Version|lv}}
{{Version|t}}{{Version|tv}}
版本阶段
[编辑]{{Version|o}}{{Version|co}}{{Version|c}}{{Version|cp}}{{Version|p}}
图例
[编辑]| 此描述 | 输入的 | 这样的 | |||||
|---|---|---|---|---|---|---|---|
| 水平图例 | {{Version |l |show=010111}}
|
舊版本 当前版本 最新的预览版 未来版本 | |||||
| 垂直图例 | {{Version |lv |show=011101}}
|
舊版本 本文为測試文字。这段文字用于说明格式，请勿删除。這段文字用於說明格式，請勿刪除。海納百川，有容乃大。維基百科，自由的百科全書。
舊版本，仍被支援 当前版本 未来版本 | |||||
| 水平图例（适用于表格） | {{Version |t |show=111001}}
|
| |||||
| 垂直图例（适用于表格） | {{Version |tv |show=101111}}
|
|
参照颜色
[编辑]| 此描述 | 输入的 | 这样的 |
|---|---|---|
| 旧版本，但已经不支持了 | {{Version |o |1.0}}
|
1.0 |
| 旧版本，现在还被支持 | {{Version |co |2.0}}
|
2.0 |
| 现在的稳定版本 | {{Version |c |3.0}}
|
3.0 |
| 预览版（不久会发布） | {{Version |cp |4.0}}
|
4.0 |
| 未来版本（不一定会发布） | {{Version |p |5.0}}
|
5.0 |
正确的排序
[编辑]这个模板使用了softKey。 如果 版本 是一个可排序的, 这个 sortkey 默认会设置版本为参数值. 如果你需要不同的排序, 就需要添加 sortKey 可以看看下面的例子:
| 输入是这样 | 显示是这样 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
{| class="wikitable sortable"
|-
! Version !! Date !! Description
|-
| {{Version |o |1.0 |sortKey=1.0}}
| 2010-07-23 || Old version, unsupported
|-
| {{Version |co |2.0 |sortKey=2.0}}
| 2011-06-27 || Old version, still supported
|-
| {{Version |cp |3.0 DP |sortKey=3.0 A}}
| 2012-03-02 || Developer's preview
|-
| {{Version |cp |3.0 CP |sortKey=3.0 B}}
| 2012-04-01 || Consumers Preview
|-
| {{Version |cp |3.0 RC |sortKey=3.0 C}}
| 2012-05-25 || Release candidate
|-
| {{Version |c |3.0 |sortKey=3.0 Z}}
| 2012-06-23 || Release to web
|-
| {{Version |p |4.0 |sortKey=4.0}}
| 2013-13-13 || Future version
|} |
|
看看其他的
[编辑]- Template:Table cell templates – 有关于这一系列的表格