基本語法
文本樣式
黑體、斜體、非wiki格式功能可以在wiki 的編輯器上方找到。
| 格式 | 語法 | 效果 |
|---|---|---|
| 黑體 | '''黑體''' | 黑體 |
| 斜體 | ''斜體'' | 斜體 |
| 黑體+斜體 | '''''示例''''' | 示例 |
| 划掉 | <strike>划掉</strike> | 划掉 |
| 非wiki格式 | <nowiki>{{infobox}}</nowiki> | {{infobox}} |
段落格式
各級大標題效果
| 格式 | 語法 | 效果 |
|---|---|---|
| 各級大標題 | == 二級 == === 三級 === ==== 四級 ==== ===== 五級 ===== |
二級三級四級五級 |
| 水平分割線 | 上一段話 ---- 下一段話 |
上一段話 下一段話 |
| 無序列表 | * 無序列表項 ** 無序列表項 * 無序列表項 每多一個"*"就多一級 |
|
| 有序列表 | # 有序列表項 ## 有序列表項 ### 有序列表項 # 有序列表項 每多一個"#"就多一級 |
|
| 定義列表 | ;概念1 : 定義1 ;概念2 : 定義 2-1 : 定義 2-2 這里的";"是英文的分號,":"是英文的冒號 |
|
| 文本縮進 | :縮進1個字符 ::縮進2個字符 :::::縮進多個字符 這里的":"是英文的冒號 |
|
| 多種段落格式混用 | # 有序列表項1 # 有序列表項2 #* 有序列表項2的無序列表項1 #* 有序列表項2的無序列表項2 # 有序列表項3 #; 有序列表項3的概念 #: 有序列表項3的定義 # 有序列表項4 #: 有序列表項4的 #: 縮進樣式 # 有序列表項5 ## 有序列表項5-1 ### 有序列表項5-1-1 ## 有序列表項5-2 |
|
2.2 Wiki基礎語法
本節正式介紹Wiki語言的基礎語法規則。如果你曾經接觸過Markdown之類的文本標記語法,你會發現二者十分接近。如果你接觸過網頁語言HTML就更好了,因為Wiki語言某種意義上就是一種高度簡化的HTML。
2.2.1 綜述 Wiki語言是一種文本標記語言,將約定的特殊標記寫進普通文本里,解析器就可以識別出這些標記,從而以需要的樣式處理文本。Wiki語言高度簡化了HTML,使得使用門檻大大降低,某種意義上不會比使用Word軟件更難。
2.2.2 Wiki原生語法 這一部分語法在支持MediaWiki的站點上一般都可以使用。
= 一級標題 =、== 二級標題 ==、……、====== 六級標題 ======:標記之間的文本被識別為標題文本,具體樣式看本地的設置。一般不要用一級標題。 ''斜體文字''、'''粗體文字'''、'''''粗斜體文字''''':標記之間的文本變為相應樣式。不能跨行使用。
[[內部鏈接]]:標記之間的文本會變成指向本Wiki站點上的同名頁面的鏈接。如果該頁面存在,這個鏈接是藍色的(有效鏈接),否則是紅色的(無效鏈接)。
特殊用法: [[頁面名稱|鏈接文本]]:仍然指向“頁面名稱”,但是外觀上顯示的文本是“鏈接文本”。“鏈接文本”可以嵌套一些復雜的樣式,比如說可以做出彩色鏈接等。
[[頁面名稱#標題]]:定位到目的頁面具體對應標題的位置。缺省“頁面名稱”時,定位到本頁面的對應標題。
[[File:文件名|一系列參數]]:嵌入本Wiki上的文件(一般是圖片)。具體用法見本Wiki上的幫助頁。
[[Category:分類名稱]]、[[分類:分類名稱]]:為當前頁面添加分類。分類是一種類似於Tags的東西,便於檢索和管理。
兩次換行:Wiki語法中需要兩次換行才能在實際顯示中“換行”。實際的內在原因是,兩次換行才能識別為一個“段落”。
行首的:(半角冒號)表示縮進:※需要注意,Wiki語法中不允許段首空格。※如果需要縮進,在段首添加半角冒號,半角冒號的數目代表縮進量。這個語法常在討論串中使用,做出參差錯落的回復串便於閱讀。
行首的*(乘號或星號,whatever)表示無序列表項:表現為段首的一個實心小圓點,*的數量代表列表級數,也表現為縮進量。
行首的#(井號)表示有序列表項:表現為段首的序號,#的數量代表列表級數,表現為縮進量和序號起點。 以上三種行首標記可以混寫。
----(四個連續減號/短橫線):分割線。
外部鏈接: 1. 文本中以https或http開頭的網址會被自動識別並顯示為外部鏈接,無須特殊標記。
2. 在以上基礎上,用[]將網址括起來,會顯示為類似於[1]↗的形式,避免網址過長影響觀感。
3. 在以上基礎上,可以自定義鏈接文本:[https://zh.moegirl.org 萌娘百科],顯示為 萌娘百科↗ 。
另有表格系統等不在此說明。
2.2.4 模板
在我看來,Wiki語言最成功,最具有代表性的兩個語法,一個是內部鏈接——[[]],另一個是模板(Template)系統——{{}}。內部鏈接構成的是一個龐大的詞條網絡,從一個詞條可以前往大量的其他頁面,激發讀者的探索欲;后者則在極大地提高了Wiki語言的自由度和表現力的同時,降低了編輯門檻——這簡直是不可思議的。
模板的核心思想是在一個頁面調用另一個頁面的內容。這另一個頁面一般是以Template(模板)為名字空間的頁面,如Template:洛天依、Template:黑幕。這意味着不同Wiki上的模板系統不相同,不能通用。 在我看來,模板一般可以分為兩種,一種是內容性的,一種是工具性的。
前者有實際性的內容,自身也可以單獨抽出來作為詞條,代表性的如各種大家族模板,如Template:樂正綾,我們需要頻繁地更新這個列表,而所有含有樂正綾演唱的歌曲詞條都會含有這個列表,我們不可能每一次都手動更新所有相關頁面,但是使用模板就可以做到只更新模板頁面就可以讓所有相關頁面更新。
后者一般沒有實際的內容,但是一般構成了一個框架,就像一個函數,通過調用時傳入參數,生成所需的文本,這種模板一般建立時就確認了主要框架,不會頻繁更新。
模板一般有兩種調用方式,分別是直接調用和傳參調用。
直接調用的語法即 {{模板名稱(不含Template等字樣)}},如 {{洛天依}} 即可直接拷貝 Template:洛天依 的可見內容至標記位置。
傳參調用的語法為: {{模板名稱|匿名參數值1|匿名參數值2|...|匿名參數值n|參數名1=參數值1|參數名2=參數值2|...|參數名n=參數值n}} 有點頭暈?不怕,我一個個詳細解釋。
我們以B站播放插件模板 {{BilibiliVideo|id=6009789|page=1}} 為例。 首先,參數之間用|分隔號間隔,這個符號在你鍵盤右端,如果你學過編程你對此會比較熟悉。 然后,id和page是參數名,分別代表了AV號和第幾P,等號后面的部分為對應的參數值(如該視頻即為COP的《世末歌者》)。 這個模板沒有匿名參數。所謂匿名參數沒有參數名,他們是根據傳入順序來分配的,如 {{洛天依|collapsed}} 中就往模板傳入了值為"collapsed"的一個匿名參數,生成的大家族列表會默認折疊。
有的參數是可以缺省的,如上面的BilibiliVideo還有包括寬度、高度等參數,但是省略了,模板內部設置了默認值,缺省的參數會使用默認值。而直接使用 {{洛天依}} 時,顯示為展開狀態。但是有的參數是必需的,若不傳入會出現錯誤。
參數名、參數值前后的空格和換行會被忽略,故對於一些大型模板會有類似於 {{Vocaloid_Songbox_Introduction |lbgcolor = |ltcolor = |group1 = |list1 = |group2 = |list2 = |group3 = |list3 = }}
這樣的寫法。 一個模板可能會被設計為具有強大的功能和復雜的參數,要查看它的詳細用法可以直接訪問它的頁面,模板作者和修訂者一般會給出完整的使用文檔。
萌百上常用的基礎模板: {{color|顏色|文本}}:給文本染色。 {{黑幕|文本}}:在文本上罩一層黑幕,鼠標移上去時才能看到。用於幽默,但不應濫用。
{{Hide|標題=|文本=}}:文本會被折疊起來,用於折疊大段文本或者劇透內容。
{{info|文本}}:會生成一個提示欄,並有多種衍生版本。
…… 更多的模板可以在編輯框下面看到,在此不作贅述。
模板的出現和完善令編輯者不需要從頭開始寫詞條,也大大提高了詞條的規范性。萌百VC區的歌曲詞條便通過幾個核心模板搭建成穩定全面的結構體系,新手編輯只需要復制一個已有的歌曲詞條,更改其中的小部分信息即可,更像是一個填表單的工作,大大降低了門檻和勞動量。
有一個問題就是,在一個龐大的Wiki中,模板的數量也是龐大的,新手編輯通常不太能知道,要實現某種功能,需要用哪個模板。這是每個人必經的一步,而且確實沒有速成的捷徑。所以你可以大方地在提問求助區或者向熟練編輯者提問,隨着日后代碼的閱讀量上去后,這就不再是問題了。另外,高級搜索里面是可以專門搜索模板的,可以根據自己的需求搜索關鍵詞,看看有沒有適用的模板。
如果沒有能夠滿足你需求的,而且又確實具有使用價值的模板,也可以在提問求助區描述你的需求,請其他人幫忙制作。模板的制作有一定的門檻,日后編輯熟練后,可以閱讀進階教程學習制作。
理論上,看到這里的你現在已經可以開始編輯甚至創建新頁面了;這篇基礎編輯入門中已經包含了我們平常99%的編輯需要用到的知識。你可以先從抄代碼開始,通過修改部分信息和預覽來熟悉常用模板的表現。
