diff --git a/content.html b/content.html index 288973e..f56e317 100644 --- a/content.html +++ b/content.html @@ -2,7 +2,7 @@

Markdown

-

NOTE: This is Traditional Chinese Edition Document of +

NOTE: This is Traditional Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax.

@@ -12,7 +12,7 @@ Document. Please refer to 概述
  • 區塊元素 @@ -39,7 +39,7 @@ Document. Please refer to 感謝
    • -

    注意：這份文件是用Markdown寫的，你可以看看它的原始檔。

    +

    注意：這份文件是用Markdown寫的，你可以看看它的原始檔 。

    @@ -49,7 +49,7 @@ Document. Please refer to Setext、atx、Textile、reStructuredText、Grutatext和EtText，然而最大靈感來源其實是純文字的電子郵件格式。

    +

    不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈，並且看起來不會像是由許多標籤或是格式指令所構成。Markdown語法受到一些既有text-to-HTML格式的影響，包括Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而最大靈感來源其實是純文字的電子郵件格式。

    因此Markdown的語法全由標點符號所組成，並經過嚴謹慎選，是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號，看起來就像*強調*。Markdown的清單看起來，嗯，就是清單。假如你有使用過電子郵件，區塊引言看起來就真的像是引用一段文字。

    @@ -57,11 +57,11 @@ Document. Please refer to 特殊字元自動轉換 -

    在HTML文件中，有兩個字元需要特殊處理：<和&。<符號用於起始標籤，&符號則用於標記HTML實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是&lt;和&amp;。

    +

    在HTML文件中，有兩個字元需要特殊處理：<和&。<符號用於起始標籤&符號則用於標記HTML實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是&lt;和&amp;。

    -

    &符號其實很讓寫作網路文件的人感到困擾，如果你要打「AT&T」，你必須要寫成「AT&amp;T」，還得轉換網址內的&符號，如果你要連結到：

    +

    & 符號其實很容易讓寫作網路文件的人感到困擾，如果你要打「AT&T」 ，你必須要寫成「AT&amp;T」 ，還得轉換網址內的 & 符號，如果你要連結到：

    http://images.google.com/images?num=30&q=larry+bird
    @@ -113,7 +113,7 @@ This is another regular paragraph. 
    AT&amp;T
    -

    類似的狀況也會發生在<符號上，因為Markdown支援行內HTML，如果你是使用<符號作為HTML標籤使用，那Markdown也不會對它做任何轉換，但是如果你是寫：

    +

    類似的狀況也會發生在<符號上，因為Markdown支援行內 HTML ，如果你是使用<符號作為HTML標籤使用，那Markdown也不會對它做任何轉換，但是如果你是寫：

    4 < 5
    @@ -123,7 +123,7 @@ This is another regular paragraph. 
    4 &lt; 5
    -

    不過需要注意的是，code範圍內，不論是行內還是區塊，<和&兩個符號都一定會被轉換成HTML實體，這項特性讓你可以很容易地用Markdown寫HTML code（和HTML相對而言， HTML語法中，你要把所有的<和&都轉換為HTML實體，才能在HTML文件裡面寫出HTML code。）

    +

    不過需要注意的是，code範圍內，不論是行內還是區塊，<和&兩個符號都一定會被轉換成HTML實體，這項特性讓你可以很容易地用Markdown寫HTML code（和HTML相對而言。在HTML語法中，你要把所有的<和&都轉換為 HTML實體，才能在HTML文件裡面寫出HTML code。）

    @@ -137,7 +137,7 @@ This is another regular paragraph.

    如果你真的想要插入<br />標籤的話，在行尾加上兩個以上的空白，然後按enter。

    -

    是的，這確實需要花比較多功夫來插入<br />，但是「每個換行都轉換為<br />」的方法在 Markdown中並不適合，Markdown中email式的區塊引言和多段落的清單在使用換行來排版的時候，不但更好用，還更好閱讀。

    +

    是的，這確實需要花比較多功夫來插入<br />，但是「每個換行都轉換為<br />」的方法在Markdown中並不適合， Markdown中email式的區塊引言和多段落的清單在使用換行來排版的時候，不但更好用，還更好閱讀。

    @@ -154,7 +154,7 @@ This is an H2

    任何數量的=和-都可以有效果。

    -

    Atx形式則是在行首插入1至6個#，對應到標題1到6階，例如：

    +

    Atx形式則是在行首插入1到6個 # ，各對應到標題1到6階，例如：

    # This is an H1
 
