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
如果文章的作者名字不存在的話,就會建立出一筆 MT::Author 紀錄,同時這名新作者在妳匯入該文章項目的網誌上,會被指定具有發表的權限;這則文章項目同時也會被指派到這位新作者名下。如果這個作者名字已經存在了的話,那麼這則文章項目就會被指定給已經存在的這個作者名下。
如果妳在匯入前核選了匯入成我的
,那麼這個詮釋資料就會被忽略;否則就會需要這塊詮釋資料。
如果妳沒有指定標題的話,標題就會自動以文章本體的前五 (5
) 個字產生。
這塊詮釋資料是選用的。
這項詮釋資料的值應該以 MM/DD/YYYY hh:mm:ss AM|PM
的格式表示;其中 AM|PM
是選用的,如果沒有出現的話, hh
就會被視為軍隊時制。
這是必要的詮釋資料。
如果類別名稱並不存在,那麼就會建立起一筆新的 MT::Category 紀錄,同時把該則文章項目指定進這個新類別裡。如果類別名稱已經存在了,該文章項目就會被指定到那個已經存在的類別裡。
CATEGORY: Foo CATEGORY: Bar
如果這個類別的名稱不存在的話,就會建立一筆新的 MT::Category 紀錄,同時把該則文章項目指定進這個新的分類裡。如果類別名稱已經存在了,該文章項目就會被指定到那個已經存在的類別裡。
如果在 PRIMARY CATEGORY 裡指定的類別同時也被列在 CATEGORY 的話,該類別就會自動地從次要類別清單中被捨棄,僅被指定到主要類別去。
如果妳沒有提供 PRIMARY CATEGORY 的資訊,但是卻有用 CATEGORY 提供一個以上的次要類別,那麼第一個 CATEGORY 就會被拿來當作主要類別。
draft
或者是 publish
。
0
或者是 1
。
0
或者是 1
。
0
或者是 1
。
使用範例:
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 這裡是 這個通告的文摘。 -----
-----\n
)加以分隔。
在每一個 COMMENT 區段中,都可以使用下列欄位:
任何不以上述鍵為開頭的列,就會被當作是評論的本體部分,一直到 COMMENT 區段結束為止。如果妳覺得這樣子解說還不夠清楚的話,請看後面的 EXAMPLE 小節。
-----\n
)加以分隔。
在每一個 PING 區段中,都可以使用下列欄位:
任何不以上述鍵為開頭的列,就會被當作是通告的本摘,一直到 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 這裡是這篇文章項目的第一個評論… ----- --------