Articli 是一个可以管理多个平台内容的命令行工具， 通过解析 Markdown 文件内容以及调用平台接口，实现内容管理。
最终目标是基于 本地文件 + Git 代码仓 管理所有的文章， 并且可以通过命令行操作以及 CI/CD，实现文章在各个平台的发布、更新等功能。 这样做的好处有：
- 数据安全，既发布到了第三方平台，又可以通过 Git 代码仓管理，避免因平台问题导致数据丢失
- 可以实现自动化，比如文章推送到自动在多个平台发布、更新
- 面向程序员的 CLI 工具，可以实现更多个性化的操作
为本项目点赞将鼓励作者继续完善下去，欢迎提出建议、Bug、PR。
支持的平台
安装
NPM
npm install -g @k8scat/articli
Homebrew
# 添加 tap brew tap k8scat/tap # 安装 brew install acli # 一条命令直接安装 brew install k8scat/tap/acli # 后续升级 brew update brew upgrade k8scat/tap/acli
Docker
# 将配置文件的目录挂载到容器内 docker run \\ -it \\ --rm \\ -v $HOME/.config/articli:/root/.config/articli \\ k8scat/articli:latest \\ juejin auth login # 升级 docker pull k8scat/articli:latest
二进制
Please download from the releases page.
源码编译
git clone https://github.com/k8scat/articli.git cd articli make
文章模板
我们将使用文件内容开头 --- 之间的数据作为文章的配置信息（元数据）， 根据配置信息在不同平台上创建或更新文章，参考 文章模板。
--- # 通用配置，其他平台可以继承该配置 title: 标题1 brief_content: 内容概要 cover_image: https://img.alicdn.com/tfs/TB1.jpg prefix_content: "这是我参与xx活动..." # 前缀内容，主要用于掘金的活动 suffix_content: | ## Powered by 本文由 [Articli](https://github.com/k8scat/Articli.git) 工具自动发布。 juejin: title: 标题2 # 如果不填写，则使用通用配置中的 title tags: - Go - 程序员 category: 后端 cover_image: https://img.alicdn.com/tfs/TB1.jpg brief_content: 内容概要 prefix_content: "这是我参与xx活动..." # 前缀内容，主要用于掘金的活动 suffix_content: | ## Powered by 本文由 [Articli](https://github.com/k8scat/Articli.git) 工具自动发布。 sync_to_org: false # 是否同步到组织，个人账号不支持 # 自动生成部分 draft_id: "7xxx" draft_create_time: "2022-01-23 11:48:02" draft_update_time: "2022-01-24 11:48:02" article_id: "8xxx" article_create_time: "2022-01-25 11:48:02" article_update_time: "2022-01-26 11:48:02" oschina: title: 标题3 # 文章专辑 category: 日常记录 # 推广专区 technical_field: 大前端 # 仅自己可见 privacy: false # 如果是转载文章，请填写原文链接 original_url: "" # 禁止评论 deny_comment: false # 下载外站图片到本地 download_image: false # 置顶 top: false prefix_content: "这是我参与xx活动..." # 前缀内容，主要用于掘金的活动 suffix_content: | ## Powered by 本文由 [Articli](https://github.com/k8scat/Articli.git) 工具自动发布。 # 自动生成部分 draft_id: "7xxx" draft_create_time: "2022-01-23 11:48:02" draft_update_time: "2022-01-24 11:48:02" article_id: "8xxx" article_create_time: "2022-01-25 11:48:02" article_update_time: "2022-01-26 11:48:02" csdn: title: 标题3 brief_content: 内容概要 categories: - Golang - 后端 tags: - cli - csdn # 可选值: public, private, read_need_vip, read_need_fans read_type: public # 可选值: 发布 publish, 草稿 draft publish_status: publish # 可选值: 原创 original, 转载 repost, 翻译 translated article_type: original # 转载时必须填写 original_url: "" # 原文允许转载或者本次转载已经获得原文作者授权 authorized_status: false # 支持单图、三图、无图 cover_images: - https://img.alicdn.com/tfs/TB1.jpg - https://img.alicdn.com/tfs/TB2.jpg - https://img.alicdn.com/tfs/TB3.jpg prefix_content: "这是我参与xx活动..." # 前缀内容，主要用于掘金的活动 suffix_content: | ## Powered by 本文由 [Articli](https://github.com/k8scat/Articli.git) 工具自动发布。 # 自动生成部分 article_id: "8xxx" article_create_time: "2022-01-25 11:48:02" article_update_time: "2022-01-26 11:48:02" --- 内容概要 正文内容
使用说明
所有的命令都可以通过 -h 或 --help 参数查看帮助信息。
$ acli --help Manage content in multi platforms. Usage: acli [command] Available Commands: completion Generate the autocompletion script for the specified shell csdn Manage content in csdn.net github Manage content in github.com help Help about any command juejin Manage content in juejin.cn oschina Manage content in oschina.net version Show version information Flags: -c, --config string An alternative config file -h, --help help for acli Use "acli [command] --help" for more information about a command.
查看版本
acli version
掘金
登录
使用浏览器 Cookie 进行登录
# 交互式登录 acli juejin auth login # 从标准输入获取 Cookie acli juejin auth login --with-cookie < cookie.txt
创建/更新文章
# create 命令可以通过识别文章的配置信息，自动选择创建或者更新文章，同时发布到掘金 acli juejin article create /path/to/article.md
查看文章列表
通过 -k 或 --keyword 关键字参数过滤文章列表
acli juejin article list -k Docker
打开文章
使用默认浏览器打开文章
acli juejin article view 7055689358657093646
查看分类
acli juejin category list
查看标签
# 过滤关键字 acli juejin tag list -k Go
缓存标签
由于标签的数量比较多，可以通过设置缓存加快读取速度
# 设置缓存 acli juejin tag cache # 使用缓存 acli jujin tag list --use-cache
上传图片
支持上传本地图片和网络图片
# 本地图片 acli juejin image upload leetcode-go.png # 网络图片 acli juejin image upload https://launchtoast.com/wp-content/uploads/2021/11/learn-rust-programming-language.png
开源中国
登录
# 交互式登录 acli oschina auth login # 从标准输入中读取 cookie acli oschina auth login --with-cookie < cookie.txt
创建/更新文章
acli oschina article create /path/to/article.md
CSDN
登录
# 交互式登录 acli csdn auth login # 从标准输入中读取 cookie acli csdn auth login --with-cookie < cookie.txt
创建/更新文章
acli csdn article create /path/to/article.md
GitHub
登录
使用 GitHub Token 进行登录
# 交互式登录 acli github auth login # 从标准输入获取 Token acli github auth login --with-token < token.txt
上传文件
# 上传 README.md 文件到 testrepo 仓库 acli github file upload --repo testrepo README.md # 使用网络资源 # 使用 -p 指定在仓库中存储的路径 acli github file upload --repo testrepo \\ -p testdir/homebrew-social-card.png \\ https://brew.sh/assets/img/homebrew-social-card.png
列取文件
# 获取代码仓 testrepo 根目录的文件列表，包括文件和目录 acli github file get --repo testrepo # 如果 testpath 是目录，则获取代码仓 testrepo 中 testpath 目录下的文件； # 如果 testpath 是文件，则只获取该文件 acli github file get --repo testrepo --path testpath
删除文件
# 使用 -o 或 --owner 可以指定仓库的 owner acli github file delete --owner testowner --repo testrepo --path testdir/filename.txt
简化命令
使用 alias 别名进行简化命令
# 将 acli juejin 简化成 jcli cat >> ~/.bashrc << EOF alias alias alias EOF # 生效 source ~/.bashrc # 使用简化后的命令查看掘金的登录状态 jcli auth status
