网站文档编写注意事项¶
网站编写主体采用Markdown
语言,但对于一下功能,由于本身语言不支持,故须插入HTML语言实现
- 表格的多样化
- 图片的缩放
以及由于网站生成工具Material of MkDocs
在使用以下功能时会出现部分错误:
- 本地链接找不到文件:当使用非Markdown语言,例如
<img>
等方式,链接本地资源时,使用正常链接的地址时,会找不到文件,需要在正常的地址前加上../
,返回上层父级文件夹,方可解决
网站编写主体采用Markdown
语言,但对于一下功能,由于本身语言不支持,故须插入HTML语言实现
以及由于网站生成工具Material of MkDocs
在使用以下功能时会出现部分错误:
<img>
等方式,链接本地资源时,使用正常链接的地址时,会找不到文件,需要在正常的地址前加上../
,返回上层父级文件夹,方可解决