笈成資料庫

自由的中醫典籍資料庫

使用者工具

網站工具


help:維基語法

維基語法

段落

DokuWiki 使用「空二行」區分段落1),如下:

範例

單一換行只代表 XHTML 原始碼的換行,實際顯示出來會是半形空白,如下:

範例

可用「雙反斜線+半形空白」或「雙反斜線+換行」強制單換行2),「雙反斜線」後若非前二者也不會換行。

範例

一般情況請盡量使用「段落」建立完整的文章,「強制斷行」請只在必要的情況使用,使用時盡量後面加上換行而非半形空白,原始碼比較好懂。

基本格式語法

本系統支援以下格式語法。

說明 語法 效果
粗體3) **粗體** 粗體
斜體4) //斜體// 斜體
底線5) __底線__ 底線
等寬字6) ''等寬'' 等寬
下標 H<sub>2</sub>O H2O
上標 y = x<sup>2</sup> + 1 y = x2 + 1
刪除線 <del>刪除線</del> 刪除線

以上效果可以巢狀組合,例如:

語法 效果
**//粗斜體 H<sub>2</sub>O <del>後面寫錯了</del>//** 粗斜體 H2O 後面寫錯了

超連結

內部連結

超連結的語法為 [[頁面名稱]][[頁面名稱|標示文字]]。如果沒有設定標示文字,則系統自動取頁面的第一個標題當作標示文字。

語法 效果 說明
簡單連結 [[會員功能]] 會員功能
自定標示文字的連結 [[會員功能|想知道加入會員有什麼好康嗎?]] 想知道加入會員有什麼好康嗎?
也可以給圖片加上連結 [[會員功能|{{:wiki:dokuwiki-128.png|}}]]
但只限於一張圖片,前後加東西都會失效 [[會員功能|{{:wiki:dokuwiki-128.png|}}←按我]] {{:wiki:dokuwiki-128.png|}}←按我

可在連結後端加上 #章節,以連向該頁面某標題的位置。7)