@@ -172,7 +172,7 @@ This is an H2
 ### This is an H3 ######
    -

    Blockquotes

    +

    區塊引言

    Markdown使用email形式的區塊引言，如果你很熟悉如何在email信件中引言，你就知道怎麼在Markdown文件中建立一個區塊引言，那會看起來像是你強迫斷行，然後在每行的最前面加上>：

    @@ -296,7 +296,7 @@ viverra nec, fringilla in, laoreet vitae, risus. Suspendisse id sem consectetuer libero luctus adipiscing. -

    如果清單項目間用空行分開，Markdown會把項目的內容在輸出時用<p>標籤包起來，舉例來說：

    +

    如果清單項目間用空行分開， Markdown會把項目的內容在輸出時用<p>標籤包起來，舉例來說：

    *   Bird
 *   Magic
@@ -325,7 +325,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
 </ul>
    -

    清單項目可以包含多個段落，每個項目下的段落都必須縮排4個空白或是一個tab ：

    +

    清單項目可以包含多個段落，每個項目下的段落都必須縮排4個空白或是一個tab：

    1.  This is a list item with two paragraphs. Lorem ipsum dolor
     sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@@ -393,7 +393,7 @@ sit amet, consectetuer adipiscing elit.
 </code></pre>
    -

    這個每行一階的縮排（4個空白或是tab），都會被移除，例如：

    +

    這個每行一階的縮排（4個空白或是1個tab），都會被移除，例如：

    Here is an example of AppleScript:
 
@@ -414,7 +414,7 @@ end tell
 
 
    一個程式碼區塊會一直持續到沒有縮排的那一行（或是文件結尾）。
    
 
-
    在程式碼區塊裡面，&、<和>會自動轉成HTML實體，這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼，只需要複製貼上，再加上縮排就可以了，剩下的 Markdown都會幫你處理，例如：
    
+
    在程式碼區塊裡面，&、<和>會自動轉成HTML實體，這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼，只需要複製貼上，再加上縮排就可以了，剩下的Markdown都會幫你處理，例如：
    
 
 
        <div class="footer">
         &copy; 2004 Foo Corporation
@@ -452,9 +452,9 @@ end tell
 
 
 
-
    Markdown支援兩種形式的連結語法： 行內和參考兩種形式。
    
+
    Markdown支援兩種形式的連結語法：行內和參考兩種形式。
    
 
-
    不管是哪一種，連結的文字都是用[方括號]來標記。
    
+
    不管是哪一種，連結的文字都是用 [方括號] 來標記。
    
 
 
    要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，如果你還想要加上連結的title文字，只要在網址後面，用雙引號把title文字包起來即可，例如：
    
 
@@ -497,9 +497,9 @@ title attribute.</p>
 
      
 
    • 方括號，裡面輸入連結的辨識用標籤
      • 
 
    • 接著一個冒號
      • 
-
    • 接著一個以上的空白或 tab
      • 
+
    • 接著一個以上的空白或tab
      • 
 
    • 接著連結的網址
      • 
-
    • 選擇性地接著 title 內容，可以用單引號、雙引號或是括弧包著
      • 
+
    • 選擇性地接著title內容，可以用單引號、雙引號或是括弧包著
      • 
 
    
 
 
    下面這三種連結的定義都是相同：
    
@@ -530,7 +530,7 @@ title attribute.</p>
 [link text][A]
 
    
 
-
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓「Google」連結到google.com，你可以簡化成：
    
+
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓"Google"連結到google.com，你可以簡化成：
    
 
 
    [Google][]
 
    
