爬步历史▼ 2014▼ 规则 命名 写作

P012.写作规则

关于文件命名和文本内容的约定及解释,俗称”写作规则”。

@史荣久 / 2014-10-15 / CC-BY-SA-3.0

文件命名

通常,文件名由半角句点(.)分隔的区域构成。
区域为小写半角英数([0-9a-z])及半角减号(-)构成。
区域应尽量有明确含义。常用的区域包括:

序号 表文件的编号,格式为[0-9a-z][0-9]{2}
小于1000时(001-999),大等于1000时(a00-z99)
如:001.this-is-moilion.md

zz 表示为相同序号文件的辅助文件,如反馈。
相同序号的文件排序 zz 会排到尾部。

现在使用的命名约定有:

文本文件:序号+.+文件名+.+扩展名
如:001.this-is-moilion.md

图片文件:可包含像素,色彩等特征信息。
如:500x200-001.jpg

反馈文件:序号+.zz.+其他名字+.md
如:001.2015.md001.zz.foot-print.md

书写约定

文本资料以markdown语法为基础,扩展名为.md
参考:http://help.github.com/articles/markdown-basics/
此外,鼓励手动换行,即,行尾加2个英文空格( )

标题使用#表示,并在#后,标题前加一个空格( )

重点词汇,需要引号括起来,已表示区分,引号分三种:
双引号(),单引号(),反单引(波浪号的那个键)。

单引和双引没有区别,根据个人习惯使用。建议使用双引。
反单引,有特殊意义,用来表示代码,专有词,醒目词等。

中文句子用中文标点,英文句子用英文标点。不建议混用。
中文可用,「 」 『 』 〈 〉 《 》

不建议使用Tab(\t),应该使用4个空格( )代替。

《P012.写作规则》 关于文件命名和文本内容的约定及解释,俗称
题图:《规矩图》,它们在古代是两种工具,分别校对圆形和方形。