Project:PD help/yue
![]() Project:PD help is a project to create a set of concise user help pages for MediaWiki users, i.e. for visitors to a website which is powered by MediaWiki. The project covers all content in the Help namespace. The main entry point for this is 幫手:目錄 . This help documentation is separate from the Manual (the GFDL and CC BY-SA-licensed MediaWiki administrator's manual). Contributors, please be clear about the differences! The PD help pages do not contain information for server administrators, about how to install, configure, or maintain MediaWiki software. See the 'Goal' section below, for a detailed statement of what we are trying to achieve.
|
宗旨
目標係提供一組頁面,可以將佢哋複製到新嘅 wiki 安裝或者包含喺 MediaWiki 發行版入面。 呢個會包括基本嘅用戶資料,同埋其他元資料,以合理簡潔嘅形式。 基本概念係要創造一本「壓縮用戶指南」,而唔係參考書。佢應該着重用戶想要啲咩,而唔係解釋其他功能。
授權
對「PD 說明」嘅貢獻,會透過 CC0 豁免 以「公共領域」嘅形式發佈。 呢個係必要嘅,以便畀啲用戶輕鬆噉將啲文字複製到佢哋自己嘅 wiki 安裝入面。 「喺貢獻之前,請確保你明白以下事項」:
- 喺 PD 說明入面嘅每一頁,都要包含 $ 1呢行嚟表示個牌照。
- 任何內容都唔可以喺其他地方複製到呢啲頁面。唯一嘅例外係:
- 複製緊嘅內容係你個人嘅(例如作者),或者你已經得到原始作者嘅許可。
- 已經喺「公共領域」入面嘅內容可以喺呢度複製;不過,呢個確實「唔」包括大部分發佈嘅網頁!
- 你放棄咗你喺呢度提供嘅資料嘅所有權利,雖然你會繼續喺呢個網站上面列出同埋歸因你嘅貢獻,但係其他人可以複製呢啲文字,而唔使畀錢,同埋可以根據佢哋嘅需要修改。
目標讀者群:普通用戶
幫助頁面非常之針對wiki網站嘅普通訪客。
「唔係」伺服器管理員
我哋唔係旨在複製 MediaWiki 嘅全部文件。 針對伺服器管理員嘅資訊,詳細講解 MediaWiki 嘅安裝、配置或維護,屬於手冊。
呢個「唯一」嘅小例外,就係「管理員提示」框(喺下面會講)。
系統概念嘅資訊/官僚用戶冇咁突出
如果唔係描述「管理系統」嘅用戶可以做啲咩,「說明頁面」就唔會完整。 但係,呢啲進階功能唔係大部分目標受眾(大部分維基用戶)都可以用到。 因此,呢啲資料同大部分內容要稍微分開,噉樣正常用戶就唔會面對同佢哋無關嘅資料。
喺大部分嘅「說明頁面」入面,簡單提及需要 sysop 權限嘅操作可能會被認為係必要嘅;但係,對管理系統嘅程序嘅詳細描述應該收埋喺條拎唔太突出嘅頁面,或者應該完全唔包括喺「說明頁面」入面。
呢個部分係討論緊
編輯指南
- 喺頁面之間建立連結,但係避免連結去 MediaWiki.org 嘅其他命名空間,將連結保留喺公共網域說明頁面嘅內部,或者建立相關資源嘅外部連結(完整網址),例如「喺 meta.wikimedia.org 上面」。
- 我哋可能唔想喺任何地方交換 {{SITENAME}} 語法。 MediaWiki 係我哋描述緊嘅軟件嘅名。呢個係「內容管理軟件」( CMS ),令到目的地維基可以執行,所以我哋嘅文字指緊個軟件嘅任何地方(喺幫助中嘅所有地方),都應該留低佢作為一個字面字串「MediaWiki」。如果因為某啲原因,幫助文字提到咗個網站嘅名,噉呢個就係一個適當嘅例外(用 {{SITENAME}} ),但係,我哋「唔會」喺我哋提到 MediaWiki 呢個字嘅地方換呢個名。
- 翻譯應該喺頁面嘅英文版本達到穩定狀態之後先完成。命名準則係 < 代碼 > 頁標題 / 語言代碼 </ 代碼 > (例如說明:編輯 / pt )。
- 除非你喺呢本手冊入面有完美嘅導覽解決方案,否則請避免建立導覽範本,而係先專注於「內容」嘅建立。
- 唔好用Cite之類嘅擴充功能,因為佢哋唔係安裝晒喺所有 MediaWiki安裝上面。
格式
- 格式應該係一致嘅。用
class="wikitable"
喺你建立嘅任何表格度,用{{Hl1}}
嚟突顯儲存格或者行等等。 - 所有維基標記晒同代碼都應該放入
<code>
或者<pre>
標籤入面,幫助插入:{{subst:nw|text}}
。 - 所有提及菜單文字同描述嘅內容都應該以「斜體」顯示晒。
螢幕截圖
螢幕截圖好有用。 PD 說明頁面「唔可以」只包含公共領域嘅螢幕截圖(雖然唔可以包括商標標誌)。 螢幕截圖應該上載到維基媒體共享庫,並使用埋{{MediaWiki screenshot}}授權範本。
圖片可以用文件嚟附送,或者用InstantCommons 喺Commons入面存取。
管理員提示
如果伺服器管理員可以設定「幫助」入面嘅某啲內容,你可以插入一個包含 {{Admin tip}}
嘅「管理員提示」。
類別
根據定義, 「 $ help 」命名空間入面嘅所有頁面都係呢個公共網域說明文件項目嘅一部分,應該分類為類:幫手 。 MediaWiki 擴充程式嘅「說明頁面」,應該喺佢嘅子類別$擴充程式幫助程式幫助入面分類。
「Help:」命名空間入面嘅頁面嘅前一個類別,呢個公共網域說明文件項目,係Category:PD help。 為咗保持簡單,呢個類別而家只係類:幫手 ,而且所有頁面都更新咗。
睇埋
- Project:Language policy – 如果你有興趣處理非英文版本嘅幫助頁面。
- 項目:PD 幫助/出口 – 討論一個建議嘅方法,用嚟建立Help:命名空間嘅可用轉傳,呢個方法仲喺討論階段,仲未運作。