《KAUST生存手册》诞生于2021年1月26日。本手册旨在集中与分享KAUST生活、学习及娱乐中的诸多感悟、经验和技巧。《KAUST生存手册》支持网页在线预览及信息检索。 我们希望本手册可以在我们和社区的共同维护下一直存活下去，并能给KAUST入学新生、在读学生、职员、家属以及校友带来帮助。 感谢参与本手册编辑的作者们！同时期待更多作者们的加入！
网页同步版本网址：《KAUST生存手册》。下图截取时间：2021年1月27日。本网站将在社区的协助下持续更新。
《KAUST生存手册》支持随时随地网页访问，《KAUST生存手册》网址。用户可以在《KAUST生存手册》很方便地进行内容的检索。
本手册用reST语言撰写, 并支持Sphinx同步渲染。
本手册结构如下：
docs
├── index.rst # 目录手册
├── conf.py # Sphinx网页渲染所需要的配置文件
├── content # KAUST生存手册主要内容
├── life # 生活篇
│ ├── drive.rst # 驾校，学车
│ ├── shopping.rst # 购物
│
├── finance # 财务篇
│ ├── tranfer.rst # 转账回国
└── ...
我们欢迎所有的KAUST在读学生、职员、家属以及校友贡献本手册。本手册用reST语言撰写。reST 被认为是简单，实用的标记语言. 这里是reST的使用文档. 如果您想贡献本手册，可是不了解reST语言，没有关系，上述使用文档可以让你在10分钟以内上手。如果您不想学习reST语言，也没有关系，创建相应的文件（若所需文件不存在），在文件里写入必须的txt文字即可(不需要在乎格式）。
详细步骤：
- fork这个仓库(repo)。 如果已经fork，在你改动你的仓库之前，记得更新你的仓库。更新方法：在绿色的code下方点击一下fecth upstream,然后合并。如下图所示。
-
修改你fork的repo。如何修改？例如想添加驾校信息，可以编辑'docs/content/life/drive.rst'；想添加全新的小节，例如在生活篇中加入 '美食'节（假如没有这个小节），可以在'docs/content/life'中新建'food.rst'文件，并添加相应内容，然后在
docs/index.rst文件相应位置加入新的一行content/life/food。可参考'drive.rst'进行编辑。 -
本机测试: 确保安装了sphinx:
pip install sphinx, 进入docs文件夹cd docs, 然后make html，确保没有error信息。sphinx是网页渲染工具，sphinx手册. -
在本仓库中请求一个pull request. 点击new pull request, 点击compare across fork, pull request的左侧选中本仓库，右侧选中你的仓库。 确认后提交request.
-
审核通过后，您的内容将出现在本手册中。
NOTE: 如果需要加入图片，请参考docs/content/travel/saudi.rst。并且把图片上传到docs/_static/image这个文件夹
如果您不想使用pull request功能，您依然有两种方法贡献《KAUST生存手册》。
-
issue -> new issue -> 在issue内写下 相关文字即可。 会有管理人员将您的文字整理到手册里；
-
微信或电邮联系任何一个管理员，并写下 相关文字，我们会整理到手册中。
如您有《KAUST生存手册》的相关问题，可以提issue.
以上就是全部啦，谢谢大家的贡献！！