本文档描述了开源技术通讯《科技爱好者周刊》的发布工作流程。它概述了内容如何在一周内进行收集、策划、格式化、发布和分发。有关通讯内容类别的信息,请参阅内容类别。
发布工作流程始于内容收集和策划,这贯穿于整个星期。该过程包括作者的主动搜索和社区的贡献。
来源:README.md1-7 issue-106.md1-8 issue-344.md1-7
该通讯内容来自多个来源
主动研究:作者在一周内研究和收集有趣的科技相关内容。
社区贡献:读者可以通过 GitHub issue 提交内容建议。
投稿,推荐或自荐文章/软件/资源,请提交 issue。
这种协作方式确保了内容的多样性,同时通过编辑策划保持了内容的一致性。
来源:README.md5
每期通讯都遵循一致的结构和格式指南,以确保可读性和读者熟悉的使用体验。
来源:issue-106.md issue-344.md issue-343.md
每期通讯包含以下标准部分
| 章节 | 描述 | 位置 |
|---|---|---|
| 标题 | 期号和介绍 | 文档顶部 |
| 封面图片 | 带说明的视觉元素 | 期初 |
| 主要话题 | 深入探讨一个与技术相关的主题 | 封面图片后 |
| 新闻 | 最新科技发展 | 主要话题后 |
| 文章 | 精选文章链接,附带简短描述 | 中间部分 |
| 工具 | 软件工具和应用程序 | 中间部分 |
| 资源 | 学习材料和参考资料 | 中间部分 |
| 图像 | 有趣的图片和说明 | 后期 |
| 引号 | 发人深省的引语 | 接近结尾 |
| 审核 | 过往期数链接 | 结尾 |
| 订阅 | 订阅方式信息 | 结尾 |
来源:issue-106.md9-391 issue-344.md7-392
每周通讯于每周五通过多个渠道发布,以触达广泛的受众。
来源:README.md9-643 issue-106.md386-394
文件创建:在 docs/ 目录中创建一个新的 Markdown 文件,遵循 issue-[数字].md 的命名约定。
添加内容:根据标准结构格式化内容并添加到文件中。
更新索引:更新 README.md 文件,包含指向新期的链接。
- 第 XXX 期:<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/标题" undefined file-path="标题">Hii</FileRef>
在 GitHub 发布后,内容会通过以下渠道分发:
作者博客:内容发布在阮一峰的个人博客上。
微信公众号:内容通过作者的微信公众号分发。
这种跨平台的方式确保了通讯能够触达偏好 GitHub 的技术读者以及通过更主流渠道访问内容的广大读者。
该通讯通过多种机制保持与社区的活跃互动
读者可以通过多种方式做出贡献
内容建议:通过 GitHub issue 提交有趣的科技相关内容。
招聘信息:通过 GitHub issue 维护一个专门的招聘信息线程。
讨论区的《谁在招人》,是一个免费的程序员招聘帖,提供大量就业信息,欢迎访问或发布工作/实习岗位。
这种协作方式创造了一个反馈循环,丰富了通讯内容,同时围绕共同兴趣建立了社区。
该仓库包含多种方法,帮助读者搜索存档的期刊并查找相关内容。
通讯提供了三种主要方式来搜索存档内容
GitHub 网页搜索:使用 GitHub 的内置搜索功能。
Sourcegraph:使用 Sourcegraph.com 搜索仓库。
本地 Grep:克隆仓库到本地并使用 grep 进行搜索。
这些搜索功能使读者能够跨越数百期通讯找到特定主题,使整个存档成为一个有价值的知识库。
每周通讯的发布遵循一个持续的周期,新一期于每周五发布。
来源:README.md3 issue-106.md381-385
这个持续的发布周期自 2018 年以来一直保持着通讯的常规日程,建立了大量科技相关内容的存档,并且这些内容仍然易于访问和搜索。
《科技爱好者周刊》的发布工作流程结合了内容策划、一致的格式、多渠道分发和社区互动,以实现可持续的每周发布。该流程平衡了编辑控制和社区输入,创造了一个通讯,它既是当前科技的摘要,也是读者可用的存档资源。