使用手册 / 导入与导出 / 命令行导入

命令行导入

通过命令行工具批量导入文档到 WLN.WIKI。

前置要求

  • Python 3.6+
  • 已安装 WLN.WIKI 命令行工具
  • 有效的 API Token

安装命令行工具

pip install wlnwiki-cli

配置认证信息

首次使用需要配置 API Token：

wlnwiki config set token YOUR_API_TOKEN
wlnwiki config set url https://your-wiki-domain.com

导入单个文件

# 导入单个 Markdown 文件
wlnwiki import document.md --project "文集名称"

# 指定文档标题
wlnwiki import document.md --project "文集名称" --title "自定义标题"

批量导入文件夹

# 导入整个文件夹
wlnwiki import ./my-docs/ --project "文集名称"

# 递归导入子文件夹
wlnwiki import ./my-docs/ --project "文集名称" --recursive

导入选项

参数 说明
--project 目标文集名称或ID
--title 自定义文档标题
--parent 父文档ID，用于创建子文档
--recursive 递归导入子文件夹
--overwrite 覆盖已存在的同名文档
--dry-run 预览导入，不实际执行

高级用法

使用配置文件

创建配置文件 `import.yaml`：

source: ./my-docs/
project: "我的文集"
recursive: true
overwrite: false
ignore:
  - "*.tmp"
  - ".git"
  - "node_modules"

使用配置文件导入：

wlnwiki import --config import.yaml

从 Git 仓库导入

# 克隆仓库后导入
git clone https://github.com/user/docs.git
wlnwiki import ./docs/ --project "文档仓库"

命令行导入适合大批量文档迁移和自动化场景，推荐在服务器端使用。

查看帮助

wlnwiki import --help