說明 語法 效果
連向本頁的章節 [[#內部連結]] 內部連結
連向其他頁面的章節 [[talk:index#討論主題範例]] 討論主題範例

可在連結後端加上 ?參數,以執行特定功能。

說明 語法 效果
匯出頁面為 XHTML (含樣式) [[維基語法?do=export_xhtml]] 維基語法
匯出頁面為純 XHTML [[維基語法?do=export_xhtmlbody]] 維基語法
匯出頁面原始碼 [[維基語法?do=export_raw]] 維基語法

維基的頁面由半形冒號 (:) 分隔為不同的命名空間 (Nnamespace),不含冒號者為相對路徑,例如目前頁面是 help:維基語法,命名空間就是 help,所以本頁中的 [[會員功能]] 會連到 help:會員功能 頁面。

含有冒號則是絕對路徑,故本頁中的 [[book:index]] 會連到 book:index 頁面。(而非 help:book:index

說明 語法 效果
不含:表示相對路徑 [[會員功能]] 會員功能
含有:表示絕對路徑 [[book:index]] 典籍總表
頭部:表示強制絕對路徑 [[:index]] 笈成資料庫
尾部:表示命名空間相關8) [[book:傷寒論宋本:]] 傷寒論宋本
頭部.表示目前命名空間 [[.index]] 操作協助
頭部.:表示目前命名空間 [[.:index]] 操作協助
頭部..表示上一層命名空間 [[..index]] 笈成資料庫
頭部..:表示上一層命名空間 [[..:index]] 笈成資料庫
頭部..:可以多層使用,不過到最上層就停止 [[..:..:index]] 笈成資料庫

外部連結

與內部連結相同,只是把「頁面名稱」改為完整網址。此外,如果一串網址不含 ASCII 以外的字元,也會自動產生連結。

本站的外部連結點擊後都會開啟在新視窗。

說明 語法 效果
自動產生連結 http://www.google.com http://www.google.com
ASCII 字元不會被當做網址 http://www.中文.tw http://www.中文.tw
不設定標示文字 [[http://www.google.com]] http://www.google.com
設定標示文字 [[http://www.google.com|Google]] Google

跨維基連結

與內部連結相同,只是把「頁面名稱」改為 跨維基入口>頁面名稱,即會連到對應網站中的對應頁面;此外跨維基連結通常都有特定的小圖示,依管理員的設定而定。

本站的跨維基連結點擊後都會開啟在新視窗。

幾個常用的跨維基入口如下:

說明 語法 效果
笈成站台 [[jc>|笈成首頁]] 笈成首頁
中文維基百科 [[w>中文]] 中文
英文維基百科 [[wp>Chinese]] Chinese
日文維基百科 [[wpjp>漢字]] 漢字
中文維基文庫 [[ws>傷寒論]] 傷寒論
DokuWiki 官網 [[doku>DokuWiki]] DokuWiki
Google 搜尋 [[google>笈成]] 笈成

電子郵件連結

說明 語法 效果
簡易 E-mail 連結 <someone@hotmail.com> someone@hotmail.com
用連結的方式也行 (不用輸入 mailto:) [[someone@hotmail.com|寫信給someone]] 寫信給someone

圖片與附檔

在編輯工具列中,可用[加入圖片或檔案]按鈕上傳圖片或附檔,並在內文插入。圖片與附檔的語法和超連結一樣,只是改成雙大括號 {{ }}

說明 語法 效果
插入圖片 {{:wiki:dokuwiki-128.png}} dokuwiki-128.png
插入外部圖片 {{http://upload.wikimedia.org/wikipedia/commons/0/0a/Wikipedia-logo-v2-zh.png}} Wikipedia-logo-v2-zh.png
非 .jpg .gif .png 皆視為附檔 {{:wiki:blah.zip}} blah.zip
指定標示文字的圖片(滑鼠移上即可看到) {{:wiki:dokuwiki-128.png|標示文字}} 標示文字
指定標示文字的附檔 {{:wiki:blah.zip|標示文字}} 標示文字

也可以指定大小,語法是加上 ?寬?寬x高

說明 語法 效果
實際大小 {{:wiki:dokuwiki-128.png}} dokuwiki-128.png
指定寬度(50px)9) {{:wiki:dokuwiki-128.png?50}} dokuwiki-128.png
指定寬度及高度(200x50)10) {{:wiki:dokuwiki-128.png?200x50}} dokuwiki-128.png

也可以指定對齊方式,在想靠的方向的反側加上一個空白即可。

{{ :wiki:dokuwiki-128.png}}
這張會出現在右邊。
檔名與左邊的括號隔了一個空白,代表浮動靠右。

dokuwiki-128.png 這張會出現在右邊。 檔名與左邊的括號隔了一個空白,代表浮動靠右。

{{:wiki:dokuwiki-128.png }}
這張會出現在左邊。
檔名與右邊的括號隔了一個空白,代表浮動靠左。

dokuwiki-128.png 這張會出現在左邊。 檔名與右邊的括號隔了一個空白,代表浮動靠左。

{{ :wiki:dokuwiki-128.png }}
這張會出現在中間。
檔名與左右邊的括號都隔了一個空白,代表置中(不浮動)。

dokuwiki-128.png 這張會出現在中間。 檔名與左右邊的括號都隔了一個空白,代表置中(不浮動)。

章節結構

標題

有層次、有條理的章節結構,較容易消化吸收。本系統可設定最多5層的標題,標題下的內容會自動歸入相應章節,產生縮排,方便連結,也允許用「改這段」編輯。如果頁面中有至少三個層次的標題,系統就會自動產生相對應的目錄表 (Table of Contents, TOC)。

語法很簡單,二邊用等於包起來即可,請注意,標題必須佔滿一整行,等號前後不能有其他東西。

====== 第1級標題 ======
===== 第2級標題 =====
==== 第3級標題 ====
=== 第4級標題 ===
== 第5級標題 ==

(為了不打亂本頁的章節結構,呈現效果就省略了)

水平線

使用四個減號即可產生水平線。

下面有水平線
----
上面有水平線

下面有水平線


上面有水平線

腳註

使用二個半形括號即可建立腳註。腳註會統一放在頁末,滑鼠移過腳註會顯示內容,也可以點擊連結連過去。

這是一段文字((前後用二個半形括號括起來的部分就是腳註,會統一顯示在頁末))。

這是一段文字11)

第一段文字((腳註內容相同會放在一起)),第二段文字((腳註內容相同會放在一起))。

第一段文字12),第二段文字13)

引用

要引述文字時,可在行首加上一個或以上的 >,就會有層次了。

>引文
>引文接行
>再接再勵

>中間空行則換段
>
>
>不想換段就接空引文
>

>有人在嗎?
>>我就是
>>回文第二行
>>回文第三行
>>>下一層回文
>>>下一層回文第二行
>>>>還有下一層?
> >>有空白就斷了...別以為這是第三層
引文
引文接行
再接再勵
中間空行則換段


不想換段就接空引文
有人在嗎?
我就是
回文第二行
回文第三行
下一層回文
下一層回文第二行
還有下一層?

»有空白就斷了…別以為這是第三層

列表

本系統支援列表,分為有序與無序二種格式。在行首空出兩格,然後加上 * 即可產生無序列表,或用 - 產生有序列表。

  * 列表第一項
  * 列表第二項
    * 前面多加二個空格就會向內縮
      * 再縮
        * 再再縮
  * 回到前一層
  - 有序列表第一項
  - 有序列表第二項
    - 第二層
      * 列表可以交錯使用
  - 有序列表第第三項

  - 空行則會結束列表,編號重新起算。
不是列表的行,當然也會結束。
  - 新的列表
  • 列表第一項
  • 列表第二項
    • 前面多加二個空格就會向內縮
      • 再縮
        • 再再縮
  • 回到前一層
  1. 有序列表第一項
  2. 有序列表第二項
    1. 第二層
      • 列表可以交錯使用
  3. 有序列表第第三項
  1. 空行則會結束列表,編號重新起算。

不是列表的行,當然也會結束。

  1. 新的列表

表格

本系統支援簡單的表格,如下:

^ 標題一        ^ 標題二                  ^ 標題三                    ^
| 第1行,第1列  | 第1行,第2列            | 第1行,第3列              |
| 第2行,第1列  | 合併兩欄(後面多個豎號)                             ||
| 第3行,第1列  | 合併兩列(下列三個冒號)  | 第3行,第3列              |
| 第4行,第1列  | :::                     | 第4行,第3列              |
標題一 標題二 標題三
第1行,第1列 第1行,第2列 第1行,第3列
第2行,第1列 合併兩欄(後面多個豎號)
第3行,第1列 合併兩列(下列三個冒號) 第3行,第3列
第4行,第1列 第4行,第3列

也可以指定文字靠左靠右置中,只要在想靠的相反方向加2個以上的空格即可。左邊加2個空白則靠右,右邊加2個空白則靠左,左右兩邊都加2個空白即置中,二邊都不到2個空白則預設左右對齊14)

^           設定對齊方式的表格           ^^^
|           靠右|      置中     |靠左           |
| 靠左          |          靠右 |      置中     |
|  xxxxxxxxxxx  |  xxxxxxxxxxx  |  xxxxxxxxxxx  |
設定對齊方式的表格
靠右 置中 靠左
靠左 靠右 置中
xxxxxxxxxxx xxxxxxxxxxx xxxxxxxxxxx

原始碼

不格式化段落

<nowiki>不格式化**粗體字**,看到了嗎?</nowiki>

不格式化**粗體字**,看到了嗎?

%%另一種**不格式化**的方式。%%

另一種**不格式化**的方式。

原始碼區塊

1.行首空白

  行首二個空白,就會變成原始碼區塊。
  第二行
  第三行
行首二個空白,就會變成原始碼區塊。
第二行
第三行

2.<code>

<code>使用code標籤嵌入原始碼區塊(不格式化**粗體字**)</code>
使用code標籤嵌入原始碼區塊(不格式化**粗體字**)

3.<file>

<file>使用file標籤嵌入原始碼區塊,除了顏色以外效果完全相同,一般用於標示檔案(不格式化**粗體字**)</file>
使用file標籤嵌入原始碼區塊,除了顏色以外效果完全相同,一般用於標示檔案(不格式化**粗體字**)

4.<code> 和 <file> 的參數

DokuWiki 可對程式原始碼上色,以增加可讀性。支援上色的程式語言包括 java, javascript, dos, html, css, xml, php15) 等等,不指定語言就預設用 text (純文字)。

<code html>
<p><b>上色一段html</b></p>
<p class="special"><span style="color:red">下一段html</span></p>
</code>
<p><b>上色一段html</b></p>
<p class="special"><span style="color:red">下一段html</span></p>

還可以指定第三個參數,系統會建立一個下載程式碼的連結,檔名可自由填寫:

<code html myindex.html>
<p><b>一段html</b></p>
<p class="red"><b>另一段</b></p>
</code>
myindex.html
<p><b>一段html</b></p>
<p class="red"><b>另一段</b></p>

字元處理

表情符號

本系統支援 emoticon 常用的表情符號,以下是目前內建的表情符號表,一般不用記,編輯工具按一按就有了。

寫法 符號
8-) 8-)
8-O 8-O
:-( :-(
:-) :-)
=) =)
:-/ :-/
:-\ :-\
:-? :-?
:-D :-D
:-P :-P
:-O :-O
:-X :-X
:- | :-|
;-) ;-)
:?: :?:
:!: :!:
LOL LOL
FIXME FIXME
DELETEME DELETEME

