通信指南#
博客#
我们的博客发布在 https://blog.jupyter.org。我们欢迎 Jupyter 博客的文章构思或客座文章。如果您对未来的文章有建议,请随时与我们分享您的想法。我们很乐意与您讨论这个想法。
您喜欢写作吗?请联系我们,成为客座博主。我们可以指导您完成文章创作过程。
技术概述#
Jupyter 的博客使用 Ghost 博客平台,因为它具有贡献者灵活性和易用性。Jupyter 的博客部署在 https://blog.jupyter.org。
从博客构思到发布文章的基本工作流程#
从博客构思到发布文章的工作流程包括几个主要步骤,包括
获得写作灵感
在 Jupyter 邮件列表中给我们发送消息,并请求获得我们博客的作者账户
创建草稿
草稿审查
编辑审核通过
发布文章
我们将涵盖这些内容以及如何在文章发布后进行更新。
创建草稿#
标题和元数据#
始终检查元数据字段,确保博客文章有标题和规范 URL。可以在规范 URL 中加入日期,特别是对于像 jupyter-day 这样可能发生多次的事件。事件日期可能与博客文章的日期不同。
文章发布后,绝不能更改文章的标题或 URL。这些更改会破坏已经引用现有已发布 URL 的推文和 RSS 订阅的链接。请记住,发布时某些平台会立即缓存 URL;因此,更改标题会导致用户访问 404 页面。
标题和元数据可以在博客实际内容撰写完成后进行修改,但发布后不应更改。作为客座作者,您无需担心元数据,编辑或管理员会处理。
使用图片#
尽量不要链接到外部图片。如果您想在文章中插入图片,请在编辑视图中插入 ![]()
,然后将图片从桌面拖放到新创建的预览字段中。外部图片可能会更改,如果它们被删除,可能会导致博客文章损坏。如果您拖放图片,则不会发生这种情况。此外,这些图片将从与博客相同的 CDN(内容分发网络)提供,这将确保为我们的读者提供最佳的整体体验。
您在博客文章顶部看到的特色图片是在元数据字段中设置的,而不是使用 ![]()。特色图片与内联图片在许多新闻阅读器(尤其是在移动设备上)中的处理方式不同,它允许慢速连接的用户更早地阅读博客内容,这比等待特色图片渲染对用户来说是更好的体验。
链接#
尽可能不要使用缩短的链接。缩短链接的多次重定向会降低移动浏览体验。如果您需要页面浏览量的分析,此信息由 Google Analytics 跟踪。
草稿审查#
请求审查#
一旦您认为您已完成,请让其他人重新阅读您的文章,并检查您在发布前可能忘记的各种参数。您不是孤军奋战,这是团队合作,我们在这里帮助您。如果我们匆忙行事,您可能会花更多时间纠正错误,而不是一开始就做好事情。
编辑审核通过#
发布文章#
通常由编辑或管理员负责发布文章。编辑/管理员的任务是检查所有元数据是否设置正确,没有使用外部图片,以及之前描述的所有其他质量检查。
然后就是让文章对所有人可见的问题了。
修改现有文章#
文章更新#
博客订阅者可能会在每次更新时收到通知。因此,请谨慎使用更新和修复。等待几个小时修复一个错字是可以接受的。
如果需要进行重大更新,例如更改地点、时间等,请在博客文章顶部(或底部,取决于重要性)插入一个 [更新] 部分,并附上更新的日期/时间。如果博客正文中的信息有误,请尽量不要替换它,而只使用删除线将其标记为过时。这将有助于读者在处理多个来源提供不同信息时确定哪些信息是正确的。
网站#
文档正在完善中。