Template:Version/doc

维基百科,自由的百科全书
跳转到导航 跳转到搜索

使用方法[编辑]

该模板以一种标准化的格式呈现版本历史(版本)数据表格。

维基百科上的许多文章都使用不同颜色的表格来说明软件的版本或发布历史。该模板是由德国维基百科加入的模板,在那里它被用作彩色编码历史(版本)数据表格的当前标准。

这个模板在编辑 Wiki表格使用, 可以利用 快捷代码. 将图例添加到表中, 作为浮动的或非浮动的容器. 颜色可以给色盲或弱视的读者可见,这个模板在必要时使用替代信息来提高可访问性, 举个例子 使用“title”属性。 (可以查看 Wiki辅助工具)

当你在创建历史(版本)数据表格时, 要注意的是,内容也少也好,可读性也高: Wiki 不收集无意义的时间. 只有重要或重要的历史(版本)应该在维基百科中被记录下来. 可以查看 设计风格 进一步的了解。

简单的例子[编辑]

版本 年份 简介
停止支援: 1.4 2023 不再接收更新的舊版本
支援中: 2.2 2025 仍會收到更新的舊版本
最新版本: 3.1 2026 最新的穩定版本
最新預覽: 3.2 RC 2026 最新预览版
未來版本: 4.0 2027 未来版本,不一定會發布
從未發布: 4.0a 不適用 已確認不會發布
格式:
停止支援
支援中
最新版本
最新預覽
未來版本
從未發布

注意事项[编辑]

已经停止支持的版本(没有后续版本)
不支持也不开发的产品, 每个版本都有“旧版本,不支持”的描述。 由于版本阶段之间没有区别,因此使用该模板将缺乏任何意义。这样可以使用一句简单的话来描述,或者在信息框中使用 |discontinued=yes 是最好的。
只有一个稳定支持版本(没有更早期版本)
当没有支持的以前的版本、预览版本或未来的版本,整个表将由最后一个绿色的红色版本组成。 在这种情况下,不建议使用此模板。

参数[编辑]

参数(Parameter) 描述(Description) 注释(Notes)
1 数据类型(Data type) 在这个指定的模板生成的内容的类型。以下每一项都表示这个内容的类型,且会改变内容的背景颜色。可以使用的代码包括有:
o: 旧版本,不支持 (Denotes old version, unsupported)
co: 旧版本,仍然支持 (Denotes old version, still supported)
c: 最新穩定版本 (Denotes latest stable version)
cp: 最新預覽|(不久会发布) (Denotes preview version)
p: 未来版本|(不一定发布) (Denotes planned future version)
n: 從未發布|(不发布) (Never released version)

下面的任意一个该模板生成一个颜色图例(可以参见一下的例子)。可以使用的代码包括有:

l: 水平图例(Horizontal legend)
lv: 垂直图例(Vertical legend)
t: 水平图例 适用于表格(Horizontal legend, as a table)
tv: 垂直图例 适用于表格(Vertical legend, as a table)

可以查看以下简单的实例

2 文本(Text) 在适当的地方显示文字,通常是特定版本的版本号或代号名称。当第一个未声明的参数(数据类型)默认被设置为有效的ococcppn.
show 图例选择(Legend options) 在模板中指定的内容自动生成图例。当第一个未声明的参数(数据类型)默认被设置为有效的数据类型 "l", "lv", "t" or "tv"。 被设置的参数为 "l" 或者 "lv"如果此时拥有六项数据数据时,或者当数据类型为 "t" 或者 "tv"且拥有五项数据时. 可以适当的使用 "1" (展开显示该内容) 或使用 "0" (隐藏该内容的显示).

以下是当数据类型设置为“l”或“lv”,从左到右的:

格式:
停止支援
支援中
最新版本
最新預覽
未來版本
從未發布
  1. 图例:
  2. 旧版本
  3. 旧版本,还在支持
  4. 当前版本
  5. 最新预览版
  6. 未来的版本
  7. 從未發布版本

以下是当数据类型设置为“t”或“tv”中,从左到右的:

格式:
停止支援
支援中
最新版本
最新預覽
未來版本
從未發布
  1. 图例:
  2. 旧版本
  3. 旧版本,还在支持
  4. 当前版本
  5. 最新预览版
  6. 未来的版本
  7. 從未發布版本

顶部单元格(标题/“图例”)无法隐藏。

style CSS 代码 此参数是可选的。 可以使用CSS语句修改模板的格式、样式和布局。 使用此参数可以插入到表格单元格中,方便在单元格中强制执行CSS定义。 CSS语句与图例组合,指定的CSS可以适用于整个块。
sortKey 选项制表(Optional sorting key) 此参数设置为ococcppn才有效。 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|n}}


图例[编辑]

此描述 输入的 这样的
水平图例
{{Version |l |show=010111}}
格式:
支援中
最新預覽
未來版本
從未發布
垂直图例
{{Version |lv |show=011101}}
格式:
支援中
最新版本
最新預覽
從未發布
本文为測試文字。这段文字用于说明格式,请勿删除。這段文字用於說明格式,請勿刪除。海納百川,有容乃大。維基百科,自由的百科全書。
水平图例(适用于表格)
{{Version |t |show=110011}}
格式: 停止支援 支援中 未來版本 從未發布
垂直图例(适用于表格)
{{Version |tv |show=111100}}
格式:
停止支援
支援中
最新版本
最新預覽
本文为測試文字。这段文字用于说明格式,请勿删除。這段文字用於說明格式,請勿刪除。海納百川,有容乃大。維基百科,自由的百科全書。本文为測試文字。这段文字用于说明格式,请勿删除。這段文字用於說明格式,請勿刪除。海納百川,有容乃大。維基百科,自由的百科全書。

参照颜色[编辑]

此描述 输入的 这样的
旧版本,但已经不支持了
{{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
從未發布(不发布)
{{Version |n |5.0.1a}}
從未發布: 5.0.1a

正确的排序[编辑]

这个模板使用了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 A}}
| 2013-13-13 || Future version
|-
| {{Version  |n  |4.0.1  |sortKey=4.0 B}}
| {{n/a}} || Nerver released
|}
Version Date Description
停止支援: 1.0 2010-07-23 Old version, unsupported
支援中: 2.0 2011-06-27 Old version, still supported
最新預覽: 3.0 DP 2012-03-02 Developer's preview
最新預覽: 3.0 CP 2012-04-01 Consumers Preview
最新預覽: 3.0 RC 2012-05-25 Release candidate
未來版本: 4.0 2013-13-13 Future version
從未發布: 4.0.1 不適用 Nerver released

看看其他的[编辑]