MaixPy_DOC 实例教程模板
本文说明文档贡献者在撰写教程中遵循的规范,以及注意事项,请各位贡献者根据本文撰写文档;
如果对模板格式,内容存在疑惑请到本项目仓库 MaixPy_DOC 提交 ISSUE
。
🙇 感谢各位贡献者的热心支持!
- 关于文档编写工具
文档使用
MarkDown
语法撰写, 整体文档项目使用gitbook
构建;这里推荐使用Typora
及VS Code
搭配MarkDown
插件作为文本编辑器
- 关于文档图文内容存放
实例教程文档请存放到路径
./MaixPy_DOC/zh(这里区分中英文,中文:zh,英文:en)/application/xxx(具体分类,分类建议请看后续描述)/xxx(具体的例程名称,建议使用英文命名)
.md
文档中引用到的图片建议使用相对链接,并将图片文件存放与文档同目录下的
[文件名].assets
文件夹中;
- 关于文档分类建立存放路径
与硬件外设强相关的建议命名(存放路径)为:``
与 image 强相关的建议命名(存放路径)为:
image
与 KPU 强相关的建议命名(存放路径)为:
KPU
较为综合的例程的建议命名(存放路径)为:
demo
以下内容为文档模板内容:
MaixPy 实例教程 —— XXX
一、概述:
描述下该例程实现的效果
简要说明操作步骤
二、准备:
说明需要准备的软硬件环境
预备知识
硬件
图文描述使用到的开发板&&外设模块等
软件
图文描述使用到的软件工具,MaixPy 版本
如果使用到第三方软件工具,可以附加相关名称或下载链接
具体操作步骤
程序代码
xxxxx
效果
建议添加图片展示实际运行效果
问题和反馈(Question && Feedback)
- 贡献者说明:
这里给贡献者提供引流入口
作者:
联系方式(Email):
博客: