====== 如何优雅地用 wiki 记录作业？ ======

作者：[[jsb:lanshizi_home|蓝狮子]] \\ 
版本：V0.2.2 \\
时间：2025.4.23

<color blue>**说明** : 看这篇文章之前，你需要了解基本的 wiki 的语法，懂得[[csz:wikiyufa|基本 wiki 操作]]。</color>

在必经之路，wiki可以做很多事，记录自己的修行功课，记录自己的日常作业，就是一个很重要的用途，对每位同学都很重要。

用 wiki 记录自己每日的功课，记录每日的心得体会，是一个很不错的习惯。类似年轻时记日记，但又比日记更有意义，因为这是自己的修行成长路径。同时，也方便老师和其他同学更好地了解自己。

蓝狮子在看了上百位同学的作业记录后，有点心得体会：<color blue>**要考虑其他人查看自己的记录时是否方便**</color>。这是基本原则，很多同学的主页和作业设计得很用心，很漂亮，但他人过来查看，就很不方便。

==== 一、基础提示 ====

如何才能让他人查看时更方便？看看下面的提示：


1. <color blue>**交代自己的背景信息**</color>。你的信息你自己清楚，但他人不一定清楚。就算你做过自我介绍，他人可能看过但也忘了。有同学记录自己的孩子总是不爱写作业自己很焦虑。但不介绍他孩子几岁，如果幼儿园，不爱写作业，就没关系。如果上大学了，也不用焦虑了。所以，最好能在主页中简单交代好背景（包括，但不限于且非必须）：自己的年龄，自己的工作，孩子的年龄，父母的年龄等。就是你作业中可能会经常出现的人和事，你需要做个介绍。若没有介绍，你就需要每次在作业中有点介绍。
1. <color blue>**多天的记录放在同一页面**</color>。很多同学习惯每天的记录生成一个新页面，看上去很清爽、简洁，但他人查看时就不太方便，看一个月的记录需要来回点击、关闭 30 次，而且有时还经常忘了，刚才看的是哪一天的作业。比较好的方式是：**每一周的记录生成一个页面**，或者两周、一个月的记录放一个页面，也可以。还可以按照闯关记录：每关一个单独页面。（也可根据每个记录内容多少，做决定）
1. <color blue>**最新的作业放在页面顶部**</color>。相当于把作业按照日期倒排，这也是为了方便他人查看。一方面，对于修行记录，越靠近的，越有价值；另一方面，有时之前的记录别人已经看过，要看新记录，就不用拖到最后了。
1. <color blue>**页面的标题要求**</color>。像写一篇word文章，或发布公众号文章，每篇文章都有标题。标题最好能加上姓名和时间。例如：**和觉 202504第一周作业**，便于分享、转发、搜索。他人打开时，就清晰知道这个页面的内容。若页面标题是：**第一周作业**，看上去就会很尴尬。

1. <color blue>**页面顶部增加【返回主页】链接**</color>。这样可以方便他人看完后，返回上一页，继续查看其他记录，或者查阅背景信息。当然，也可以在顶部和底部都加上返回链接，或者其他相关链接，会更方便。
1. <color blue>**独立任务做一个单独主页**</color>，例如你挑战深海任务【在工作中修行】，那就单独建一个【[[target=_blank|csz:joy:shenhaigongzuo|Joy 在工作中修行]]】。 如果你参加【天空营】，你可以给自己单独建一个主页【小王同学的天空历险记】，这样方便自己，也方便别人查看。
1.  <color blue>**交作业时发内容并附上 wiki链接**</color>。平时在某个群里交作业，可以把当天作业的文字内容发到群里，然后附上 wiki 链接。附上 wiki 链接，是方便大家查看更多信息。有同学只是发 wiki 链接，也不合适。发当天作业的文字内容，也是方便大家直接查看，如果没有兴趣（或与自己关系不大），就不用点击 wiki 链接看更多了。如果当天文字内容太长，也可以节选关键部分发送。这样大家看起来也清爽。

==== 二、其他技巧 ====


让作业更漂亮，还有一些小技巧和提示：

