当前位置: 首页 > article >正文

从0到1,用Rust轻松制作电子书

我之前简单提到过用 Rust 做电子书,今天分享下如何用Rust做电子书。制作电子书其实用途广泛,不仅可以用于技术文档(对技术人来说非常方便),也可以制作用户手册、笔记、教程等,还可以应用于文学创作。

如果你有想法写小说或者做知识付费,电子书也是一个不错的切入点。特别是知识付费领域,通过小范围试水电子书,收集读者反馈,进一步打磨内容,最后也可以出版成书。

好了,有点扯远了,我们重点先说下怎么用Rust快速做电子书吧,简单方便几分钟就可以搭起来。

1. 环境准备

我们准备用Rust来创建电子书,首先,需要安装有Rust的环境,Rust环境安装也比较简单打开官方地址,复制安装命令安装即可。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

其次,需要对Markdown语法了解,如果不了解的可以看下,强烈推荐所有人来学。很多精美的排版和插图都可以通过md语法来实现,现在更有md的编辑器,稍微了解配合编辑器就能如虎添翼了。

如果有不熟悉markdown可以到这个网站来学习了解下,https://www.markdownguide.org/ ,也可以其他中文网站了解。

图片

2. 安装使用

介绍下我们做电子书的主角mdBook,一款由rust实现的开源软件,可以进行文档生成,搜索,语法高亮,生产的电子书可以支持在PC、和移动设备打开使用。

通过cargo来安装

cargo install mdbook

安装成功,可以进行创建

mdbook init my-first-book

创建过程中可以起名字,创建完成后到该文件目录下

cd my-first-book
mdbook serve --open

打开地址http://localhost:3000/ ,可以看到创建的电子书模板已经打开了,尽管内容还是空的,但电子书的结构已经有了,左边导航,右边文章内容,以及搜索框。

图片

剩下就是我们写电子书的内容了。

3. 写电子书内容

在创建的电子书工程下,会看到src文件目录、book.toml配置文件、book目录,我们先关注电子书的内容src目录

├── SUMMARY.md
└── chapter_1.md

SUMMARY.md 里打开可以看到就是左侧的导航配置,比如对应的章节配置在这个文件里,chapter_1.md就是对应的章节内容

# Summary
- [Chapter 1](./chapter_1.md)

可以对chapter_1.md进行内容写作,就可以形成对应的电子书的内容了。

比如这个我复制了个内容,修改了章节命名,然后重新刷新即可看到内容。

图片

4. 部署

电子书制作完后,编译后会发现在book的目录下会有编译好的文件,可以通过GitHub Pages上这样完全可以免费,也可以支持远程别人打开和阅读。

这个是我之前部署的一个Rust精简笔记电子书:

图片

回头再介绍下部署吧,有兴趣的也可以看官方文档,部署也比较简单,可以通过脚本结合来。

PS: 也欢迎大家评论和交流~ 更多文章也可关注微信公号:良技漫谈


http://www.kler.cn/a/375292.html

相关文章:

  • Latex中Reference的卷号加粗的问题
  • Java的jackson库
  • 期权懂|开通ETF股票期权需要什么条件?ETF股票期权佣金是多少?
  • 从0攒一个分布大数据/人工智能/数据库 处理引擎
  • K8s企业应用之容器化迁移
  • gin框架可以构建微服务吗?
  • OpenWrt下安装Mosquitto
  • 在Java中 try catch 会影响性能吗?
  • 轻松部署自己的AI聊天助手LocalGPT并实现无公网IP远程交互
  • 包子凑数(完全背包)
  • 详解进制转换
  • windows@命令行中获取环境变量取值不展开取值(原值)
  • 大数据新视界 -- 大数据大厂都在用的数据目录管理秘籍大揭秘,附海量代码和案例
  • 青少年编程与数学 02-003 Go语言网络编程 03课题、网络编程协议
  • 代码随想录训练营Day09 | 150. 逆波兰表达式求值 - 239. 滑动窗口最大值 - 347.前 K 个高频元素
  • 从服务运营的阶段,进入到了精细化管理和智慧化运营的阶段的明厨亮早年开源了
  • ubuntu知识点滴积累
  • AI-基本概念-向量、矩阵、张量
  • 后台管理系统的通用权限解决方案(七)SpringBoot整合SpringEvent实现操作日志记录(基于注解和切面实现)
  • 学习虚幻C++开发日志——基础案例(持续更新中)
  • SpringSecurity框架(入门)
  • PostgreSQL的奥秘:表结构、TOAST与大对象
  • 网络一些相关术语
  • axios 如何取消请求
  • 移植 AWTK 到 纯血鸿蒙(HarmonyOS NEXT)系统 (0) - 序
  • IP 欺骗以及其他常见网络攻击手段(附hping3的实际应用)