mtimport - Movable Type 匯入格式

### Movable Type 匯入格式

- 名稱
- 概要
- 描述

- 詮釋資料
- 多列欄位

- 範例

# 名稱

mtimport - Movable Type 匯入格式

# 概要

這個文件描述著 Movable Type 匯入機制所需要的格式，可以用於從其他出版管理系統匯入文章項目及評論之用。

# 描述

基本的匯入格式是文章項目清單，項目間以 `--------\n` 字串（這是八個 `-` 字符，然後再加上一個鍵盤上的返回鍵）分隔。每一個項目還可以拆成兩個主要的區段；這些區段間則是以 `-----\n` 字串（這是五個 `-` 字符，然後再加上一個鍵盤上的返回鍵）分隔。

如果妳所匯入的資料包含有 HTML ，妳不應該把他們編碼成 HTML 項目；妳所要匯入的檔案會逐字被匯進 Movable Type 的資料庫裡；所以妳的資料看起來應該就要跟妳逐字輸入以建立新文章項目的結果一模一樣。

- 詮釋資料
- 多列欄位（文章本體、延伸本體、文摘、評論）

後面的範例小節提供了一個小小的匯入檔案的範例。

## 詮釋資料

每一塊詮釋資料都符合`鍵: 值`的格式，並且藉由一個鍵盤上的返回鍵來與下一塊詮釋資料分隔。至於詮釋資料的順序則不重要。

舉例來說：

    AUTHOR: Foo Bar
    TITLE: 某個白癡標題
    DATE: 01/31/2002 03:31:05 PM
    CATEGORY: News

- AUTHOR
  文章項目的作者。

  如果文章的作者名字不存在的話，就會建立出一筆 MT::Author 紀錄，同時這名新作者在妳匯入該文章項目的網誌上，會被指定具有發表的權限；這則文章項目同時也會被指派到這位新作者名下。如果這個作者名字已經存在了的話，那麼這則文章項目就會被指定給已經存在的這個作者名下。

  如果妳在匯入前核選了`匯入成我的`，那麼這個詮釋資料就會被忽略；否則就會需要這塊詮釋資料。

- TITLE
  文章項目的標題。

  如果妳沒有指定標題的話，標題就會自動以文章本體的前五 (`5`) 個字產生。

  這塊詮釋資料是選用的。

- DATE
  這個文章項目的寫作日期。

  這項詮釋資料的值應該以 `MM/DD/YYYY hh:mm:ss AM|PM` 的格式表示；其中 `AM|PM` 是選用的，如果沒有出現的話， `hh` 就會被視為軍隊時制。

  這是必要的詮釋資料。

- PRIMARY CATEGORY
  文章項目所指定的主要類別。

  如果類別名稱並不存在，那麼就會建立起一筆新的 MT::Category 紀錄，同時把該則文章項目指定進這個新類別裡。如果類別名稱已經存在了，該文章項目就會被指定到那個已經存在的類別裡。

- CATEGORY
  文章項目所指定的次要類別。在這個詮釋資料區段中，可以出現多重類別鍵，每一個都指定到某個次要類別。舉例來說：

      CATEGORY: Foo
      CATEGORY: Bar

  如果這個類別的名稱不存在的話，就會建立一筆新的 MT::Category 紀錄，同時把該則文章項目指定進這個新的分類裡。如果類別名稱已經存在了，該文章項目就會被指定到那個已經存在的類別裡。

  如果在 PRIMARY CATEGORY 裡指定的類別同時也被列在 CATEGORY 的話，該類別就會自動地從次要類別清單中被捨棄，僅被指定到主要類別去。

  如果妳沒有提供 PRIMARY CATEGORY 的資訊，但是卻有用 CATEGORY 提供一個以上的次要類別，那麼第一個 CATEGORY 就會被拿來當作主要類別。

- STATUS
  該文章項目的出版狀態；有效的值可以是 `draft` 或者是 `publish` 。

- ALLOW COMMENTS
  該文章項目的『 allow comments 』旗標值。有效的值可以是 `0` 或者是 `1` 。

- ALLOW PINGS
  該文章項目的『 allow pings 』旗標值。有效的值可以是 `0` 或者是 `1` 。

- CONVERT BREAKS
  該文章項目的『 convert breaks 』旗標值。有效的值可以是 `0` 或者是 `1` 。

- NO ENTRY
  如果妳已經從某個系統匯入所有的文章項目，卻沒有匯入任何評論，現在想要匯入時，妳就可以使用這個特殊的鍵。當妳用這個鍵的時候，同時也會需要 DATE 鍵，用來察看文章項目和評論間的聯繫關係；如果沒辦法由時間戳印找到匹配關係的話，該篇評論就會被跳過。妳有可能並不需要用到這個詮釋資料。

  使用範例：

      NO ENTRY: 1