1. <color blue>**设置小标题**</color>，可以为每天的记录设置一个小标题。一方面排版清晰，有目录，另一方面，蓝狮子、船长或其他同学想帮助点评时，也可以只编辑这一小块内容，不影响整体编辑。
1. <color blue>**小标题格式**</color>，如果是非日期性质的小标题，我习惯在小标题上增加中文数字一、二、三、四……等，方便同学记忆。文字长度不超过 5 个汉字，这样目录可以不用换行。大家参看本页面的目录，就能理解这一条的意思。8-) 嗯，这一条好像对写作业帮助不大，但对写其他 wiki 文档，挺有帮助的。
1. <color blue>**增加一些颜色格式**</color>，如果页面内容太长，可以给不同的文字增加一些颜色格式，让人看上去感觉舒服，也容易抓住重点。可以参看本页面。用了<color blue>蓝色</color>、<color red>红色</color>和**加粗**,大家就更容易抓住重点。（我审美不好，本页面并不美观。你可以按照自己的审美来写wiki，重点是注意让他人方便抓住重点。）
1. <color blue>**自己用手机检查**</color>，写完作业后把链接发给自己，自己再用手机点击查看。把自己当成蓝狮子，浏览这个页面时，有没有不方便之处。：）
1. <color blue>**每周写小结**</color> 每周写一份小总结，总结自己修行好的地方，不足的地方，以及一些疑问或希望寻求帮助也可以记录下来。这样做，既是对自己的反省和总结，也方便其他人查看整体情况，同时，还是自己的成长记录。
1. <color blue>**作业中记录心得感悟**</color>，作业中可以增加一些心得体会，看文章或者看直播后的感悟（类似笔记），还可以记录自己的修行体会（类似自己长的叶子），生活中的小故事（类似日记）。这样丰富了作业内容，避免枯燥，也记录了思想点滴。
1. <color blue>**多个任务记录在同一作业中**</color>，有同学在同时完成多个任务，如：参加船长认证，也在参加蓝宝奇兵，还在参加深海任务。一天的作业，不用分开记录，都记录在同一记录内就好。要知道，生活中练习才是修行的重点，记录只是辅助。不要因为要记录，而造成太多的负担。

==== 三、常见误区 ====
这里列举一些常犯的错误和误区，你对照一下，看看犯了几个:) :

(1) <color red>**每段开头加两个空格**</color>。写汉字，很多人习惯在每一段开头空两格，但在 wiki 中开头空两格，表示‘引用’。引用会直接显示，不会换行。如果每一段太长，手机查看就很不方便！类似下面这种：

  我是错的，不要模仿我！觉察是知道此刻的正在发生，我们容易回到过去，常见的抱怨，思他人过，思自己过，抑郁，悔恨都是活在过去了，焦虑，是想这样了以后怎么办，总是担心没有发生的事情，就是去到了未来。
   
  再开始一行，也是错的。只是我不够长。

当然，如果你确实想用引用，也可以的。但你自己需要用手机查看一下效果。

若要使用引用，可以语法\`\`\`和开头空格表示的引用效果是一样。

(2) <color red>**遗漏关键背景信息**</color>。

```
1，背景：中午就餐，食堂。
女儿因我未及时给她拿来碗而生气，
未避免影响后面的人打菜，
跟她商量是否让阿姨先把她需要的肉汤先放在鸡腿的那一格。
她更生气就跑出食堂了。
……

```
这个作业有交代背景的意识，但关键的信息没有交代：**女儿多大了**？我查看同学的个人主页包括个人介绍，也不知道女儿有多大。如果这个不清楚，别人很难点评。

每次写完作业，可以假设自己是点评员，浏览一遍这个作业，问自己：能了解关键信息吗？会有什么疑问吗？

(3) <color red>**发送错误链接或源码**</color>

我经常发现有同学把作业交上去后，附上的 wiki 链接有错误。经常发送的是带有编辑信息的链接，如：
```
🚀 精进练习（选做，鼓励挑战）：
日行一善：>3次/天*3天
发愿练习：>1次/天*3天
即刻觉察练习：>10次
课程笔记/感悟：已在wiki记录。
wiki 链接：https://wiki.bijing.life/csz:mingxin:tky:202504018-20250421?do=edit
```
还有同学习惯把作业 **wiki 源代码**直接拷贝粘贴，当成作业交上去，这样也会显得很乱。

如何避免？发送消息后，自己快速检查一遍，发现问题后及时撤回消息，重新发送正确的信息。

（未完待续）
==== 四、参考作业 ====

有些同学的作业记录非常漂亮，风格也不同，大家可以参考：
   - [[target=_blank|csz:joy:shenhaigongzuo|Joy 在工作中修行]]




（未完待续）
==== 版本信息 ====
版本更新历史记录：

1. **V0.1.0** 2025.4.19 初稿完成
2. **V0.2.0** 2025.4.20 补充了几条技巧提示和常见误区。
3. **V0.2.1** 2025.4.22 补充了标题的要求（花落草长的建议），添加常见误区（3）
3. **V0.2.2** 2025.4.23 补充了标题的小建议，序号和长度。