devtogo

dev.to 路上使用的工具

安装

通过 homebrew (osx)

$ brew install softprops/tools/devtogo

通过 cargo

$ cargo install devtogo

通过 GitHub 发布

使用 GitHub 发布页面 中的版本，替换下面的 VERSION

$ cd $HOME/bin
$ VERSION=v0.1.0 curl -L "https://github.com/softprops/devtogo/releases/download/${VERSION}/devtogo-$(uname -s)-$(uname -m).tar.gz" \
  | tar -xz -C ~/bin

用法

devtogo 是一个命令行工具，主要专注于将离线 markdown 文件发布到 dev.to。这些文件遵循在 dev.to 编辑指南 中记录的相同格式规则。

至少，您需要在 markdown 文件的 frontmatter 部分声明一个标题。

---
title: my very first post
---
# hello everybody

要开始，您首先需要导出一个 DEVTO_API_KEY 环境变量。您可以在 这里 获取一个。

最基本的使用方法是运行包含内容的目录中的程序

$ devtogo

这将扫描当前工作目录中的文章：包含描述文章元数据的 frontmatter 的 markdown 文档。devtogo 使用 title frontmatter 字段作为唯一标识符来比较现有的远程内容。

当它无法通过标题解析文章时，它会上传文章。当它可以时，它会比较内容，并在本地副本内容不同时上传本地副本。

您可以使用 published frontmatter 来指示文章何时以及是否应该发布。默认情况下，文章仅保存为草稿，您可以看到。将 published 设置为 true 将发布文章。如果您意外这样做，可以将 published 返回到 false 以在需要时取消发布文章。

要更明确，您可以提供一个 source 参数，该参数提供了一个存储内容的路径。

$ devtogo --source path/to/content

您还可以使用 --dryrun 标志进行实验，而实际上不发布您的内容。这将执行所有操作，除了上传您的内容。这可能有助于验证您的内容。

$ devto --dryrun

您始终可以在 您的 dev.to 在线仪表板 中查看上传的文章。

Doug Tangren (softprops) 2020