这里存放的是 Jenkins 官方微信公众号文章,文件采用 Markdown 格式,但包含一些必要的描述性字段。文章的校对、审核、排期等都通过 Pull Request 来完成。PR 合并后会发布到 Jenkins 中文社区网站。
目录
文章以发布的排期来存放,层级为:年份/月份。如果月份为个位数的话,要以0
开头,例如:01
。
以文章的文件名前缀作为图片的目录,例如:文章的文件名为 2019-01-01-sample.md
,我们需要在同级目录下创建文件夹 2019-05-01-sample
,
并在里面保存当前文章中的图片(封面、插图等)。
排期
为了尽可能满足你期望的发布日期,可以自行选择,但同时需要满足如下的条件:
- 为保障大家有足够的时间进行 Review,建议排到一周以后
- 工作日
- 避免同一天有相同类型的文章
文件名
文件名前缀为“年月日”,中间部分需要以英文来描述,英文字母需要全部小写。例如:2019-01-01-sample.md
。
字段
文件中的字段,是为了描述文章相关的必要信息。具体的说明请参考:sample.md。