Jump to content

Extension:页面表单/快速开始指南

本頁使用了標題或全文手工轉換
From mediawiki.org
This page is a translated version of the page Extension:Page Forms/Quick start guide and the translation is 100% complete.

目前,您已经设置好了您的站点的所有软件。 然後呢?該是创建用于保存、显示以及启用添加和编辑数据的结构的时候了。謝天謝地,所有这些都可以通过创建各种Wiki页面来完成。

第一步應該是去釐清您的数据结构。 您的网站有哪些类型的页面? 每个页面需要包含哪些数据? 您可以稍后再更改所有这些,但是您应该有一个开始计划。 一旦明晰了这些(最好是写下来),就可以开始创建必要的Wiki页面。 您将需要为模板和表单(可能还有分类)以及(如果使用语义MediaWiki)属性创建或修改页面。

您可以从头开始创建所有这些文件,尽管也存在帮助程序表单来帮助创建它们。 正确的方法取决于您使用的其他扩展:

使用Cargo

简单方法 - Special:CreateClass

页面Special:CreateClass(由页面表单定义)提供了一个助手表单,可以在一个页面内定义有关数据“类”的所有内容。 如果填写这些字段并单击“提交”,页面将自动创建必要的模板、表单和分类页面。 然后,您可以转到已创建的表单页面,并开始输入数据。

如果有些页面还未创建,则可能是您的作业队列缺少足够的内存。 有关如何添加更多内存的信息,请参见作业队列相关的项目

更全面的方法

您应该采取以下步骤:

  • 创建模板。模板决定了页面上数据的显示方式,包含了将数据存储在Cargo表中的标记,并且(通常)将页面定义为特定分类,从而具有特定页面类型。 每个页面类型通常会有一个模板,尽管有时一个页面类型会包含多个模板。 模板也可以用于汇总,显示与此页面有一定关系的所有其他页面的列表。 可以在Special:CreateTemplate页面创建模板。
  • 创建表单。现在您可以创建表单,以便用户可輕易增加和编辑各类型的页面。 每种页面类型应有一个表单;表单将填充此页面类型包含的一个或多个模板。 与之前相同,特殊页面Special:CreateForm用于创建新的表单。
  • 创建分类。每个表单中的一个模板应标记该表单创建的每一条文章,使其属于某个分类。 您应该为每个此种分类创建一个页面,并为其指定一个默认表单,以便可以使用与创建该表单相同的表单自动编辑每篇文章。 最简单的方法是使用Special:CreateCategory页面。
  • 添加到表单的链接。除了创建具有默认表单的类别之外,还应该执行其他步骤以使得用户能够存取您已创建的表单。 其中包括在侧栏或其他位置添加链接以便添加数据,并使用#formredlink来使指向不存在页面的红色链接指向用于创建它们的表单。 这些操作都在“链接到表单”页面中进行了说明。
  • 在侧栏或其他位置添加链接。您可以编辑侧栏(可以在“MediaWiki:Sidebar”页面上对其进行编辑)以存放連結以新增各類資料型別。 您还可以添加指向Special:Drilldown的链接,该页面是Cargo定义的页面,它提供了一种轻松查看所有Wiki数据的简便方法。 您也可以在主页和其他位置添加此类链接。
  • 添加数据。现在您可以开始添加数据了! 只需转到表单页面,然后开始创建页面。
  • 客製化。一旦结构搭建完成后,您可以客製化所有内容--變更整個維基的整體外觀與操作體驗、各類模板的樣式,以及表單的呈現方式;新增與修改欄位,並新增與調整內嵌查詢功能。

使用语义MediaWiki

简单方法 - Special:CreateClass

页面Special:CreateClass(由页面表单定义)提供了一个助手表单,可以在一个页面内定义有关数据“类”的所有内容。 如果填写这些字段并单击“提交”,页面将自动创建必要的属性、模板、表单和分类页面。 然后,您可以转到已创建的表单页面,并开始输入数据。

如果有些页面还未创建,则可能是您的作业队列缺少足够的内存。 有关如何添加更多内存的信息,请参见作业队列相关的项目

更全面的方法

