搜索

Articli多平台文章管理工具

联合创作 · 2023-09-30 16:04

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 jcli="acli juejin"
alias ocli="acli oschina"
alias gcli="acli github"
EOF

# 生效
source ~/.bashrc

# 使用简化后的命令查看掘金的登录状态
jcli auth status
浏览 4
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
ipmitoolipmi 平台管理工具
ipmitool是一种可用在linux系统下的ipmi平台管理工具，它支持ipmi1.5规范（最新的规范为ipmi2.0），通过它可以实现获取传感器的信息、显示系统日志内容、网络远程开关机等功能。IP
ipmitoolipmi 平台管理工具
0
OpenTasksAndroid 平台任务管理工具
OpenTasks 是一款 Android 平台上的任务管理工具，可以创建单独的任务时添加自定义的字
OpenTasksAndroid 平台任务管理工具
0
ArtiPub优雅的文章多平台发布工具
ArtiPub（Article Publisher 的简称，意为“文章发布者”）是一款一文多发平台，
ArtiPub优雅的文章多平台发布工具
0
ArtiPub优雅的文章多平台发布工具
ArtiPub（ArticlePublisher的简称，意为“文章发布者”）是一款一文多发平台，可以帮助文章作者将编写好的文章自动发布到掘金、SegmentFault、CSDN、知乎与开源中国等技术媒
ArtiPub优雅的文章多平台发布工具
0
OpenTasksAndroid 平台任务管理工具
OpenTasks是一款 Android 平台上的任务管理工具，可以创建单独的任务时添加自定义的字段，范围从诸如名称和描述的基本事物到更复杂的项目，任务可以设置为私有的，公共的或者加密访问的。特色的标
OpenTasksAndroid 平台任务管理工具
0
jenvJava 多版本管理工具
jenv是一款Java多版本管理工具，它为安装，切换，删除和列出候选提供了一个方便的命令行界面。特性：便于管理Java版本，例如1.6,1.7和1.8易于安装Java相关的工具，例如ant,maven
jenvJava 多版本管理工具
0
jenvJava 多版本管理工具
jenv 是一款 Java 多版本管理工具，它为安装，切换，删除和列出候选提供了一个方便的命令行界面
jenvJava 多版本管理工具
0
node-gitmGit 多仓库管理工具
Gitm，一个简单好用的git多仓库管理工具。类似GitSubmodule和repo的小工具。应用场景一：应用场景二：示例代码：
node-gitmGit 多仓库管理工具
0
smart-go-dlGo 多版本管理工具
Go 多版本管理辅助工具, 可以快速安装 Go ( 次要版本 ) 的最新版本，并对过期版本进行清理。
smart-go-dlGo 多版本管理工具
0
smart-go-dlGo 多版本管理工具
Go多版本管理辅助工具,可以快速安装Go(次要版本)的最新版本，并对过期版本进行清理。底层使用 https://github.com/golang/dl 来进行多Go版本的安装。依赖：安装过git，内
smart-go-dlGo 多版本管理工具
0
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报