使用 mdBook 进行创作

之前听朋友介绍过静态页托管这种发布内容的方式,但是一直不太清楚该怎么操作,静态页构建的工具也不甚了解。

后来,有幸从 《计算机入门指南》 这里了解到了 mdBook 这种工具,发现十分好用,并用 mdBook 编写了自己的同类项目 《程序员入门指南》Gitee 镜像)。

不同于大多数静态网站生成器 (Static Site Generator, SSG),mdBook 仅需一个独立的可执行文件即可运行,这一点使得它非常的易用。此外,它的使用也不复杂,只需要通过一个 SUMMARY.md 文件即可完成目录层级的标记,配置选项也可以在 book.toml 中很轻松的修改。用户只需要一点命令行和 Markdown 基础就可以使用。

正如其名“mdBook”,其从 Markdown 文件生成静态页面,并像书籍一样以章节方式组织内容。个人认为,mdBook 既适用于知识库类型的内容,也能应付流水式的内容——对于技术型博客,很多时候是相互联系的,自然可以组成章节;而对于其它类型的博客,如日志、随想等,按时间顺序组成章节也是个不错的选择。

一般来说,要使用 mdBook,只需要下载其可执行文件,再将其路径添加到环境变量 PATH 即可在命令行界面使用。官方在 GitHub 的 Release 页提供有针对 x86_64 架构的 Windows、macOS 以及 Linux 的预构建版本。读者也可以访问 mdBook 的 GitHub 主页 获得更多信息(使用方式、教程)。

关于具体的使用,以及如何使用静态页托管服务,之后再介绍吧。

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值