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.