Home

欢迎来到 ZJU-UIUC Meta 战队机械组 Wiki。请使用右侧导航跳转页面 =>

此页面以控制组页面作为模板编写：）

GitHub Wiki 是战队知识传承的重要平台，需要大家共同参与维护。在这里，你不仅仅是一位读者，也应当是一位书写者。

当你构思了一个精巧体系，你应当把你的思路记录下来，以便其他队员理解。即使以后程序迭代，你的代码不再被使用，这些文档依然是宝贵的记录和见证，让大家知道我们如何走到今天。

当你反复尝试，成功安装了一个程序或者库调出了一种耗材，你应当把你的步骤记录下来。无论是你自己还是其他队员，重新进行这些步骤时，就重新踩一遍那些坑。

即使你对你正在阅读的文档并无了解，只是跟着步骤执行，你也应该把文档源代码打开放在一旁。对于不清楚的地方、需要更新的地方、~~不适配某一操作系统~~那就只能装虚拟机了的地方，你都应当及时更正。当你走完了文档的所有步骤，文档本身也得到了更新。

规则每年变化，技术时常更新，战队人员也在不断更迭。代码、图纸，或许会在某一天被弃用，但你的贡献将被大家永远铭记。请不要吝惜你的笔墨，请将你的知识和见解传承下去。

如何编辑 Wiki

Wiki 本身是一个 Git 仓库，页面使用 Markdown 书写。

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。(Wikipedia)

Markdown 教程网上已有众多，例如 Mastering Markdown · GitHub Guides，请根据需求自行查阅学习。

编辑 Markdown 不需要特别的工具，文本编辑器就可编辑。也可使用 VSCode 等编辑器，有许多实用的插件辅助 Markdown 编写、预览，例如 Markdown All in One、Markdown Paste 等。

GitHub Wiki Markdown 的一些注意事项：

Wiki 页面上方自带标题，因此页面本身不需要标题
引用其他页面，可使用以下三种方式（参考 StackOverflow）：
- [Link Text](wiki/WikiPage)，这种方式文件的相对路径是工程 repo，加上 wiki\ 才是 Wiki 的 repo，如果不加，则会找不到 page 而跳转到创建 page 的页面。这个方法也可以用于引用工程 repo 中的文件。
- [[Link Text|WikiPage]]。
- [[My Wonderful Wiki Page]]，该方式会自动连接到 wiki/My-Wonderful-Wiki-Page。

此 Wiki 中的文档主要用于机械工程文件管理导航、经验记录。出于GitHub上传下载文件的速度限制及世界各地的使用体验考虑，推荐使用Mega进行文件管理。

右侧导航 =>