菜单

发布流程

相关源文件

本文档描述了开源技术通讯《科技爱好者周刊》的发布工作流程。它概述了内容如何在一周内进行收集、策划、格式化、发布和分发。有关通讯内容类别的信息,请参阅内容类别

内容收集与策划

发布工作流程始于内容收集和策划,这贯穿于整个星期。该过程包括作者的主动搜索和社区的贡献。

来源:README.md1-7 issue-106.md1-8 issue-344.md1-7

内容来源

该通讯内容来自多个来源

  1. 主动研究:作者在一周内研究和收集有趣的科技相关内容。

  2. 社区贡献:读者可以通过 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

GitHub 发布流程

  1. 文件创建:在 docs/ 目录中创建一个新的 Markdown 文件,遵循 issue-[数字].md 的命名约定。

  2. 添加内容:根据标准结构格式化内容并添加到文件中。

  3. 更新索引:更新 README.md 文件,包含指向新期的链接。

- 第 XXX 期:<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/标题" undefined  file-path="标题">Hii</FileRef>

来源:README.md29-643

多渠道分发

在 GitHub 发布后,内容会通过以下渠道分发:

  1. 作者博客:内容发布在阮一峰的个人博客上。

  2. 微信公众号:内容通过作者的微信公众号分发。

这种跨平台的方式确保了通讯能够触达偏好 GitHub 的技术读者以及通过更主流渠道访问内容的广大读者。

来源:issue-106.md387-390

社区互动

该通讯通过多种机制保持与社区的活跃互动

来源:README.md5-7 issue-106.md7

社区贡献

读者可以通过多种方式做出贡献

  1. 内容建议:通过 GitHub issue 提交有趣的科技相关内容。

  2. 招聘信息:通过 GitHub issue 维护一个专门的招聘信息线程。

讨论区的《谁在招人》,是一个免费的程序员招聘帖,提供大量就业信息,欢迎访问或发布工作/实习岗位。

这种协作方式创造了一个反馈循环,丰富了通讯内容,同时围绕共同兴趣建立了社区。

来源:README.md7 issue-106.md7

搜索与导航

该仓库包含多种方法,帮助读者搜索存档的期刊并查找相关内容。

来源:README.md9-27

搜索方法

通讯提供了三种主要方式来搜索存档内容

  1. GitHub 网页搜索:使用 GitHub 的内置搜索功能。

  2. Sourcegraph:使用 Sourcegraph.com 搜索仓库。

  3. 本地 Grep:克隆仓库到本地并使用 grep 进行搜索。

这些搜索功能使读者能够跨越数百期通讯找到特定主题,使整个存档成为一个有价值的知识库。

来源:README.md9-27

持续发布周期

每周通讯的发布遵循一个持续的周期,新一期于每周五发布。

来源:README.md3 issue-106.md381-385

这个持续的发布周期自 2018 年以来一直保持着通讯的常规日程,建立了大量科技相关内容的存档,并且这些内容仍然易于访问和搜索。

总结

《科技爱好者周刊》的发布工作流程结合了内容策划、一致的格式、多渠道分发和社区互动,以实现可持续的每周发布。该流程平衡了编辑控制和社区输入,创造了一个通讯,它既是当前科技的摘要,也是读者可用的存档资源。