#文档 #mdbook #合并 #多个 #Markdown #摘要 #摘要

app mdbook-combiner

一个将多个来源的 mdbook 摘要合并为一个 mdbook 的实用工具

18 个版本

0.2.0 2023 年 4 月 27 日
0.1.17 2024 年 6 月 7 日
0.1.16 2024 年 5 月 24 日
0.1.14 2023 年 5 月 3 日
0.1.13 2023 年 4 月 28 日

168文本处理

每月 47 次下载

MIT 许可证

15KB
248 代码行

mdbook Combiner

该实用工具旨在帮助解决一个组织拥有多个分散在不同仓库中的 mdbook,但又希望有一个选项来制作单个 mdbook,以便方便地搜索整个组织的信息的问题。

示例

通常,该工具期望有一个包含多个 SUMMARY.md 或包含它们的子文件夹的文件夹。我已使用仓库工具来克隆多个仓库以构建此文件夹,但其文档不太好,所以您的效果可能会有所不同。一个调用 clone 的 shell 脚本也可能同样有效。

然后您可以如此调用该工具:mdbook-combiner -m METAFOLDER 这将输出一个新 SUMMARY.md,可以将其输入到 mdbook 中以创建一个合并后的 mdbook。

对于未排序的 Markdown 文件

您还可以使用 -j 标志传递包含 Markdown 文件的文件夹,这将根据文件位置生成这些文件的摘要并将它们添加到合并输出中。

依赖项

~11–23MB
~328K SLoC