專案:公有領域說明
計劃:公有領域說明旨在創造一套簡明的用戶說明頁面供MediaWiki用戶使用,也就是MediaWiki所搭建網站的訪客使用。 該計劃涵蓋了命名空間:說明(Help)中的全部內容。 該計劃的主要入口點是說明:索引 。 此說明文檔與手冊(是按照GFDL以及CC BY-SA協議授權的MediaWiki管理員手冊)是分開的。 各位貢獻者們,請明確了解其中的差別! 公有領域說明頁面中不含針對伺服器管理員有關如何安裝、配置和維護MediaWiki軟件的相關信息。 請看下方的「目標」小節,該節詳述了我們努力達到的目標。
|
目標
我們的目標是提供一組頁面,這些頁面可以複製到新的維基安裝中,也可以包含在 MediaWiki 發行版中。 這將包括用戶基本資訊、還有其他的元資訊,並以適度簡潔的形式呈現。 基本概念是建立一個「壓縮」的「用戶指南」,而不是一本參考書。它應側重於用戶的需求,而不是在解釋其他許多功能。
授權
對公有領域的說明的來稿將透過CC0免責條款作為公有領域發佈。 這樣做是必要的,以便用戶可以輕鬆地將文字複製到自己的wiki安裝中。 請在投稿前了解以下內容:
- 公有領域的說明中的每一頁都必須包含
{{PD Help Page}}
這一行,以表明其授權。 - 不得將其他地方的內容複製到這些網頁中。唯一的例外是:
- 複製的內容是您個人擁有的(例如作者)、或您已獲得原作者的書面許可。
- 已在「公共領域」"的內容可以在此複製;然而,這不包括大部分已發佈的網頁!
- 您將放棄對所提供資訊的所有權利。儘管您的貢獻將繼續在本網站上被列出並被歸屬,但其他人可以複製文字而無需註明出處、也可以對文字進行他們認為合適的修改。
目標讀者群:普通用戶
說明頁面主要針對wiki網站的普通訪問者。
並「不是」伺服器管理員
我們的目標不是複製完整的 MediaWiki 文件。 針對伺服器管理員的資訊,詳細介紹 MediaWiki 的安裝、組態或維護,是屬於手冊。
「唯一」的小例外是「管理提示」框(如下所述)。
給系統管理員或官吏用戶的資訊是較不重要的
如果不說明"系統管理員"用戶可以做什麼,「說明頁面」就不算完整。 然而,大多數的終端讀者(大多數的wiki用戶)無法使用這些進階功能。 有鑑於此,這些資訊是與大部分內容稍微分開,這樣普通用戶就不會看到與他們無關的資訊。
在龐大的「說明頁面」內容之中,簡略的提及需要系統管理員權限的操作可能被認為是有必要的;但系統管理員程式的詳細描述應收藏在連結較不明顯的頁面中,甚或是應該要整個移出「說明頁面」。
本節正在討論中
編輯指南
- 請在頁面之間建立連結,但應避免連結到MediaWiki.org上的其他命名空間。請保持這些連結是內部連結到公共領域的說明頁面、或是建立外部連結(完整的URL)到相關資源,例如,meta.wikimedia.org上的相關資源。這是為了方便將文字複製到新的維基安裝中。不要使用跨維基連結,因為這些連結有可能不存在於目標維基中。
- 我們可能不想在任何地方使用{{SITENAME}}語法。MediaWiki是我們正在描述的軟件的名稱。這是 "內容管理軟件"(CMS),它使目標維基站點得以執行,因此,在我們的文字提及該軟件的任何地方(在整個說明中的任何地方),都應保留字面字串"MediaWiki"。如果出於某種原因,說明文字提到了網站名稱,那麼這將是一個適當的例外(使用{{SITENAME}})。不過,我們不會在所有提到MediaWiki的地方都把它交換掉。
- 翻譯工作應在網頁的英文版本達到穩定狀態之後完成。命名規則是
页面标题/语言代码
(例如,Help:Editing/zh). - 除非您在本手冊中找到了完美的導航解決方案,否則請先忍住不要建立導航模板,而應首先專注在建立內容。
- 請勿使用引述等擴充功能,因為並非所有的MediaWiki都安裝了這些擴充功能。
格式
- 格式應保持一致。請使用
class="wikitable"
建立你的表格、使用{{Hl1}}
等以突出顯示儲存格或行。 - 所有維基標記和代碼都應放入
<code>
或<pre>
標記中。插入:{{subst:nw|text}}
以便說明。 - 所有提及的選單文字和說明的內容均應使用斜體。
熒幕截圖圖像
截圖很有用。 「PD說明頁面」應僅包含公共領域的截圖;應避免在截圖中包含任何的標識,然後使用{{MediaWiki screenshot}}(GPL)和{{CC-zero}}(用戶作品)許可證模板,將截圖上載到共享資源。
圖片會隨文件一起提供,或是使用即時共享資源 從維基共享資源中取得。
管理員提示
如果「說明」頁面中的某些內容可以由伺服器管理員組態,您就可以使用{{Admin tip }}
插入「管理員提示」。
分類
根據定義,"Help:"命名空間中的所有頁面都是公共領域說明文件專案的一部分,應歸類為分類:說明 。 MediaWiki擴充功能的「說明頁面」應歸入其子類別分類:擴充功能說明 。
命名空間"Help:"(此一公共領域說明文件的專案)中的頁面以前的類別是Category:PD help。 為了簡便起見,類別現在只有單純的分類:說明 ,所有頁面都已更新。
參見
- Project:語言方針 — 如果您有興趣製作非英語版本的說明頁面。
- Project:PD help/export — 討論為Help:命名空間建立一個可用轉儲的提議方法。該方法仍處於討論階段,尚未投入使用。