快捷方式:BEDW:SG  BEDW:STYLE

Minecraft基岩版开发Wiki:格式指導

出自Minecraft基岩版开发Wiki
(重新導向自Minecraft基岩版开发Wiki:SG

此條目旨在提供一份為所有Minecraft Wiki條目遵守的綜合的格式指導。 在選擇使用哪些格式規則上經常會有爭議,而一部官方的格式指導有希望幫助解決這些爭議,同時也能幫助大家達成共識。

雖然維基百科已經提供了一份更通用的格式指導,但專用於Minecraft基岩版開發的特殊指導方針是有必要的。同理,只有專用於Minecraft基岩版開發Wiki的指導方針和其基本的格式規則才會被收錄在這裏。

語法[編輯]

本Wiki首要採用Wikitext語言進行撰寫,必要時才可以加入HTML標記。如果濫用HTML語言標記,你的編輯可能會被回退。

關注度[編輯]

目前本Wiki的內容頁面包括主命名空間和Manual命名空間,前者放置一般內容,後者放置開發手冊與教學。如果你建立了一個一級頁面,但內容過於詳細,我們可能會要求你拆分該頁面到多個子頁面。

只有符合以下準則的條目可以放在內容頁面上。不符合準則的條目可能會在未通知的情況下被刪除。

一般
  1. 命名空間的介紹主體必須是一個專有名詞。Minecraft基岩版開發Wiki命名空間存放本Wiki的政策性內容、計劃內容和新聞報內容等以整個Wiki性質運作的內容,Help命名空間存放對本Wiki使用的指導和教學相關內容。Manual存放對非專有名詞主體的介紹、非本Wiki使用相關的教學等指導性內容。特別的,除了[[模组]]頁面本身,所有遊戲模組相關內容皆應存放在Mod命名空間,所有文件性質的內容皆應存放在Documentation命名空間。
  2. 條目必須包含足夠的資訊以支撐一個完整的條目。如果它們沒有足夠的內容,就會被合併到其他相應的條目。
  3. 條目必須在某種程度上直接涉及Minecraft基岩版。
  4. 關於人物的條目只允許此人物是與Minecraft基岩版相關的開發人員。
  5. 可以在Manual命名空間建立關於Minecraft基岩版及其他軟件版本的條目,每個版本都應該建立單獨的條目。
    1. 可以建立關於未發佈版本的條目,前提是有證明未發佈版本存在的顯著資訊來源。
  6. 請勿在主命名空間建立關於特定函式、模組、元件[注 1]等的介紹內容,請把他們放在Manual命名空間中。
社群內容
  1. 遊戲開發相關的教學等應作為Manual命名空間的子條目,並將連結放置在教學頁面中。
Wiki條例
6. 忠於事實——不要在編輯頁面時對內容進行惡搞、諷刺、扯淡、二次創作、夾帶私貨以免誤導新玩家。
7. 禁止建立廣告頁面,使用者頁面除外。

以下條目由於關注度原則,不會被收錄:

  1. 與Minecraft基岩版無關的內容,比如Java版獨佔的相關內容。
    1. 他們應該收錄於Minecraft官方Wiki
  2. 與開發無關的內容,如「一塊原木可以合成4塊木材」。
    1. 他們應該收錄於Minecraft官方Wiki

在「User」名字空間的條目是關注度指導的例外。這些條目可以在遵守相關Wiki條例的條件下作任意用途。

  1. 此處指附加包內或模組API內的元件,不指網易我的世界中開發人員發佈的功能元件

重新導向[編輯]

重新導向條目有特別的關注度原則,且其必須重新導向到一個符合關注度指導的條目。如果重新導向到另一個Wiki,必須使用軟重新導向{{soft redirect}}。原版物品、方塊、生物等的名稱應該被重新導向到Manual命名空間中的Manual:minecraft:xxx條目中。重新導向條目在符合以下條件之一時可被建立:

  1. 屬於替代或縮寫的名稱,而此名稱被廣泛使用,例如「栓繩」之於「拴繩」。曾用於遊戲中的名稱也是允許的。
    1. 也包括其他中文書寫系統中的名稱。
    2. 錯誤拼寫、筆誤、非正規的格式和粗俗內容是被不允許的。
  2. 屬於曾用的條目標題,包括被移動到其他Wiki的條目,例如「流髑」之於「流髑」。
  3. 屬於合併或雜項條目的一部分,例如一種藥水、一種提及特性或同一啟動器版本在不同平台上的版本號。

一個頁面的重新導向數量需在合理範圍內。重新導向條目的目標不能是不存在的條目或另一個重新導向條目。

「User」命名空間下的條目可以重新導向到任意位置,但仍需遵守上述原則。

條目標題[編輯]

條目應遵從基於其型別的一般命名格式。

  • 關於遊戲內方塊,物品和實體等特性的條目應使用Java版遊戲內譯名。目前,這些譯名由中文Minecraft Wiki管理團隊管理。完整的譯名列表可見此處
    • 基岩版的譯名質量差,不值得使用。
    • Minecraft官方Wiki中有對應頁面,請使用Minecraft官方Wiki使用的譯名。
    • 如果某特性尚無確定的中文譯名,則使用其英文名稱作為佔位,其相應條目的編輯應一律在公共沙盒中進行。待中文名稱確定後,再將條目移動至相應的中文名稱處(不留重新導向)。
  • 消歧義條目在標題已被某條目使用時才應該包含「(消歧義)」,「(消歧義)」與條目中心詞之間要加一個空格「 」。
  • 若是以英文命名的條目,且條目型別未在此列出,則應選用句子型大寫(第一個單詞首字母大寫)的最確切的標題,而不應用標題型大寫(各單詞首字母大寫),除非其為一個特定的專有名詞。

命名語言[編輯]

  • 內容頁面(目前包括命名空間、ManualHelpMineprogrammingMinecraft基岩版開發WikiModDocumentation命名空間)及其討論頁請以正確的中文名命名。
  • 其餘頁面請務必以英文名命名,這包括但不限於模板、模組、訊息、小工具、小部件、檔案(媒體)的名字以及他們內容中的所有參數的名字。這是由於本站是一個中文Wiki而非簡體中文或繁體中文或任何一個變種的單一語言Wiki,如此命名有助於所有使用中文的使用者能夠更加方便地編輯。

編寫[編輯]

由於本Wiki的目的是記錄事實,您應該始終避免推測的與無來源的資訊。一般來說,如果可以直接地在遊戲或其他明顯的地方被看到,這些資訊就不需要來源。然而其他的資訊,比如來自Mojang員工的引言和並不廣為人知的資訊,必須以適當的參考標明來源。{{citation needed}}模板應被放置在任何需要來源的資訊之後。不要在條目中加入你無法找到來源的內容。

在主名字空間的條目應該保持第三人稱的口吻且不使用對讀者來說需要參考的術語,但教學頁面除外。也儘量嘗試不使用縮略語。舉例來說,「你不該靠近苦力怕,因為他們會爆炸然後把你殺掉。」應該寫成「玩家不應該與苦力怕靠的太近,因為它們會爆炸,並有殺死玩家的可能。」

強調重點時應該用粗體,而不能用斜體

教學資訊,包括對方塊或材質的延伸特性,應唯寫在Manual命名空間下。如果有重要關係,教學條目被主要條目連結。

未來[編輯]

在未來更新中加入的內容應加入到條目的主內容中,被寫入的特性要用{{upcoming}}標記且是在搶鮮版中出現過的。如果更新包含相關條目的巨大變更,那麼這些內容應在主段落中作為一個子段落提及,或是放在一個名為「即將到來」的專有段落。即將到來的特性必須同時在「歷史」段落,使用特定的「即將到來」的標頭提及。

更新發佈後,所有過期的內容都需要移動到歷史段落或移除,且所有使用的{{upcoming}}模板都應被移除。

英語語法[編輯]

Wiki上的條目應使用美式英語,除非遊戲中名稱是英式英語。例如,「colour」應為「color」,而「centre」應為「center」。

英文使用[編輯]

中文Wiki僅在一個條目的核心詞第一次出現時在括弧給出其英文名稱。如果某特性變更了其英文名稱,而中文名稱不變,則在相應的歷史段落內說明。

段落等級[編輯]

頁面主段落應以二級標題開始(兩個等號==),每一子段落增加一級,除非使用了__NOTITLE__

段落之間應有一個空格,等號與段落名稱也應有一個空格以方便編輯。如果使用了「主條目」連結或縮略圖,將其直接放在段落標題之下,然後在開始段落內容之前,接著輸入一個空格。

關於段落次序的資訊,參見本格式指導的頁面佈局段落。

斜體[編輯]

中文和英文的斜體使用方式有所差異。在本Wiki中,斜體的使用規範如下:

  • 一般情況下,任何中文內容都不應使用斜體標記。
    • 強調內容時可以適當使用粗體標記,包含中文的書籍、電影等作品名稱應使用書名號「《》」標記。
  • 只包含英文的書籍、音樂等作品名可以使用斜體標記,如Minecraft: The Voyage。在英文句子中強調內容時,也可以使用斜體標記。
    • 軟件、遊戲模組等名稱為例外,不應使用斜體標記。
    • 其他情況下,英文內容都不應使用斜體。
  • 在計算公式和指令等特殊內容中,可以適當使用斜體標記參數。

另外,有時為了防止機械人在批量替換文字時破壞模板參數,部分正文內容也會使用斜體標記。這類標記會在文字替換完成後由機械人自動去除。

圖片[編輯]

當往頁面加入畫面截圖時,確保截圖用的是軟件原版材質與UI。

圖片介紹末尾不應有句號,除非陳述式是一個完整的句子。

往頁面中加入的圖片應符合以下指導方針:

  • 圖片應展現頁面主題的一種屬性。
    • 圖片不應出現無意的怪異或搞笑之類的行為,例如生物「坐在」階梯上。
    • 圖片不應只有展示錯誤的目的,而錯誤應到官方追蹤器回報。
    • 圖片應避免展示具體特性的裝飾用途。
  • 頁面應只用一張圖片展示頁面內容的某一項獨立屬性。例如,一隻殭屍穿著盔甲。
  • 圖片應展示包含描述內容的最新版本的Minecraft。
    • 圖片如果過期則應被移除。

連結[編輯]

對連結的使用是在為讀者提供使其能流暢閱讀頁面的足夠實用連結與干擾到閱讀流的多餘連接之間的艱難平衡。

連結缺失會使讀者困惑,因為可能會出現一些只能透過搜尋選項或其他說明來源的關於頁面內容的問題,這些問題會打斷並干擾讀者。

連結過多可能會干擾讀者,因為連結常使用不同顏色來吸引眼球。此外,如果同一個詞在同一個段落被多次使用連結,會使讀者產生這些連結是否指向不同頁面的疑問。

連結的指導方針如下:

  • 單個頁面用於連結的詞不能超過10%。
  • 除非對句子的詞語組成或可讀性產生不利影響,兩個連結不能緊挨在一起,以致看起來像單個連結。
  • 任何單一術語的連結不能在同一頁面多餘地重複建立。多餘連結的定義是在某行或某自然段對同一術語建立多次,使其在讀者畫面上總會不必要地出現。記住,連結的目的是在讀者需要更多資訊,而要臨時繞道時,引導他們到一個新的地方。
  • 在頁面中離上一次出現有一定距離的地方重複建立重要連結應是很合適的。如果一個重要術語在一個長頁面中多次出現,但只在頁面最開頭的地方用了連結,就應當用下劃線標明。確實,帶著興趣直接跳轉到一個子段落的讀者必須依然能找到一個連結。但對於這種問題要小心對待,重複連結的距離關乎編輯者的喜好,然而如果存疑那就在更遠的地方重複。

連結到重新導向頁比用管線連結更好,除非是在模板和其他可能會被引用的頁面。如果無法避免使用管線連結,就不應將其指向重新導向頁。舉例:請用[[白桦原木]]而不是[[原木|白桦原木]]

樣式與程式碼[編輯]

如果需要對一段文字使用等寬字型,請使用{{code}}{{samp}}。二者的使用上下文有所不同。

  • 一個函式名、變數名、檔案名、域名等作為一個物體或概念的名稱引用時,請使用{{samp}},例如query.any_tagoptions.txt
  • 對應的,一段程式碼、檔案路徑、URL等在需要強調的同時包含一定邏輯或模式的文字,請使用{{code}},例如query.any_tag();minecraftpe/options.txt

檔案[編輯]

檔案的名稱應當簡潔,且能表明檔案的內容。需要注意:

  • 不應該只用日期來給檔案命名(這經常發生在截圖上,請修改檔案名)。
  • 檔案名不應該包含中文字元。
    • 全形符號也被視為中文字元,請在上傳時改為半形。
  • 檔案名不能是無意義的字母、數字和符號的組合。
  • 檔案名也不應該包含「px」之類的尺寸說明。
  • 確保檔案名中沒有多餘的空格。
  • 檔案後綴名一律小寫。

Infobox內的圖片名稱必須和遊戲內英文名稱一致,且應當是等軸視圖

頁面佈局[編輯]

出於一致性的目的,特定型別的所有頁面都應遵循此一般佈局。一般條目從上往下分別是:

  1. Pagenav(導覽);
  2. Hatnote(頂注);
  3. Message box(訊息框);
  4. Infobox(資訊框);
  5. 關於條目的簡要介紹;
  6. 條目主體部分;
  7. 另見/另請參閱;
  8. 註釋和參考;
  9. 合適的底部導覽;
  10. 分類;
  11. 跨語言連結。

條目頂部內不應有過多的訊息框。必要的時候,請將訊息框移動至與其最相關的段落頂部。

如果頁面目前尚未擁有佈局,可以在討論頁中提出;否則,就嘗試使用與已存在的佈局格式相近的佈局。目前頁面的佈局包括:

刪除頁面[編輯]

為了防止出現孤立頁面,請勿直接清空一個頁面,而應當在頁面頂部使用{{delete}}模板提示管理員或巡查員刪除此頁面。使用了此模板的頁面會加入到Category:等待刪除分類中。

Template:Help