简介
mdbook是一个基于Rust的电子书系统,效果类似于gitbook。本人写图文文章一直都采用的印象笔记,但是写系列教程的情况不方便管理。因此引入mdBook,分享一下基本安装使用过程及遇到的问题。
安装
本机环境是win11。mdBook是写的 Rust 因此需要Cargo编译
1.安装Rust
官方下载地址: https://www.rust-lang.org/zh-CN/tools/install
2.安装mdBook
cargo install mdbook
安装过程中出现错误
error: linker
link.exe
not found| = note: program not foundnote: the msvc targets depend on the msvc linker butlink.exe
was not foundnote: please ensure that Visual Studio 2017 or later, or Build Tools for Visual Studio were installed with the Visual C++ option.note: VS Code is a different product, and is not sufficient.
解决方案:安装C++生成工具。从这里下载 https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/
安装时选择红框组件。
重新安装mdbook,搞定。
创建mdbook
1.init命令
创建第一本mdbook,执行命令行
mdbook init --title 原来你是这样的java
来看下默认生成的文档结构吧。
2.build命令
mdbook build
build命令尝试解析您的SUMMARY.md文件以了解您的书的结构并获取相应的文件。 请注意,在 SUMMARY.md 中提到但不存在的文件将会自动创建。为方便起见,渲染的输出将保持与源相同的目录结构。
3.serve命令
mdbook serve
serve 命令用于通过 HTTP 在 localhost:3000 提供服务来预览电子教程。
详细mdBook教程:
https://hellowac.github.io/mdbook-doc-zh/zh-cn/index.html
作者:陈敬(公众号:敬YES)
出处:http://www.cnblogs.com/janes/
博客文章仅供交流学习,请勿用于商业用途。如需转载,请务必注明出处。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· [翻译] 为什么 Tracebit 用 C# 开发
· 腾讯ima接入deepseek-r1,借用别人脑子用用成真了~
· Deepseek官网太卡,教你白嫖阿里云的Deepseek-R1满血版
· DeepSeek崛起:程序员“饭碗”被抢,还是职业进化新起点?
· RFID实践——.NET IoT程序读取高频RFID卡/标签
2017-02-21 JAVA入门[6]-Mybatis简单示例