RSS for mdBook

作为 CLI 工具为 mdBook 生成器，将 RSS.xml 导出至指定路径...

背景

mdBook 很棒，但是没有自动导出 RSS，而且 mdbook-rss 现在无法使用...

所以自己动手做吧 ;-)

目标

作为 Rustacean 作业 ...

作为 crate，可以

• 轻松安装
• 本地使用
• 在 mdBook 生成静态站点后使用
  • 扫描 .md 路径
  • 将 RSS.xml 生成到导出路径
  • ...所以我们可以保留最后更新内容的 RSS

安装

Cargo

如果您已经设置了 Rust 环境，您可以使用 cargo install 命令

$ cargo install rss4mdbook

Cargo 将构建 rss4mdbook 二进制文件并将其放置在 $HOME/.cargo 中。

从 GitHub 手动安装

rss4mdbook 的编译二进制版本在发布时上传到 GitHub。您可以通过下载一个发布版本，提取它，并将二进制文件复制到您的 /usr/local/bin 等目录中来手动安装 rss4mdbook。

更多信息，

...待定

Homebrew

..待定

用法

日常使用，只需一次

• 0: 配置 mdBook 的 book.toml，添加如下

...
[rss4mdbook]
url-base = "https://rs.101.so"

• 1: mdbook build
• 2: 使用 gen 命令，添加最新的 4 篇文章作为 rss.xml

$ rss4mdbook gen /path/2u/mdbook/book.toml

就这样，应该会在您的 mdBook 站点根目录下生成 pub.sh，包括如下命令

• mdbook build
• rss4mdbook gen /path/2u/mdbook/book.toml
• git add .
• git commit -a .
• git push
• ...

这将自动升级站点和 RSS。

顺便说一句

您需要修改您的 theme/index.hbs 在某个地方插入 rss.xml。

日志

• ...
• 230308 ZQ 发布 2 个版本
• 230306 ZQ 初始化。

参考。

• clap::_derive::_cookbook::git_derive - Rust
• 使用 Clapv3 从头构建 CLI | 由 Ukpai Ugochi | Medium
  • 奇怪的是，不能 cargo check
• mdbook - crates.io: Rust 包注册
  • 预处理器 - mdBook 文档
  • mdbook-rss - crates.io: Rust 包注册
  • ...

       _~-+`~_
   () /  > ♡  \ \/
     '_   ⎕   _'
     / '-----' |

...act by ferris-actor v0.2.4 (built on 23.0303.201916)