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 这里是这篇文章项目的第一个评论… ----- --------