「使用說明:樣板」修訂間的差異
出自 MozTW Wiki
(→建立樣板) |
(→簡單的樣板示範) |
||
(未顯示由 5 位使用者於中間所作的 13 次修訂) | |||
行 1: | 行 1: | ||
<h1> MediaWiki 的樣板語法 </h1> | <h1> MediaWiki 的樣板語法 </h1> | ||
+ | |||
+ | 樣板在必須使用<b>大量類似的語法</b>的時候,是一個很方便的工具。當樣版定義好了之後,每次遇到類似的格式,只需要呼叫該樣板,並且指定變數的值。相較於每次都重複輸入這個格式,使用樣板一方面可以使的版面更簡潔,更重要的是,將來該版面需要修改的時候,只需修改樣板,所有套用這個樣板的文章都會<b>隨者一起修正</b>。這個特性是管理文章的一大利器。 | ||
==簡單的樣板示範== | ==簡單的樣板示範== | ||
首先先我們先看一下樣板的效果 | 首先先我們先看一下樣板的效果 | ||
− | *以下是 [[Template:Template Example 1]] | + | *以下是 [[Template:Template Example 1]]: |
:<pre> | :<pre> | ||
:{{{1}}} + {{{2}}} = {{{1}}} {{{2}}} | :{{{1}}} + {{{2}}} = {{{1}}} {{{2}}} | ||
:</pre> | :</pre> | ||
:依下面的的方式呼叫 <b>Template:Template Example 1 </b><br> | :依下面的的方式呼叫 <b>Template:Template Example 1 </b><br> | ||
− | :<nowiki>{{Template Example 1 | a | b }} 會變成</nowiki> {{Template Example 1|a|b}}<br> | + | :<nowiki>{{Template Example 1 | a | b }} 會變成</nowiki> {{Template Example 1|a|b}}。<br> |
− | :左邊的寫法被稱為呼叫(或是引用)樣板,而其中的 a、b | + | :左邊的寫法被稱為呼叫(或是引用)樣板,而其中的 a、b 則是呼叫樣板的參數。而右邊的則是經過Wiki參數代換的結果。<br> |
− | :<b>注意到左邊的 a、b 被填進原本是 <nowiki>{{{1}}}、{{{2}}}</nowiki> | + | :<b>注意到左邊的 a、b 被填進原本是 <nowiki>{{{1}}}、{{{2}}}</nowiki> 的位置。</b> |
− | |||
*同樣一個樣板我們改用 [[Template:Template Example 2]]的寫法: | *同樣一個樣板我們改用 [[Template:Template Example 2]]的寫法: | ||
行 19: | 行 20: | ||
:</pre> | :</pre> | ||
:同時呼叫的方式修正一下 : | :同時呼叫的方式修正一下 : | ||
− | :<nowiki>{{Template Example 2 | FirstARG=A | SecondARG=B }} </nowiki> 會變成:{{Template Example 2|FirstARG=A|SecondARG=B}}<br> | + | :<nowiki>{{Template Example 2 | FirstARG=A | SecondARG=B }} </nowiki> 會變成:{{Template Example 2|FirstARG=A|SecondARG=B}}。<br> |
− | :<b>現在 A、B 變成被填進 <nowiki>{{{FirstARG}}}、{{{SecondARG}}}</nowiki> | + | :<b>現在 A、B 變成被填進 <nowiki>{{{FirstARG}}}、{{{SecondARG}}}。</nowiki></b> |
==建立樣板== | ==建立樣板== | ||
− | 要建立樣板,首先新增一個名為 "Tamplate:樣板名稱" 的頁面。 | + | 要建立樣板,首先新增一個名為 <b>"Tamplate:樣板名稱"</b> 的頁面。 |
− | 在這個新頁面裡,可以依照 Wiki | + | 在這個新頁面裡,可以依照 Wiki 的語法任意編輯,而這些編輯出來的東西,就會成為套用樣板時重複出現的元素。<br> |
− | + | 至於希望在各頁面之間有所不同的部分,我們必須指定給他們變數。變數的語法是用<b>左右各三個花括弧</b>將變數名稱包起來,例如:<nowiki>{{{MyName}}}或是{{{Weather}}}。其中,如果你的變數命名是用由1開始的數字,如{{{1}}} 、{{{2}}}、{{{3}}}......</nowiki>,則接下來的呼叫使用會略有不同。<br> | |
為了下一節示範的方便,我在這裡建立兩個稍微複雜的樣板: | 為了下一節示範的方便,我在這裡建立兩個稍微複雜的樣板: | ||
− | *<i>Template:Template Example 3</i> | + | *<i>[[Template:Template Example 3]]</i> |
<pre> | <pre> | ||
− | Hi~ 大家好,我的名字是{{{MyName}}},我是{{{MyGender}}}。 | + | Hi~ 大家好,我的名字是{{{MyName}}},我是{{{MyGender}}},我的年齡是{{{MyAge}}}。 |
我幫大家示範一下複雜的語法,如表格,也可以用樣板做出來喔。 | 我幫大家示範一下複雜的語法,如表格,也可以用樣板做出來喔。 | ||
{| border="1" | {| border="1" | ||
− | ! | + | !姓名 |
− | ! | + | !性別 |
− | ! | + | !年齡 |
|- | |- | ||
− | ||{{{ | + | ||{{{MyName}}} |
− | ||{{{ | + | ||{{{MyGender}}} |
− | ||{{{ | + | ||{{{MyAge}}} |
|} | |} | ||
</pre> | </pre> | ||
− | *<i>Template:Template Example 4</i> | + | *<i>[[Template:Template Example 4]]</i> |
<pre> | <pre> | ||
既然表格已經示範過了,我來示範自動編號吧 | 既然表格已經示範過了,我來示範自動編號吧 | ||
− | #{{{1}}} | + | #<b>{{{1}}}</b> |
− | # | + | #*{{{4}}} |
− | # | + | #*{{{5}}} |
− | #{{{2}}} | + | #<b>{{{2}}}</b> |
− | # | + | #*{{{6}}} |
− | # | + | #*{{{7}}} |
− | #{{{3}}} | + | #<b>{{{3}}}</b> |
</pre> | </pre> | ||
==呼叫樣板== | ==呼叫樣板== | ||
to be continued... | to be continued... |
於 2009年5月3日 (日) 16:15 的最新修訂
MediaWiki 的樣板語法
樣板在必須使用大量類似的語法的時候,是一個很方便的工具。當樣版定義好了之後,每次遇到類似的格式,只需要呼叫該樣板,並且指定變數的值。相較於每次都重複輸入這個格式,使用樣板一方面可以使的版面更簡潔,更重要的是,將來該版面需要修改的時候,只需修改樣板,所有套用這個樣板的文章都會隨者一起修正。這個特性是管理文章的一大利器。
簡單的樣板示範
首先先我們先看一下樣板的效果
- {{{1}}} + {{{2}}} = {{{1}}} {{{2}}}
- 依下面的的方式呼叫 Template:Template Example 1
- {{Template Example 1 | a | b }} 會變成 a + b = a b。
- 左邊的寫法被稱為呼叫(或是引用)樣板,而其中的 a、b 則是呼叫樣板的參數。而右邊的則是經過Wiki參數代換的結果。
- 注意到左邊的 a、b 被填進原本是 {{{1}}}、{{{2}}} 的位置。
- 同樣一個樣板我們改用 Template:Template Example 2的寫法:
- {{{FirstARG}}} + {{{SecondARG}}} = {{{FirstARG}}} {{{SecondARG}}}
- 同時呼叫的方式修正一下 :
- {{Template Example 2 | FirstARG=A | SecondARG=B }} 會變成:A + B = A B。
- 現在 A、B 變成被填進 {{{FirstARG}}}、{{{SecondARG}}}。
建立樣板
要建立樣板,首先新增一個名為 "Tamplate:樣板名稱" 的頁面。
在這個新頁面裡,可以依照 Wiki 的語法任意編輯,而這些編輯出來的東西,就會成為套用樣板時重複出現的元素。
至於希望在各頁面之間有所不同的部分,我們必須指定給他們變數。變數的語法是用左右各三個花括弧將變數名稱包起來,例如:{{{MyName}}}或是{{{Weather}}}。其中,如果你的變數命名是用由1開始的數字,如{{{1}}} 、{{{2}}}、{{{3}}}......,則接下來的呼叫使用會略有不同。
為了下一節示範的方便,我在這裡建立兩個稍微複雜的樣板:
Hi~ 大家好,我的名字是{{{MyName}}},我是{{{MyGender}}},我的年齡是{{{MyAge}}}。 我幫大家示範一下複雜的語法,如表格,也可以用樣板做出來喔。 {| border="1" !姓名 !性別 !年齡 |- ||{{{MyName}}} ||{{{MyGender}}} ||{{{MyAge}}} |}
既然表格已經示範過了,我來示範自動編號吧 #<b>{{{1}}}</b> #*{{{4}}} #*{{{5}}} #<b>{{{2}}}</b> #*{{{6}}} #*{{{7}}} #<b>{{{3}}}</b>
呼叫樣板
to be continued...