备稿指南

[iugo]

什么是备稿

一般新闻都是时效性的, 但我们这里的 news 并不是严格意义上的新闻, 只是通过某些我们最近了解到的事件, 来学习一些知识或抒发一下想法.

因为团队每天分享一次, 如果一天内多人都有值得分享的内容, 可以提前记录一下, 方便下一次分享. 这就是备稿.

稿件格式

一篇稿件有三个组成部分:

1. 新闻出处.
2. 作者看法.
3. 评论.

其中, 前两者一定要有.

新闻出处可以是一个具体链接, 可以包含部分摘抄, 也可以是一则见闻, 或者最近工作中遇到的具体问题, 甚至是最近灵光乍现的某个想法. 如果为转载, 则必须给出链接, 如果没有没有链接, 则可以值给出出处或截图.

作者一定有看法, 可以融会到稿件内, 也可以在后面单独写. 但一定要有自己的看法.

评论为作者以外的其他人对作者稿件的看法, 可以匿名. 允许没有评论.

代码提交方式

团队内程序对仓库都有 Write 权限, 可以直接提交到仓库. 也可以开新分支进行 PR. 不必 fork.

如何使用关键词关闭 issues

重要的关键词主要有是三个: close, fix, resolve.

比如 Closes #10.

详细文档: https://help.github.com/en/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword

建议在 commit 中 close 相关 issue.

关于写目录

每次提交的时候记得修改 index.md 文件, 将链接放在目录中.

暂时还没有标签.

[iugo]

如何写 Jekyll

官网: https://jekyllrb.com/docs/permalinks/
第三方: https://learn.cloudcannon.com/jekyll/date-formatting/
其他: https://gist.github.com/Phlow/57eb457898e4ac4c4a20
https://blog.webjeda.com/jekyll-categories/

链接是什么?
内容如何分类? pages 不基于日期, posts 类似 blog, collections 组织相关内容
posts 如何分类? categories, tags
如何出列表? (Liquid)
列表如何排序? (Liquid)

https://jekyllrb.com/docs/posts/#categories-and-tags