這裏顯示兩個版本的差異處。
Both sides previous revision 前次修改 下次修改 | 前次修改 | ||
wiki:syntax [2014/09/29 18:20] 127.0.0.1 外部編輯 |
wiki:syntax [2014/12/04 10:36] elvis 還原成舊版 (2014/10/07 23:11) |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== | + | ====== |
- | [[doku> | + | [[doku>zh-tw: |
- | ===== Basic Text Formatting ===== | + | 譯者註:接下來就讓我們花點時間看一下吧,不一定要全懂,**建議**挑有用到、有興趣的先學,有其他問題或想學多點再來看這也可以。 |
- | DokuWiki supports **bold**, //italic//, __underlined__ and '' | ||
- | DokuWiki supports **bold**, //italic//, __underlined__ and '' | + | ===== 基本文字格式 ===== |
- | Of course you can **__//'' | + | |
- | You can use < | + | DokuWiki 支援**粗體**, |
- | | + | |
- | You can mark something as <del>deleted</del> as well. | + | 你也可以使用<sub>下標</sub> |
- | | + | |
+ | |||
+ | 當然你也可以標記某些文字為<del>刪節線</ | ||
- | **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line. | + | 當然你也可以標記某些文字為< |
+ | |||
+ | DokuWiki 使用**空行**來區分段落((也就是 XHTML 語法中的 < | ||
- | This is some text with some linebreaks\\ Note that the | + | Paragraphs are created from blank lines. |
- | two backslashes | + | |
- | or followed by\\ a whitespace | + | If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace |
- | This is some text with some linebreaks\\ Note that the | + | 實際顯示的結果為: |
- | two backslashes are only recognized at the end of a line\\ | + | |
- | or followed by\\ a whitespace \\this happens without it. | + | |
- | You should use forced newlines only if really needed. | + | Paragraphs are created from blank lines. |
- | ===== Links ===== | + | If you want to force a newline without a paragraph, you can use two backslashes followed by a whitespace or the end of line. |
- | DokuWiki supports multiple ways of creating links. | + | 若您想 **強制斷行**((也就是 XHTML 語法中的 < |
- | ==== External ==== | + | 這是一些有換行標記的文字。\\ 請注意: |
+ | 兩個倒斜線只在Enter之前\\ | ||
+ | 或者接在\\ 一個空格之前,才會有效。\\而這樣就並不起作用。 | ||
- | External links are recognized automagically: | + | 這是一些有換行標記的文字。\\ 請注意: |
+ | 兩個倒斜線只在Enter之前\\ | ||
+ | 或者接在\\ 一個空格之前,才會有效。\\而這樣就並不起作用。 | ||
- | DokuWiki supports multiple ways of creating links. External links are recognized | + | 您應該只在真正需要使用強制斷行的地方才用強制斷行。 |
- | automagically: | + | |
- | link text as well: [[http:// | + | |
- | addresses like this one: < | + | |
- | ==== Internal | + | ===== 連結 ===== |
- | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. | + | DokuWiki 可使用多種型態的連結,以下介紹各式連結用法: |
- | Internal links are created by using square brackets. You can either just give | + | ==== 外部連結 ==== |
- | a [[pagename]] or use an additional [[pagename|link text]]. | + | |
- | [[doku> | + | 若使用標準 URL Scheme (如 http:// |
+ | 此外,可以透過設定連結名稱(Linknames) 來設定連結的顯示,比如:[[http:// | ||
+ | 或者 email也可以用 < | ||
- | You can use [[some:namespaces]] by using a colon in the pagename. | + | 若使用標準 URL Scheme (如 http:// |
+ | 或只是 FQDN (如 www.google.com)都會被自動判斷為外部連結。 | ||
+ | 此外,可以透過設定連結名稱(Linknames) 來設定連結的顯示, | ||
+ | 比如:[[http:// | ||
+ | 或者 email也可以用 < | ||
- | You can use [[some: | + | ==== 內部連結 ==== |
- | For details about namespaces see [[doku> | + | 內部連結是用兩組中括號包裹要連結的頁面名稱來產生。 |
+ | 可以直接用 | ||
+ | 頁面名稱會被自動轉換成小寫英文字,並且不支援特殊符號。 | ||
+ | (中文頁面名稱雖然支援,但在某些部份並不完善,仍建議盡量使用英文頁面名稱 --- //[[reder.tseng@gmail.com|Reder]] 2008/06/05 04:58//) | ||
- | Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax# | + | 內部連結是用兩組中括號包裹要連結的頁面名稱來產生。 |
+ | 可以直接用 | ||
+ | 頁面名稱會被自動轉換成小寫英文字,並且不支援特殊符號。 | ||
+ | (中文頁面名稱雖然支援,但在某些部份並不完善,仍建議盡量使用英文頁面名稱) | ||
- | This links to [[syntax# | ||
- | Notes: | + | 也可以在頁面名稱前加上冒號「:」(colon)[[some: |
- | | + | |
- | * DokuWiki does not use [[wp> | + | |
- | * When a section' | + | |
- | ==== Interwiki ==== | + | 若想深入瞭解分類名稱(namespaces,或稱命名空間)空間請見 [[doku> |
- | DokuWiki supports [[doku> | + | 您也可以直接連結某個頁面的某章節段落。就像 HTML 一樣,只要在該頁後面加上 #某章節 就可以囉。比如: |
- | DokuWiki supports | + | 這會連到 |
- | For example this is a link to Wikipedia' | + | |
- | ==== Windows Shares ==== | + | 這會連到 [[: |
- | Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp> | + | 請注意: |
- | | + | |
+ | * 符合 [[wp> | ||
+ | - 駝峰文字(CamelCase)簡言之就是「幾個英文單字之間緊接著而沒有空格」所組成的詞彙,但每個單字的首字大寫,狀如駝峰([[dict> | ||
+ | - 如果在[[: | ||
+ | * 若章節所在的頁面標題改變了,那麼其連結也會跟着改變。因此請別過度依賴章節連結功能。 | ||
+ | * 此外可參考 [[: | ||
- | Notes: | + | ==== Wiki間的互連 ==== |
- | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone" | + | DokuWiki支援[[doku> |
- | | + | |
- | LANG.nosmblinks = ''; | ||
- | ==== Image Links ==== | + | ==== 網路芳鄰分享的連結 |
- | You can also use an image to link to another internal or external page by combining the syntax for links and [[# | + | MS Windows 主機使用 SMB((Server Message Block))協定,或稱為 CIFS((CommonInternet File System))的協定,可讓 MS Windows 主機可以將另一 MS Windows 主機目錄檔案當成是本機上的目錄檔案一般地使用,即所謂的網路芳鄰分享。而這個協定亦可以用於 Internet ,即位於不同網段的 Windows 主機也可使用此協定進行目錄檔案的分享(假如傳送過程中未有其他的網路設備阻擋時)。而其他 OS 像是 FreeBSD, Linux 也有相關 Samba 軟體來使用這項功能。 |
- | | + | 網芳資源可用 |
- | [[http:// | + | 網芳資源可用 |
- | Please note: The image formatting is the only formatting syntax accepted in link names. | + | 千萬要注意: |
- | The whole [[# | + | * 為了系統安全,直接瀏覽「網路芳鄰」功能只限於 Microsoft Internet Explorer 。 |
+ | * 請注意相關安全問題:鑒於 SMB 協定具有相當的便利性,但設定不夠完善的 Windows 主機(如密碼設定不夠安全或是未設定密碼)常讓外界使用者經此網路芳鄰分享,洩漏區域網路內相關檔案或系統上的機密資訊,甚至讓網路駭客完全控制該部主機。譬如 2001 年中的 Nimda 病毒就是經由網路芳鄰的方式散佈病毒至另一台保護不週的 Windows 主機上,以致造成感染病毒的速度加快。所以經由開放網路芳鄰分享於外界使用者,來增加與其他單位(如所屬機關、外部辦公室或駐外機構)的聯繫方便,同時亦可能形成安全上的漏洞,尤其是對保護不週的 Windows 主機而言。 | ||
+ | * Mozilla和Firefox的使用者,可採用[[http:// | ||
- | ===== Footnotes ===== | + | $lang[' |
- | You can add footnotes ((This is a footnote)) by using double parentheses. | + | ==== 圖片連結 ==== |
- | You can add footnotes ((This is a footnote)) by using double parentheses. | + | 也可透過使用圖片來連到wiki內部的頁面,或者其他的 URL ,比如: |
- | ===== Sectioning ===== | + | [[http:// |
- | You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically | + | [[http:// |
- | ==== Headline Level 3 ==== | + | 注意:在%%[[%%網址%%|%%連結名稱%%]]%%的「連結名稱」處,若用「%%{{%%%%}}%%」的話,則只能輸入圖檔名稱。 |
- | === Headline Level 4 === | + | |
- | == Headline Level 5 == | + | |
- | ==== Headline Level 3 ==== | + | DokuWiki支援完整的圖像和連結語法,包括圖像大小調整、內部和外部的圖像與連結,以及wiki內連結。 |
- | === Headline Level 4 === | + | |
- | == Headline Level 5 == | + | |
- | By using four or more dashes, you can make a horizontal line: | + | ===== 註解 ===== |
- | ---- | + | 您可以任意增加註解 ((這是示範註解)) ,怎麼用呢? |
+ | 把要註解的文字用兩組括號類似包水餃一樣包起來就好囉。 | ||
+ | 而註解的編號管理,請別擔心,DokuWiki 會自動幫您弄好。: | ||
- | ===== Media Files ===== | + | 您可以任意增加註解 ((這是示範註解)) ,怎麼用呢? |
+ | 把要註解的文字用兩組括號類似包水餃一樣包起來就好囉。 | ||
- | You can include external and internal [[doku> | + | ===== 目錄的層次結構 ===== |
+ | 一個層次分明的內容,加上有條不絮的說明文字,似乎總是最能令人消化吸收的。 | ||
- | Real size: {{wiki: | + | 我們可以透過設定最多至五種不同層次的標題,來完成目錄表的自動建構。 |
+ | 若該頁內有至少三個層次的標題,那麼 DOKUWIKI 就會自動產生相對應的目錄表(table of contents, TOC)。 | ||
+ | 不過若不想要「目錄表」的話,那麼只要在文章開頭打入%%~~NOTOC~~%%即可。 | ||
- | Resize to given width: | + | 標題是在左右各以等號「=」標示, |
+ | 從「%%==%%」到「%%======%%」,每多一個等號,則分別代表更高層次的標題。 | ||
- | Resize to given width and height((when the aspect ratio of the given width and height doesn' | + | 「%%======%%」有六個等號,是「第一級標題層次」, |
+ | 而本節目前是「%%===== 目錄的節次結構 =====%%」,也就是「第二級標題層次」 | ||
- | Resized external image: | ||
- | Real size: {{wiki: | + | ==== 第三級標題層次 ==== |
- | | + | === 第四級標題層次 === |
- | | + | == 第五級標題層次 == |
- | Resized external image: | + | |
+ | ==== 第三級標題層次 ==== | ||
+ | === 第四級標題層次 === | ||
+ | == 第五級標題層次 == | ||
- | By using left or right whitespaces you can choose the alignment. | + | 而連續四個短折號「-」(dash)所組成的 %%----%% 即可產生水平線。 |
+ | 舉例: | ||
+ | ↓ | ||
+ | ---- | ||
- | {{ wiki: | + | ===== 各種貼圖方式 ===== |
- | {{wiki: | + | === 貼圖語法 === |
+ | 可以用兩組重疊的 %%{{}}%% 花括號來貼圖或檔案,詳情請見 [[doku> | ||
+ | 也可以在編輯時用工具列的按鈕來完成。 | ||
- | {{ wiki: | + | 此外,還可指定圖檔的顯示大小。 |
- | {{ wiki:dokuwiki-128.png}} | + | 實際大小: |
- | {{wiki: | + | |
- | | + | |
- | Of course, you can add a title (displayed as a tooltip by most browsers), too. | + | 縮放為自訂的寬度(50 pixel): {{wiki: |
- | {{ wiki: | + | 縮放為自訂的大小(200x50)((若指定的長寬比與圖片本身不一致,在調整圖片大小前,它將被裁剪到新的比例)): |
- | | + | 縮放以URL連結的影像(100x100): |
- | For linking an image to another page see [[#Image Links]] above. | + | 實際大小: |
+ | 縮放為自訂的寬度(50 pixel): {{wiki: | ||
+ | 縮放為自訂的大小(200x50): | ||
+ | 縮放以URL連結的影像(100x100): | ||
- | ==== Supported Media Formats ==== | + | === 圖檔位置的搭配變化 |
+ | 也可運用 %%{{圖檔檔名}}%% 在括號與檔名之間插入空白的變化,來指定要放左、右或中間。 | ||
- | DokuWiki can embed the following media formats directly. | + | == 圖檔變化說明舉例 1 == |
+ | {{ wiki: | ||
- | | Image | '' | + | {{ wiki: |
- | | Video | '' | + | 這張會出現在右邊,注意到了嗎? |
- | | Audio | '' | + | |
- | | Flash | '' | + | |
+ | | ||
+ | 很簡單就可以把圖片靠右放置,對吧? | ||
- | If you specify a filename that is not a supported media format, then it will be displayed as a link instead. | + | == 圖檔變化說明舉例 2 == |
+ | {{wiki: | ||
- | ==== Fallback Formats ==== | + | {{wiki: |
+ | 這張會出現在左邊,注意到了嗎? | ||
+ | 檔名跟右邊的括號隔了一個空白唷~ | ||
+ | 這代表靠左放 | ||
+ | 換言之, | ||
+ | 很簡單就可以把圖片靠左放置,對吧? | ||
- | Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. | + | == 圖檔變化說明舉例 3 == |
+ | {{ wiki: | ||
- | For example consider this embedded mp4 video: | + | {{ wiki:dokuwiki-128.png }} |
+ | 這張會出現在中間,注意到了嗎? | ||
+ | 檔名跟左右兩邊的括號都隔了一個空白唷~ | ||
+ | 這代表往中間放 | ||
+ | 換言之, | ||
+ | 很簡單就可以把圖片居中放置,對吧? | ||
- | {{video.mp4|A funny video}} | + | === 幫圖片加上說明 === |
+ | 當然還可在圖片上加上「說明文字(title)」(在多數的瀏覽器上,滑鼠移到該圖上則會顯示)。 | ||
- | When you upload a '' | + | {{ wiki: |
- | Additionally DokuWiki supports a " | + | {{ wiki: |
- | ===== Lists ===== | + | 若您所指定的檔案(無論是內部連結或外部URL)並不是圖檔('' |
+ | ===== 項目表 | ||
- | Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a '' | + | DokuWiki 可使用項目表有兩種型態:數字及符號表。 |
+ | 要建立項目表的話,在該行前面先空出兩格,然後加上 | ||
+ | 或者改用 | ||
- | * This is a list | + | *這是項目表 |
- | * The second item | + | * 然而 |
- | * You may have different levels | + | * 也可以用不同層次的項目表來表達 |
- | * Another item | + | * 其他 |
- | - The same list but ordered | + | - 這也一樣是項目表,不過前面會加上編號 |
- | - Another item | + | - 第二項 |
- | - Just use indention for deeper levels | + | - 只要在 '' |
- | - That's it | + | - 第三項 |
+ | |||
+ | - 空行,則會結束列表,重新起算編號。 | ||
< | < | ||
- | * This is a list | + | *這是項目表 |
- | * The second item | + | * 然而 |
- | * You may have different levels | + | * 也可以用不同層次的項目表來表達 |
- | * Another item | + | * 其他 |
- | - The same list but ordered | + | - 這也一樣是項目表,不過前面會加上編號 |
- | - Another item | + | - 第二項 |
- | - Just use indention for deeper levels | + | - 只要在 '' |
- | - That's it | + | - 第三項 |
+ | |||
+ | - 空行,則會結束列表,重新起算編號。 | ||
</ | </ | ||
+ | ===== 文本轉換 ===== | ||
- | Also take a look at the [[doku> | + | DokuWiki可以將預定義的字符或者字符串轉換成圖片、其他文本或HTML。 |
- | ===== Text Conversions ===== | + | 文本到圖片的轉換,主要用作表情符號。文本到HTML的轉換,多用於顯示符號替換,但也可以配置為使用其他HTML。 |
- | DokuWiki can convert certain pre-defined characters or strings into images or other text or HTML. | + | ==== 表情符號 ==== |
- | The text to image conversion is mainly done for smileys. | + | DokuWiki 支援 [[wp> |
+ | 並且可以用 '' | ||
+ | 以下是目前 DokuWiki 所內建的表情符號表。 | ||
- | ==== Text to Image Conversions ==== | + | ^原始寫法^表情符號^ |
+ | |%%8-)%%|8-)| | ||
+ | |%%8-O%%|8-O| | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%=)%%|=)| | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%: | ||
+ | |%%; | ||
+ | |%%:?: | ||
+ | |%%: | ||
+ | |%%LOL%%|LOL| | ||
+ | |%%FIXME%%|FIXME| | ||
+ | |%%DELETEME%%|DELETEME| | ||
+ | 好用嗎?多介紹一個:「%%^_^%%」,它是很熟悉的笑臉:^_^。 | ||
- | DokuWiki converts commonly used [[wp> | + | ==== 顯示符號 ==== |
- | * 8-) %% 8-) | + | ^原始寫法^輸出的顯示符號(或結果)^ |
- | * 8-O %% 8-O | + | |%%->%%|->| |
- | * :-( %% :-( | + | |%%<-%%|<-| |
- | * :-) %% : | + | |%%<->%%|<->| |
- | * =) | + | |%%=>%%|=>| |
- | * :-/ %% : | + | |%%<=%%|<=| |
- | * :-\ %% : | + | |%%<=>%%|<=>| |
- | * :-? %% : | + | |%%>>%%|>>| |
- | * :-D %% :-D %% | + | |%%<<%%|<<| |
- | * :-P %% :-P %% | + | |%%--%%|--| |
- | * :-O %% :-O %% | + | |%%---%%|---| |
- | * :-X %% :-X | + | |%%640x480%%|640x480| |
- | * :-| %% :-| %% | + | |%%(c)%%|(c)| |
- | * ;-) %% ;-) %% | + | |%%(tm)%%|(tm)| |
- | * ^_^ %% | + | |%%(r)%%|(r)| |
- | * :?: %% :?: | + | |%%"He thought ' |
- | * :!: %% : | + | |
- | * LOL %% | + | |
- | * FIXME %% FIXME %% | + | |
- | * DELETEME %% DELETEME | + | |
- | ==== Text to HTML Conversions ==== | + | 注意: 若您不想要這項功能的話,可以在[[config|設定選項]]中關閉。 |
- | + | ||
- | Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. | + | |
- | + | ||
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | + | ||
- | < | + | |
- | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | + | |
- | "He thought ' | + | |
- | </ | + | |
- | The same can be done to produce any kind of HTML, it just needs to be added to the [[doku> | + | 您可以到[[doku> |
- | There are three exceptions which do not come from that pattern file: multiplication entity | + | 然而,上述例子中,有三個符號並非來自模式文件。它們是:乘號(640×480)、單引號( |
- | ===== Quoting | + | ===== 層次標示 |
- | Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: | + | 有時候(特別是討論時)您想把某些文字(尤為各次的回覆)標示作不同的層次,您可以使用下列的語法: |
- | | + | |
| | ||
- | > No we shouldn' | + | > 不,我們不該。 |
| | ||
- | >> | + | >> |
| | ||
- | > Really? | + | > 真的嗎? |
| | ||
- | >> | + | >> |
| | ||
- | >>> | + | >>> |
- | I think we should do it | + | 我想我們應該這麼做 |
- | > No we shouldn' | + | > 不,我們不該。 |
- | >> | + | >> |
- | > Really? | + | > 真的嗎? |
- | >> | + | >> |
- | >>> | + | >>> |
- | ===== Tables | + | ===== 表格 |
- | DokuWiki | + | DokuWiki建立表格的方式很簡單: |
- | ^ Heading | + | ^ 標題1 ^ 標題2 |
- | | Row 1 Col 1 | Row 1 Col 2 | + | | (1,1) |
- | | Row 2 Col 1 | some colspan (note the double pipe) || | + | | (2,1) | 水平合併示範(注意兩條豎線)|| |
- | | Row 3 Col 1 | Row 3 Col 2 | + | | (3,1) |
- | Table rows have to start and end with a '' | + | 以「< |
- | ^ Heading | + | ^ 標題1 ^ 標題2 |
- | | Row 1 Col 1 | Row 1 Col 2 | + | | (1,1) |
- | | Row 2 Col 1 | some colspan (note the double pipe) || | + | | (2,1) | 水平合併示範(注意兩條豎線)|| |
- | | Row 3 Col 1 | Row 3 Col 2 | + | | (3,1) |
- | To connect cells horizontally, | + | 要水平合併兩格或多格,只要把後方的設置為空即可,如上面所示。請確保每行都有相同數量的分隔符。 |
- | Vertical tableheaders are possible, too. | + | 標題也可用於「垂直欄位」上: |
- | | ^ Heading | + | | ^ 標題1 ^ 標題2 ^ |
- | ^ Heading | + | ^ 標題3 | (1,2) |
- | ^ Heading | + | ^ 標題4 | 這次不再合併了 |
- | ^ Heading | + | ^ 標題5 | (2,2) |
- | As you can see, it's the cell separator before a cell which decides about the formatting: | + | 方法就是直接在「標題3、4、5」前面加上「< |
- | | ^ Heading | + | | ^ 標題1 ^ 標題2 ^ |
- | ^ Heading | + | ^ 標題3 | (1,2) |
- | ^ Heading | + | ^ 標題4 | 這次不再合併了 |
- | ^ Heading | + | ^ 標題5 | (2,2) |
- | You can have rowspans (vertically connected cells) by adding '' | + | 您也可以垂直合併兩格或多格。只要在下面的格內輸入「< |
- | ^ Heading | + | ^ 標題1 ^ 標題2 |
- | | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | + | |(1,1)| 這次示範垂直合併 |
- | | Row 2 Col 1 | ::: | Row 2 Col 3 | | + | |(2,1)| ::: |
- | | Row 3 Col 1 | ::: | Row 2 Col 3 | | + | |(3,1)| ::: |
- | Apart from the rowspan syntax those cells should not contain anything else. | + | 除跨行合併語法「< |
- | ^ Heading | + | ^ 標題1 ^ 標題2 |
- | | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | + | |(1,1)| 這次示範垂直合併 |
- | | Row 2 Col 1 | ::: | Row 2 Col 3 | | + | |(2,1)| ::: |
- | | Row 3 Col 1 | ::: | Row 2 Col 3 | | + | |(3,1)| ::: |
- | You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. | + | 您還可以對齊表格的文字。只要在文本的相反方向添加至少兩個半型空格:如果要靠右對齊,在左邊添加兩個半型空格;反之,則在右邊添加。在兩邊均添加空格,即可以居中對齊。 |
- | ^ Table with alignment | + | ^ 對齊了的表格 |
- | | right| | + | | |
- | |left | + | |靠左對齊 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | This is how it looks in the source: | + | 下面是源文件中的樣子: |
- | ^ Table with alignment | + | ^ 對齊了的表格 |
- | | right| | + | | |
- | |left | + | |靠左對齊 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
- | Note: Vertical alignment is not supported. | + | 注意:不支援垂直對齊。 |
- | ===== No Formatting | + | ===== 無格式化 |
- | If you need to display text exactly like it is typed (without any formatting), | + | 若有一段文字,您不要它作格式化處理,要顯示作原來的樣子,請用「%%<nowiki></ |
- | < | + | < |
- | This is some text which contains addresses like this: http:// | + | |
- | </nowiki> | + | |
- | The same is true for %%//__this__ text// with a smiley ;-)%%. | + | |
- | < | + | < |
- | This is some text which contains addresses like this: http:// | + | 以及**加上格式的文字**,但它沒有給格式化。 |
- | | + | |
- | The same is true for %%//__this__ text// with a smiley ;-)%%. | + | |
- | ===== Code Blocks | + | ===== 代碼區塊 |
- | You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags '' | + | 在文字每一行的前方加上兩個半型空格,可使該段文字以「文字方塊」方式顯示出來。在文字方塊裏,所有文字都會無格式化。您也可以用 「%%<code></ |
- | | + | |
+ | 即使有**甚麼格式**標示了,它都不會[[格式化]]。 | ||
< | < | ||
- | This is preformatted code all spaces are preserved: like <-this | + | 這是沒有格式化的代碼,所有空格都保留下來。就像 |
</ | </ | ||
< | < | ||
- | This is pretty much the same, but you could use it to show that you quoted a file. | + | 這段也非常相似,但 |
+ | 您可以用它來表明 | ||
+ | | ||
</ | </ | ||
- | Those blocks were created by this source: | + | 這些區塊由下面的源碼產生出來: |
- | | + | |
+ | 即使有**甚麼格式**標示了,它都不會[[格式化]]。 | ||
< | < | ||
- | | + | |
</ | </ | ||
< | < | ||
- | | + | |
+ | 您可以用它來表明 | ||
+ | | ||
</ | </ | ||
- | ==== Syntax Highlighting | + | ===== 語法的高亮顯示 ===== |
- | [[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http:// | + | DokuWiki可把原始碼語法以高亮模式顯示,使它更易閱讀。它使用GeSHi通用語法高亮器,只要是GeSHi支援的,DokuWiki也支援。用法就類似前例的「%%< |
<code java> | <code java> | ||
- | /** | + | |
+ | /** | ||
* The HelloWorldApp class implements an application that | * The HelloWorldApp class implements an application that | ||
* simply displays "Hello World!" | * simply displays "Hello World!" | ||
*/ | */ | ||
+ | |||
class HelloWorldApp { | class HelloWorldApp { | ||
+ | |||
public static void main(String[] args) { | public static void main(String[] args) { | ||
System.out.println(" | System.out.println(" | ||
行 404: | 行 467: | ||
</ | </ | ||
- | The following language strings are currently recognized: | + | 目前支援的語言有: |
- | ==== Downloadable Code Blocks | + | ==== 可下載的代碼區塊 |
- | When you use the '' | + | 若您使用上述的「%%< |
< | < | ||
行 420: | 行 483: | ||
</ | </ | ||
- | If you don't want any highlighting but want a downloadable file, specify a dash ('' | + | 若您不想把語法高亮顯示出,但想方便瀏覽者下載,您可以用破折號「-」作語言代碼。例如:「%%<code - myfile.foo> |
- | ===== Embedding | + | ===== 在內容中嵌入 |
- | You can embed raw HTML or PHP code into your documents by using the '' | + | 可以在文件裏透過加入 |
- | HTML example: | + | < |
+ | 這是一段用 <font color=" | ||
+ | </ | ||
< | < | ||
< | < | ||
- | This is some <span style="color:red;font-size:150%;">inline | + | 這是一段用 |
</ | </ | ||
- | < | ||
- | <p style=" | ||
- | </ | ||
</ | </ | ||
- | <html> | + | <php> |
- | This is some <span style=" | + | echo '由 PHP 所產生的 Logo:'; |
- | </html> | + | echo '<img src="' |
- | < | + | ' |
- | <p style="border:2px dashed red;">And this is some block HTML</p> | + | alt="PHP Logo !" />'; |
- | </HTML> | + | </php> |
- | + | ||
- | PHP example: | + | |
< | < | ||
<php> | <php> | ||
- | echo 'The PHP version: '; | + | echo '由 PHP 所產生的 Logo:'; |
- | echo phpversion(); | + | echo '< |
- | echo ' (generated inline HTML)'; | + | ' |
+ | | ||
</ | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
</ | </ | ||
- | <php> | ||
- | echo 'The PHP version: '; | ||
- | echo phpversion(); | ||
- | echo ' (inline HTML)'; | ||
- | </ | ||
- | <PHP> | ||
- | echo '< | ||
- | echo '< | ||
- | echo '</ | ||
- | </ | ||
- | **Please Note**: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed. | ||
- | ===== RSS/ATOM Feed Aggregation ===== | + | **請特別注意**: |
- | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// | + | |
- | ^ Parameter | + | **譯者建議**: |
- | | any number | will be used as maximum number items to show, defaults to 8 | | + | --- 譯者://[[chinsan@FreeBSD.org|淡]] 2004/12/18 06:03// |
- | | reverse | + | |
- | | author | + | |
- | | date | show item dates | | + | |
- | | description| show the item description. If [[doku> | + | |
- | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | + | |
- | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki: | + | ===== RSS/ATOM Feed聚合 ===== |
- | **Example:** | + | DokuWiki能從外部XML feed中聚合數據。為分析這些XML feed,DokuWiki使用了[[http:// |
+ | |||
+ | ^ 參數 | ||
+ | | any number | 最多顯示多少項內容;預設值是8。 | | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | 顯示條目數據。 | | ||
+ | | description| 顯示條目的描述;如果[[doku> | ||
+ | | //n//[dhm] | 刷新周期,其中,d=日數,h=小時數,m=分。例如,12h=12小時。 | | ||
+ | |||
+ | 預設的刷新周期是4小時。小於10分鐘者亦視為10分鐘。DokuWiki通常會提供頁面的暫存版,但這做法不適用於包含動態外部內容的頁面。上面的參數則告訴DokuWiki:若對上一次渲染時間已經過了// | ||
+ | |||
+ | **範例:** | ||
{{rss> | {{rss> | ||
行 493: | 行 544: | ||
- | ===== Control Macros | + | ===== 控制巨集 |
- | + | ||
- | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | + | |
- | + | ||
- | ^ Macro ^ Description | | + | |
- | | %%~~NOTOC~~%% | + | |
- | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | + | |
- | ===== Syntax Plugins ===== | + | 有些語法會影響DokuWiki對頁面的渲染,而自身不輸出任何內容。可用的控制巨集如下: |
- | DokuWiki's syntax can be extended by [[doku>plugins|Plugins]]. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular | + | ^ 巨集 |
+ | | %%~~NOTOC~~%% | ||
+ | | %%~~NOCACHE~~%% | DokuWiki預設會緩存所有的輸出。有時您並不希望這樣(例如您使用了上述的%%< | ||
- | ~~INFO: | + | ===== 語法附加元件 ===== |
+ | 運用[[doku> |