縮寫詞

本系統已內定了一些常用縮寫詞,只要前後有英文詞界(半形空白或換行),即會自動轉換。

說明 語法 效果
有詞界即自動轉換 HTML XML RTFM HTML XML RTFM
目前只定義了大寫詞,小寫不轉換 html xml rtfm html xml rtfm
前面有中文沒空白不行 中文HTML ,XML RTFM 中文HTML ,XML RTFM
後面有中文沒空白不行 HTML中文 XML, RTFM HTML中文 XML, RTFM

缺字處理

本系統與笈成檢字系統整合,可自動將 Unicode 罕用字及已定義的 IDS 組字式自動轉為圖片呈現(詳見缺字處理)。要輸入一個缺字,您可先到笈成檢字系統的一般搜尋進階搜尋查字,再把找到的「組字式」貼入編輯欄位即可。

參考資料

1)XHTML 語法中的 <p></p>
2)XHTML 語法中的 <br/>
3) XHTML 的 <strong>
4) XHTML 的 <em>
5) XHTML 的 <em> 加上樣式
6) 等寬字(monospace)主要用於半形英數字元,使其寬度剛好是漢字的一半。
7) 章節連結時,所有英文字母都要用小寫,標點符號及半形空白都要換成底線_
8)book:傷寒論宋本: 會因頁面存在與否依序連向 book:傷寒論宋本:indexbook:傷寒論宋本:傷寒論宋本book:傷寒論宋本,都不存在則進入 book:傷寒論宋本:index
9) 只指定寬度時,系統會按等比例縮放圖片。比如原圖是 128x128,指定寬度 64,則呈現結果為 64x64。
10) 指定寬度和高度時,系統會先調到符合的大小,再切除二側。比如原圖是 128x128,指定 64x20,則先等比例縮放為 64x64,再把上下各截去 22px 只留下中間的 20px,最後呈現結果為 64x20。
11) 前後用二個半形括號括起來的部分就是腳註,會統一顯示在頁末
12) , 13) 腳註內容相同會放在一起
14) 有些瀏覽器不支援左右對齊,如 IE 6,此時呈現為靠左
15) 支援上色的程式語言可參見官網的列表
help/維基語法.txt · 上一次變更: 2011/01/25 23:09 由 admin