## 多列欄位

多列欄位是以 `-----\n` 字串（也就是五個 `-` 字符，後面再加上鍵盤的返回鍵）分開的。每一個多列欄位都是從指稱欄位類別的鍵開始，後面再加上記盤的返回鍵，然後跟在欄位真正的本體之後。

使用範例：

    BODY:
    這裡是文章內容。
    -----
    EXTENDED BODY:
    這裡還有一些字。
    -----
    COMMENT:
    AUTHOR: Foo
    DATE: 01/31/2002 15:47:06
    這裡是
    這篇評論的本體。
    -----
    PING:
    TITLE: Foo Bar
    URL: http://www.foo.com/baz/archives/000015.html
    DATE: 08/05/2002 04:05:23 PM
    這裡是
    這個通告的文摘。
    -----

- BODY
  文章項目的本體部分。

- EXTENDED BODY
  文章項目的延伸部分。

- EXCERPT
  文章項目的文摘。

- COMMENT
  這個詮釋資料代表著該文章項目上的一篇評論。有可能出現多重 COMMENT 區段，彼此間以標準的多列分隔字串（ `-----\n` ）加以分隔。

  在每一個 COMMENT 區段中，都可以使用下列欄位：

  - AUTHOR
    這篇評論的作者名字。

  - EMAIL
    這篇評論作者的 E-mail 地址。

  - URL
    這篇評論作者的網址。

  - IP
    這篇評論作者的來源 IP 地址。

  - DATE
    這篇評論發表的日期，應該要跟前述的 DATA 詮釋資料鍵使用相同的格式。

  任何不以上述鍵為開頭的列，就會被當作是評論的本體部分，一直到 COMMENT 區段結束為止。如果妳覺得這樣子解說還不夠清楚的話，請看後面的 EXAMPLE 小節。

- PING
  這個詮釋資料代表著這則文章項目上的一個引用通告。有可能出現多重 PING 區段，彼此間以標準的多列分隔字串（ `-----\n` ）加以分隔。

  在每一個 PING 區段中，都可以使用下列欄位：

  - TITLE
    這個通告的標題。

  - URL
    原始文章項目的網址。

  - IP
    送出通告的伺服器 IP 地址。

  - BLOG NAME
    送出通告的網誌名稱。

  - DATE
    這篇評論發表的日期，應該要跟前述的 DATA 詮釋資料鍵使用相同的格式。 送出通告的日期，應該要跟前述的 DATA 詮釋資料鍵使用相同的格式。

  任何不以上述鍵為開頭的列，就會被當作是通告的本摘，一直到 PING 區段結束為止。如果妳覺得這樣子解說還不夠清楚的話，請看後面的 EXAMPLE 小節。

# 範例

    TITLE: 某個白癡標題
    AUTHOR: Foo Bar
    DATE: 01/31/2002 03:31:05 PM
    PRIMARY CATEGORY: Media
    CATEGORY: News
    -----
    BODY:
    這裡是文章內容。
    -----
    EXTENDED BODY:
    這裡還有一些字。
    -----
    COMMENT:
    AUTHOR: Foo
    DATE: 01/31/2002 15:47:06
    這裡是
    這篇評論的本體。
    -----
    COMMENT:
    AUTHOR: Bar
    DATE: 02/01/2002 04:02:07 AM
    IP: 205.66.1.32
    EMAIL: me@bar.com
    這裡是另外一個
    評論的本體。他一直
    延續到這邊。
    -----
    PING:
    TITLE: 我的文章
    URL: http://www.foo.com/old/2002/08/
    IP: 206.22.1.53
    BLOG NAME: 我的網誌
    DATE: 08/05/2002 16:09:12
    這裡是我的文章開始，
    然後這裡是....
    -----
    --------
    TITLE: 這裡是另一則新文章
    AUTHOR: Baz Quux
    DATE: 01/31/2002 03:31:05
    CATEGORY: Politics
    -----
    BODY:
    這裡是第二則文章項目的本體；
    他還可以裝下多列文字。
    -----
    EXCERPT:
    妳看這則文章項目沒有延伸的片段；
    但是還是有文摘，真是特別啊！
    -----
    COMMENT:
    AUTHOR: Quux
    URL: http://www.quux.com/
    DATE: 01/31/2002 04:23:01 PM
    這裡是這篇文章項目的第一個評論…
    -----
    --------

Copyright © 2001-2003 Six Apart. All Rights Reserved.