@@ -587,7 +587,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
 [MSN](http://search.msn.com/ "MSN Search").
    -

    參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，使用參考式的文章本身只有 81 個字元，但是用行內形式的連結卻會增加到176個字元，如果是用純HTML格式來寫，會有234個字元，在HTML格式中，標籤比文字還要多。

    +

    參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，使用參考式的文章本身只有81個字元，但是用行內形式的連結卻會增加到176個字元，如果是用純HTML格式來寫，會有234個字元，在HTML格式中，標籤比文字還要多。

    使用Markdown的參考式連結，可以讓文件更像是瀏覽器最後產生的結果，讓你可以把一些標記相關的資訊移到段落文字之外，你就可以增加連結而不讓文章的閱讀感覺被打斷。

    @@ -622,7 +622,7 @@ __double underscores__ 
    un*frigging*believable
    -

    但是如果你的*和_兩邊都有空白的話，它們就只會被當成普通的符號。

    +

    但是如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當成普通的符號。

    如果要在文字前後直接插入普通的星號或底線，你可以用反斜線：

    @@ -690,7 +690,7 @@ equivalent of <code>&amp;mdash;</code>.</p>

    很明顯地，要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。

    -

    Markdown使用一種和連結很相似的語法來標記圖片，同樣也允許兩種樣式： 行內和參考。

    +

    Markdown使用一種和連結很相似的語法來標記圖片，同樣也允許兩種樣式：行內和參考。

    行內圖片的語法看起來像是：

    @@ -702,10 +702,10 @@ equivalent of <code>&amp;mdash;</code>.</p>

    詳細敘述如下：

    參考式的圖片語法則長得像這樣：

    @@ -778,4 +778,4 @@ _ 底線

    感謝

    -

    感謝leafy7382協助翻譯，hlb、Randylien幫忙潤稿，ethantw的漢字標準格式（Han.css），WM回報文字錯誤。

    +

    感謝leafy7382協助翻譯，hlb、Randylien幫忙潤稿，ethantw的漢字標準格式，WM回報文字錯誤。

    diff --git a/header.html b/header.html index e6e01a4..a55a632 100644 --- a/header.html +++ b/header.html @@ -17,6 +17,7 @@ diff --git a/index.html b/index.html index 11bed7f..6ccdf5b 100644 --- a/index.html +++ b/index.html @@ -17,16 +17,16 @@
    -

    Markdown文件

    Markdown

    -

    NOTE: This is Traditional Chinese Edition Document of +

    NOTE: This is Traditional Chinese Edition Document of Markdown Syntax. If you are seeking for English Edition Document. Please refer to Markdown: Syntax.

    @@ -36,7 +36,7 @@ Document. Please refer to 概述
  • 區塊元素 @@ -63,7 +63,7 @@ Document. Please refer to 感謝
    • -

    注意：這份文件是用Markdown寫的，你可以看看它的原始檔。

    +

    注意：這份文件是用Markdown寫的，你可以看看它的原始檔 。

    @@ -73,7 +73,7 @@ Document. Please refer to Setext、atx、Textile、reStructuredText、Grutatext和EtText，然而最大靈感來源其實是純文字的電子郵件格式。

    +

    不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈，並且看起來不會像是由許多標籤或是格式指令所構成。Markdown語法受到一些既有text-to-HTML格式的影響，包括Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，然而最大靈感來源其實是純文字的電子郵件格式。

    因此Markdown的語法全由標點符號所組成，並經過嚴謹慎選，是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號，看起來就像*強調*。Markdown的清單看起來，嗯，就是清單。假如你有使用過電子郵件，區塊引言看起來就真的像是引用一段文字。

    @@ -81,11 +81,11 @@ Document. Please refer to 特殊字元自動轉換 -

    在HTML文件中，有兩個字元需要特殊處理：<和&。<符號用於起始標籤，&符號則用於標記HTML實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是&lt;和&amp;。

    +

    在HTML文件中，有兩個字元需要特殊處理：<和&。<符號用於起始標籤&符號則用於標記HTML實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是&lt;和&amp;。

    -

    &符號其實很讓寫作網路文件的人感到困擾，如果你要打「AT&T」，你必須要寫成「AT&amp;T」，還得轉換網址內的&符號，如果你要連結到：

    +

    & 符號其實很容易讓寫作網路文件的人感到困擾，如果你要打「AT&T」 ，你必須要寫成「AT&amp;T」 ，還得轉換網址內的 & 符號，如果你要連結到：

    http://images.google.com/images?num=30&q=larry+bird
    @@ -137,7 +137,7 @@ This is another regular paragraph. 
    AT&amp;T
    -

    類似的狀況也會發生在<符號上，因為Markdown支援行內HTML，如果你是使用<符號作為HTML標籤使用，那Markdown也不會對它做任何轉換，但是如果你是寫：

    +

    類似的狀況也會發生在<符號上，因為Markdown支援行內 HTML ，如果你是使用<符號作為HTML標籤使用，那Markdown也不會對它做任何轉換，但是如果你是寫：

    4 < 5
    @@ -147,7 +147,7 @@ This is another regular paragraph. 
    4 &lt; 5
    -

    不過需要注意的是，code範圍內，不論是行內還是區塊，<和&兩個符號都一定會被轉換成HTML實體，這項特性讓你可以很容易地用Markdown寫HTML code（和HTML相對而言， HTML語法中，你要把所有的<和&都轉換為HTML實體，才能在HTML文件裡面寫出HTML code。）

    +

    不過需要注意的是，code範圍內，不論是行內還是區塊，<和&兩個符號都一定會被轉換成HTML實體，這項特性讓你可以很容易地用Markdown寫HTML code（和HTML相對而言。在HTML語法中，你要把所有的<和&都轉換為 HTML實體，才能在HTML文件裡面寫出HTML code。）

    @@ -161,7 +161,7 @@ This is another regular paragraph.

    如果你真的想要插入<br />標籤的話，在行尾加上兩個以上的空白，然後按enter。

    -

    是的，這確實需要花比較多功夫來插入<br />，但是「每個換行都轉換為<br />」的方法在 Markdown中並不適合，Markdown中email式的區塊引言和多段落的清單在使用換行來排版的時候，不但更好用，還更好閱讀。

    +

    是的，這確實需要花比較多功夫來插入<br />，但是「每個換行都轉換為<br />」的方法在Markdown中並不適合， Markdown中email式的區塊引言和多段落的清單在使用換行來排版的時候，不但更好用，還更好閱讀。

    @@ -178,7 +178,7 @@ This is an H2

    任何數量的=和-都可以有效果。

    -

    Atx形式則是在行首插入1至6個#，對應到標題1到6階，例如：

    +

    Atx形式則是在行首插入1到6個 # ，各對應到標題1到6階，例如：

    # This is an H1
 
@@ -320,7 +320,7 @@ viverra nec, fringilla in, laoreet vitae, risus.
 Suspendisse id sem consectetuer libero luctus adipiscing.
    -

    如果清單項目間用空行分開，Markdown會把項目的內容在輸出時用<p>標籤包起來，舉例來說：

    +

    如果清單項目間用空行分開， Markdown會把項目的內容在輸出時用<p>標籤包起來，舉例來說：

    *   Bird
 *   Magic
@@ -349,7 +349,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
 </ul>
    -

    清單項目可以包含多個段落，每個項目下的段落都必須縮排4個空白或是一個tab ：

    +

    清單項目可以包含多個段落，每個項目下的段落都必須縮排4個空白或是一個tab：

    1.  This is a list item with two paragraphs. Lorem ipsum dolor
     sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@@ -417,7 +417,7 @@ sit amet, consectetuer adipiscing elit.
 </code></pre>
    -

    這個每行一階的縮排（4個空白或是tab），都會被移除，例如：

    +

    這個每行一階的縮排（4個空白或是1個tab），都會被移除，例如：

    Here is an example of AppleScript:
 
@@ -438,7 +438,7 @@ end tell
 
 
    一個程式碼區塊會一直持續到沒有縮排的那一行（或是文件結尾）。
    
 
-
    在程式碼區塊裡面，&、<和>會自動轉成HTML實體，這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼，只需要複製貼上，再加上縮排就可以了，剩下的 Markdown都會幫你處理，例如：
    
+
    在程式碼區塊裡面，&、<和>會自動轉成HTML實體，這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼，只需要複製貼上，再加上縮排就可以了，剩下的Markdown都會幫你處理，例如：
    
 
 
        <div class="footer">
         &copy; 2004 Foo Corporation
@@ -476,9 +476,9 @@ end tell
 
 
 
-
    Markdown支援兩種形式的連結語法： 行內和參考兩種形式。
    
+
    Markdown支援兩種形式的連結語法：行內和參考兩種形式。
    
 
-
    不管是哪一種，連結的文字都是用[方括號]來標記。
    
+
    不管是哪一種，連結的文字都是用 [方括號] 來標記。
    
 
 
    要建立一個行內形式的連結，只要在方塊括號後面馬上接著括號並插入網址連結即可，如果你還想要加上連結的title文字，只要在網址後面，用雙引號把title文字包起來即可，例如：
    
 
@@ -521,9 +521,9 @@ title attribute.</p>
 
      
 
    • 方括號，裡面輸入連結的辨識用標籤
      • 
 
    • 接著一個冒號
      • 
-
    • 接著一個以上的空白或 tab
      • 
+
    • 接著一個以上的空白或tab
      • 
 
    • 接著連結的網址
      • 
-
    • 選擇性地接著 title 內容，可以用單引號、雙引號或是括弧包著
      • 
+
    • 選擇性地接著title內容，可以用單引號、雙引號或是括弧包著
      • 
 
    
 
 
    下面這三種連結的定義都是相同：
    
@@ -554,7 +554,7 @@ title attribute.</p>
 [link text][A]
 
    
 
-
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓「Google」連結到google.com，你可以簡化成：
    
+
    預設的連結標籤功能讓你可以省略指定連結標籤，這種情形下，連結標籤和連結文字會視為相同，要用預設連結標籤只要在連結文字後面加上一個空的方括號，如果你要讓"Google"連結到google.com，你可以簡化成：
    
 
 
    [Google][]
 
    
@@ -611,7 +611,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
 [MSN](http://search.msn.com/ "MSN Search").
    -

    參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，使用參考式的文章本身只有 81 個字元，但是用行內形式的連結卻會增加到176個字元，如果是用純HTML格式來寫，會有234個字元，在HTML格式中，標籤比文字還要多。

    +

    參考式的連結其實重點不在於它比較好寫，而是它比較好讀，比較一下上面的範例，使用參考式的文章本身只有81個字元，但是用行內形式的連結卻會增加到176個字元，如果是用純HTML格式來寫，會有234個字元，在HTML格式中，標籤比文字還要多。

    使用Markdown的參考式連結，可以讓文件更像是瀏覽器最後產生的結果，讓你可以把一些標記相關的資訊移到段落文字之外，你就可以增加連結而不讓文章的閱讀感覺被打斷。

    @@ -646,7 +646,7 @@ __double underscores__ 
    un*frigging*believable
    -

    但是如果你的*和_兩邊都有空白的話，它們就只會被當成普通的符號。

    +

    但是如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當成普通的符號。

    如果要在文字前後直接插入普通的星號或底線，你可以用反斜線：

    @@ -728,7 +728,8 @@ equivalent of <code>&amp;mdash;</code>.</p>

    參考式的圖片語法則長得像這樣：

    @@ -801,10 +802,10 @@ _ 底線

    感謝

    -

    感謝leafy7382協助翻譯，hlb、Randylien幫忙潤稿，ethantw的漢字標準格式（Han.css），WM回報文字錯誤。

    +

    感謝leafy7382協助翻譯，hlb、Randylien幫忙潤稿，ethantw的漢字標準格式，WM回報文字錯誤。

    -
    +
    @@ -828,7 +829,7 @@ _ 底線
    - + diff --git a/resources.html b/resources.html index aa9a182..843f630 100644 --- a/resources.html +++ b/resources.html @@ -17,6 +17,7 @@ @@ -25,6 +26,12 @@

    Markdown

    +

    Spec

    + + +

    Logo