1.1.1. 问题
gitbook 有个模板问题:如果md文件中有连续的大括号(比如:&{{父亲 40}}
),gitbook会把{{ 父亲 40 }}
中的父亲 40
当做一个模板变量。如果这个变量不存在,会报错 Template render error: expected variable end
。详细的解释看下面:
https://wwshen.gitbooks.io/omooc2py/0MOOC/dakuohao.html
https://www.weihuayi.cn/tools/gitbook.html
https://juejin.im/post/5ce51e126fb9a07ed440d7d0#heading-22
1.1.2. 解决方式。
把连续的大括号{{
替换为中间加个空格{ {
,把}}
替换为} }
。
1.1.3. mdBook 的使用:
mdbook现在对目录的支持还不太行。所以暂时不用这个了。比如下面:
golang连接redis
会报错,所有的目录必须有一个连接。golang连接redis
加上连接之后,也不能生产目录。因为上面还有[Redis](redis/README.md)
大目录。我暂时找不到怎么支持嵌套的目录。1、下载mdbook。
官方下载mdBook:https://github.com/rust-lang-nursery/mdBook/releases1.1.4. 2、运行mdbook。
解压后得到mdbook.exe
,把mdbook.exe
放在任意目录。配置到环境变量到mdbook.exe
所在目录。之后就可以使用mdbook
命令了。1.1.5. 3、使用mdBook:
具体参考下面的文档:
https://www.jianshu.com/p/cdde301edb36
http://llever.com/mdBook-zh/print.html
https://mdbook.budshome.com/
官方文档:
https://rust-lang-nursery.github.io/mdBook/format/config.html