write_attention.md 809 B


title: 写文档的注意点 keywords: teedoc, 写文档, 注意点

desc: teedoc, 将 markdown 或者 jupyter notbook 转换成 html 静态网页, 介绍了使用 teedoc 写文档时的注意点

相对路径问题

config.json中写链接路径时,尽量写规范,比如/get_started/zh/, 而不是/get_started/zh

即如果对应的路径不是文件,而是一个目录, 则必须在后面加一个/,让浏览器知道这是一个目录, 这样我们在md文件中写相对路径比如../assets/image/screenshot.png就会转换为/get_started/assets/image/screenshot.png 如果是/get_started/zh, 浏览器就会解析为/assets/image/screenshot.png,就是错误的地址,就会找不到图片!

当然,你也可以选择使用绝对路径