您应该采取以下步骤:

  • 创建属性。任何语义站点的基本构建块都是数据之间的连接,在语义MediaWiki中将其称为属性。 属性用于指定有关此页面主题的单个信息。 每个属性都应在您的Wiki上定义,并在“Property:”名字空间中包含一个页面。 可以在Special:CreateProperty页面创建属性。
  • 创建模板。模板决定了页面上数据的显示方式,包含了将数据存储在实际的语义信息中的标记,并且(通常)将页面定义为特定分类,从而具有特定页面类型。 每个页面类型通常会有一个模板,尽管有时一个页面类型会包含多个模板。 模板也可以用于汇总,显示与此页面有一定关系的所有其他页面的列表(参见内联查询以获取更多信息)。 可以在Special:CreateTemplate页面创建模板。
  • 创建表单。现在您可以创建表单,以便用户可輕易增加和编辑各类型的页面。 每种页面类型应有一个表单;表单将填充此页面类型包含的一个或多个模板。 与之前相同,特殊页面Special:CreateForm用于创建新的表单。
  • 创建分类。每个表单中的一个模板应标记该表单创建的每一条文章,使其属于某个分类。 您应该为每个此种分类创建一个页面,并为其指定一个默认表单,以便可以使用与创建该表单相同的表单自动编辑每篇文章。 最简单的方法是使用Special:CreateCategory页面。
  • 添加到表单的链接。除了创建具有默认表单的类别之外,还应该执行其他步骤以使得用户能够存取您已创建的表单。 其中包括在侧栏或其他位置添加链接以便添加数据,并使用#formredlink来使指向不存在页面的红色链接指向用于创建它们的表单。 这些操作都在“链接到表单”页面中进行了说明。
  • 在侧栏或其他位置添加链接。编辑侧栏(可以在“MediaWiki:Sidebar”页面上对其进行编辑)應包含新增各資料類型的連結,以及這些資料類型的分類連結。 您也可以在主页和其他位置添加此类链接。
  • 添加数据。现在您可以开始添加数据了! 只需转到表单页面,然后开始创建页面。
  • 客製化。一旦结构搭建完成后,您可以客製化你想要的内容--變更整個維基的整體外觀與操作體驗、各類模板的樣式,以及表單的呈現方式;新增與修改欄位,並新增與調整內嵌查詢功能。

示例

讓我們透過一個具體範例,從頭開始以「更全面的方式」建立基於頁面表單的wiki。 假设你想创建一个wiki,展示你家里所有的藏书。 然后,我们将按照指定的先前步骤进行操作,其中“Cargo”与“MediaWiki语义”的某些部份有所不同。

1. 釐清数据结构。 你希望你的wiki中有两种类型的页面:书、以及作者。 每个书的页面都应包含书名、作者、类型、出版年份,以及总页数。 每个作者页面应该包含作者的名字、原創国,以及你所收藏的他的作品列表。

2. 创建属性。

使用Cargo 使用MediaWiki语义
Cargo沒有相應的步驟。 對於書而言,無需為書名建立專屬屬性,因為每個代表書籍的頁面標題即是該書的書名。

這就剩下四個欄位:

  • 作者--透過使用「建立屬性」頁面(在Special:CreateProperty中),您將建立名為「撰寫者為」的屬性,其類型為「Page」(因為每位作者都會擁有專屬頁面)。
  • 類型--您建立了一個名為「類型為」的屬性,其類型為「Text」,並賦予其允許值,例如:「藝術、食譜、小說、歷史、詩歌、科學」。
  • 出版年份--您建立了一個名為「出版年份於」的屬性,其類型為「Number」。
  • 頁數--您建立了一個名為「頁數有」的屬性,其類型為「Number」。

對於作者頁面,您只需再建立一個屬性:

  • 原創國--您建立了一個名為「來自於國家」的屬性,其類型為「Text」。

3. 创建模板。 您需要建立兩個模板,一個用於書籍,另一個用於作者,兩者皆位於在Special:CreateTemplate的「建立模板」頁面。

第一步,書是:

使用Cargo 使用MediaWiki语义
在Special:CreateTemplate處,將模板名稱設定為「書」,並將類別名稱設定為「書籍」。

您需對它新增四個欄位,並為每個欄位指定至少三項值:其在模板原始碼中的欄位名稱、其在各頁面上的顯示標籤,以及其類型。 還有其他幾個值可以設定,但對於這些欄位中的大多數而言,這些設定並非必要。

  1. 對於第一個欄位,請將欄位名稱設定為「作者」、標籤設定為「作者(們)」、類型設定為「Page」。 您亦需勾選該方格,以表明此欄位可儲存值清單(因一本書可能擁有多名作者)。
  2. 點擊「新增欄位」,接著為第二個欄位設定三個值:「類型」、「類型」、及「String」。 你需要再次勾選方框,以表明此欄位可儲存一組值的清單。 接著應指定允許值的集合;此集合可採用簡單清單形式、或採用階層結構的形式。 你可以建立一個簡單的清單,例如「藝術、食譜、小說、歷史、詩歌、科學」等等;或者你可以建立完整的層級結構,其樣貌可能如下:
* Fiction
** Science fiction
*** Cyberpunk
** Historical fiction
...諸如此類。
3. 點擊新增欄位,接著在第三個欄位中,將值設定為「年份」、「出版年份」、和「日期」(是一個優於「Integer」的選擇)。
4. 點擊新增欄位,然後將第四個欄位設定為「頁數」、「頁數」、及「整數」。
5. 點擊「儲存頁面」按鈕。
在Special:CreateTemplate處,將模板名稱設定為「書」,並將類別名稱設定為「書籍」。

您需對它新增四個欄位,並為每個欄位指定三項值:其在模板原始碼中的欄位名稱、其在各頁面上的顯示標籤,以及該欄位填入的語義屬性。

  1. 對於第一個欄位,將欄位名稱設定為「作者」,標籤設定為「作者(們)」,語義屬性設定為「撰寫者是」,並勾選此欄位可儲存值清單的核取方塊(因書的作者可能有多位);
  2. 點擊新增欄位,接著為第二個欄位設定三個值為「類型」、「類型」、和「類型為」,同時勾選「值清單」選項;
  3. 點擊新增欄位,然後為第三個欄位設定值為「年份」、「出版年份」、及「出版年份於」;
  4. 點擊新增欄位,然後在第四個欄位中,將值設定為「頁數」、「頁數」和「頁數有」。

