跳至內容

模板:Version/doc

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書

使用方法

[編輯]

該模板以一種標準化的格式呈現版本歷史(版本)數據表格。

維基百科上的許多文章都使用不同顏色的表格來說明軟件的版本或發佈歷史。該模板是由德國維基百科加入的模板,在那裏它被用作彩色編碼歷史(版本)數據表格的當前標準。

這個模板在編輯 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) 在這個指定的模板生成的內容的類型。以下每一項都表示這個內容的類型,且會改變內容的背景顏色。可以使用的代碼包括有:
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)

下面的任意一個該模板生成一個顏色圖例(可以參見一下的例子)。可以使用的代碼包括有:

l: 水平圖例(Horizontal legend)
lv: 垂直圖例(Vertical legend)
t: 水平圖例 適用於表格(Horizontal legend, as a table)
tv: 垂直圖例 適用於表格(Vertical legend, as a table)

可以查看以下簡單的實例

2 文本(Text) 在適當的地方顯示文字,通常是特定版本的版本號或代號名稱。當第一個未聲明的參數(數據類型)默認被設置為有效的任 "o", "co", "c", "cp" or "p".
show 圖例選擇(Legend options) 在模板中指定的內容自動生成圖例。當第一個未聲明的參數(數據類型)默認被設置為有效的數據類型 "l", "lv", "t" or "tv"。 被設置的參數為 "l" 或者 "lv"如果此時擁有六項數據數據時,或者當數據類型為 "t" 或者 "tv"且擁有五項數據時. 可以適當的使用 "1" (展開顯示該內容) 或使用 "0" (隱藏該內容的顯示).

以下是當數據類型設置為「l」或「lv」,從左到右的:

格式:
舊版本
舊版本,仍被支援
當前版本
最新預覽版本
未來版本
  1. 圖例:
  2. 舊版本
  3. 舊版本,還在支援
  4. 當前版本
  5. 最新預覽版
  6. 未來的版本

以下是當數據類型設置為「t」或「tv」中,從左到右的:

圖例:
舊版本
舊版本,仍被支援
當前版本
最新預覽版本
未來版本
  1. 圖例:
  2. 舊版本
  3. 舊版本,還在支援
  4. 當前版本
  5. 最新預覽版
  6. 未來的版本

頂部單元格(標題/「圖例」)無法隱藏。

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
|}
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
當前版本: 3.0 2012-06-23 Release to web
未來版本: 4.0 2013-13-13 Future version

看看其他的

[編輯]