Documentation Center

contentimporter convert-and-import

contentimporter convert-and-import 用于转换内容文件,创建或修改元数据文件,以及将它们导入存储库。

概要

contentimporter convert-and-import [ -i|--inputinput-directory ] [ -o|--outputoutput-directory ] [ -r|--repository-pathrepository-path ] [ -p|--phasephase ] [ -t|--file-format-typefile-format-type ] [ -g|--reassign-ids ] [ -f|--force ] -c|--client-idclient-id -s|--client-secretclient-secret [ --help ]

说明

将内容文件以及相关的元数据文件(如果提供)导入存储库。当提供元数据文件时,将对其进行修改,否则将在导入之前创建元数据文件。内容文件可以转换为其他文档类型。默认情况下,只转换 DITA 内容:例如,修改存储库中引用对象的链接,或者将 DITA 条件处理属性转换为 @ishcondition 属性。

您可以通过在命令行键入 contentimporter convert-and-import --help 来查找选项说明。

选项

contentimporter convert-and-import 的选项是:

-t--file-format-type file-format-type
要导入的文件的格式类型。(默认:Generic

允许的值有:

常规。指定文件采用本机格式。

存储库。指定文件以转换的格式从存储库中导出。

-f--force
强制转换并导入所有文件,即使上次导入成功也不例外。这相当于清理输出文件夹。(默认:false
--help
打印命令的简短说明。
-i--input input-directory
源所在的输入目录。

包含空格的路径必须括在双引号中。

-o--output output-directory
将放置已转换文件的输出目录。

包含空格的路径必须括在双引号中。

-p--phase phase
转换和导入文件时要运行的阶段。(默认:Both

允许的值有:

Both。指定要转换和导入的文件。

Convert。指定仅转换文件。

Import。指定仅导入文件。必须先转换文件才能导入。

-g--reassign-ids
转换源时为主题和映射生成新标识符。(默认:false
-r--repository-path repository-path
存储库中将导入文件的位置。

包含空格的路径必须括在双引号中。

-c--client-id
身份验证客户端标识符。
-s--client-secret
身份验证客户端密钥。

示例

以下命令将内容文件及其相关的元数据文件导入到存储库中。首先修改 C:\Import\In 目录中的元数据文件或创建这些文件(如果未提供),然后将其保存在 C:\Import\Out 目录中。内容文件将转换并保存在 C:\Import\Out 目录中。然后将 C:\Import\Out 目录中的内容和元数据文件导入到存储库中。如果文件的相应对象不存在,则在 General/Import 文件夹中创建该对象。

ContentImporter convert-and-import --input C:\Import\In --output C:\Import\Out --repository-path General/Import

以下命令将从某个存储库导出的内容文件及其相关的元数据文件导入到目标存储库中。首先修改 C:\Import\In 目录中的元数据文件或创建这些文件(如果未提供),然后将其保存在 C:\Import\Out 目录中。内容文件将转换并保存在 C:\Import\Out 目录中。然后将 C:\Import\Out 目录中的内容和元数据文件导入到存储库中。为对象分配新标识符。所有对象都在 General/Import 文件夹中创建。

ContentImporter convert-and-import --input C:\Import\In --output C:\Import\Out --repository-path General/Import --file-format-type Repository --reassign-ids