[关闭]
@caos 2015-07-02T06:26:05.000000Z 字数 946 阅读 514

OMOOC写作班文件编辑 & 互评指南

OMOOC


为了降低写作班学员作业提交的难度,我整理了一份使用github编辑文件的最小行动指南。尽可能的让大家把注意力放在写作的练习上,达到提高写作水平的效果,而不是掉入技术坑,最终行动瘫痪。

文件编辑

首先,我默认你已经加入了OpenMind组织,并fork了OMOOC.Writer仓库。

在Dashboard选择自己的个人界面,在右侧的仓库列表中,找到private标签,切换之后就看到私有的OMOOC.Writer仓库了。

找到自己库

进入页面后,会看到类似于资源管理器的一棵树,这就是我们的仓库文件目录,单击想要提交的目录,会进入文件列表,继续单击要编辑的文件,就进入如下的界面。

点开要修改或更新的文件

注意到右上角的红色小框了吗?单击它就可以进入文件的编辑模式,然后可以在文件上输入文本。

注意:由于github在国内的服务很不稳定,建议大家在本地的markdown编辑器中进行写作练习,然后将内容复制到文件的编辑器中。避免因为掉线或浏览器崩溃而文件丢失。

下图是我已经编辑好的markdown格式的文本,输入到编辑器中,可以选择在下方的commit框中输入提交的描述,或者直接略过。最后点击下方的绿色按钮,提交即可。
填入内容然后提交

作业评价

提交之后,就可以和结对的小伙伴一起评价作业了,github的变更查看页面能够很好的支持对变动的文本进行评论。

首先需要切换到组织视图,找到提交的记录,例如下图中的提交记录,第二行中有行字母和数字组合的蓝色链接,这就是我们上一次提交的编号。

切换到组织视图找到提交索引

点击蓝色的编号,就会看到提交的变更。红色标识是旧内容,绿色标识是新内容,右侧为当前的文件版本,左侧是修改之前的文件版本。

进入变更查看页面

接着我们看右侧的新文件版本,能够在编辑框的左边发现很多的小加号,选择任意一行,将鼠标移动上去,就能够看到蓝色的加号,点击后就会出现一个评论窗口

需要修改的行添加

如下如所示,我们可以在评论框中输入对文章的评论,同样也支持markdown语法。评论之后点击绿色的commit按钮提交评论。

评论一下

评论的效果如下:提交过的评论也可以选择修改或是删除,是不是很有助于小组的作业互评呢?

最终效果

结对的小伙伴看到评价后就可以继续改进文章的内容。

交作业

作业互评之后,记得将作业提交至各大区的issues列表中,具体请看作业提交教程

2015-07-01 @Caos

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注