點擊「建立」按鈕。

下一步,建立作者類別的模板——透過使用「建立模板」頁面,您可建立名為「作者」的模板,並設定使其定義「作者」類別。

使用Cargo 使用MediaWiki语义
  1. 只需在此模板中新增一個欄位,並將其三個值分別設定為「國家」、「原創國」和「Page」。
  2. 點擊「儲存頁面」按鈕。
  1. 只需在此模板中新增一個欄位,並將其三個值分別設定為「國家」、「原創國」及「來自於國家」。
  2. 對於此模板,您還需在表單中填寫「彙總」欄位,因為您希望每個作者頁面能列出所有該作者撰寫的書籍。 在「語義屬性」下拉選單中,請選擇「撰寫者是」,並於「清單標題」欄位輸入「此作者的所有著作」。
  3. 點擊「儲存頁面」按鈕。

4. 创建表单。 您需要建立兩個模板,一個用於書籍,另一個用於作者:

  • 書--透過使用「建立屬性」頁面(在Special:CreateForm處),您製作一個名為「書」的表單,選擇「書」模板,然後點擊「新增」按鈕。 您亦可選擇性地新增一段本書的情節——若要執行此操作,請新增一個名為「情節」的段落(不是模板)。 您無需在此表單上進行任何進一步的定制設定,只需在建立完成後直接儲存即可。
  • 作者--透過使用「建立屬性」頁面,您製作一個名為「作者」的頁面,並將「作者」模板加入其中。 與先前相同,您無需進行任何進一步的定制設定——只需儲存頁面即可。

5. 创建分类。 您需要建立兩個分類,一個用於書,另一個用於作者;您先前已指定過這些分類的名稱:

  • 書--透過使用「建立分類」頁面(在Special:CreateCategory處),您製作一個名為「書」的分類,賦予其預設的表單「書」。
  • 作者--透過使用「建立分類」頁面,您製作一個名為「作者」的分類,賦予其預設的表單「作者」。

6. 啟用到表单的链接。

使用Cargo 使用MediaWiki语义
在書的模板(位於Template:Book)的文字區塊中,尋找顯示內容有包含以下的標籤的部份:
{{{Authors|}}}

請將此處替換為類似以下內容:

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}} }}
在書的模板(位於 Template:Book)的文字內容很可能包含類似以下的片段:
{{#arraymap:{{{Authors|}}}|,|x|[[Was written by::x]]}}

請將此處替換為類似以下內容:

{{#arraymap:{{{Authors|}}}|,|x|{{#formredlink:target=x|form=Author}}{{#set:Was written by=x}}}}

這將使尚未存在的作者頁面連結指向建立該頁面的表單。

7. 添加数据。 透過使用新的「書」的表單(位於Form:Book),您可為某些書建立頁面;請檢查確認表單與產生的頁面皆顯示正常。 每本書現在都會出現一個紅色連結,指向該作者的「作者」表單以便新增該作者(您可能需要重新整理頁面才能顯示正確連結)。 接著,您可以透過這些連結或直接從表單頁面新增幾位作者,以確保此設定也能正常運作。 每位剛創建的作者頁面應顯示您已儲存且該作者所著的書籍清單。

8. 在侧栏或其他位置添加链接。 您的結構現已全部設定完成,可透過修改頁面 MediaWiki:Sidebar(若使用非英文語言則修改其對應頁面)來新增側邊欄連結,以便輕鬆添加與檢視內容。 您可以在「書」和「作者」表單中添加連結,以便輕鬆新增新內容。 您亦可連結至Special:Drilldown(若已安裝 Cargo),或Special:BrowseData(若已安裝語義鑽探的擴充功能),讓使用者能一覽所有資料。

使用頁面輪廓

頁面輪廓擴充功能是專為自動建立資料結構(包含表單)而設計。 其碾壓標準的页面表单的輔助表單,最主要優勢是在於可反覆建立與修改這些資料結構頁面、而非僅能一次建立就定生死。 它可與已安裝的Cargo或MediaWiki語義搭配使用、任何一個都不安裝亦可。 若已安裝Cargo和/或MediaWiki语义,則Page Schemas表單將包含多個額外欄位,以便建立所需的附加標籤。 要建立頁面輪廓,您需要前往分類頁面(無論該頁面是否已建立),進入建立該頁面輪廓的標籤操作、填寫表單、然後再前往根據該輪廓生成頁面的標籤操作。 请参阅Page Schemas来获取更多信息。

快速参考指南

有两个适用于打印的快速参考指南,或称其为“备忘单”,其中包含有关页面表单的有用信息(尽管在两种情况下它们仍将其称为“语义表单”),以及其他扩展:

  • Cargo快速参考指南:PNGPDF格式
  • 语义MediaWiki快速参考指南:[$1 参见此处],PNG、PDF和SVG格式