通信指南#

博客#

我们在 https://blog.jupyter.org 发布我们的博客。我们欢迎对 Jupyter 博客的文章或客座文章的创意。如果您对未来的文章有任何建议,请随时与我们分享您的想法。我们希望与您讨论这个想法。

您喜欢写作吗?请联系我们,了解如何成为客座博主。我们可以帮助您指导创建文章的过程。

技术概述#

Jupyter 的博客使用 Ghost 博客平台,因为它具有出色的贡献者灵活性并且易于使用。Jupyter 的博客部署在 https://blog.jupyter.org

从博客创意到已发布文章的基本工作流#

从博客创意到已发布文章的工作流中有几个主要步骤,包括

  • 受到启发写一篇博文

  • 在 Jupyter 邮件列表中向我们发送消息,并向我们索取我们博客上的作者帐户

  • 创建草稿

  • 草稿审核

  • 编辑接受

  • 发布文章

我们将介绍这些内容,以及如何在发布文章后更新文章。

创建草稿#

标题和元数据#

始终在元数据字段中检查博客文章是否具有标题和规范 URL。可以将日期放入规范 URL 中,特别是对于可能多次发生的事件(例如 jupyter-day)。事件日期可能与博客文章的日期不同。

文章发布后,切勿更改文章的标题或 URL。这些更改将破坏已经引用现有已发布 URL 的推文和 RSS Feed 的链接。请记住,在发布时,一些平台会立即缓存 URL;因此,更改标题会将人们定向到 404 页面。

在撰写博客的实际内容后,始终可以优化标题和元数据,但不得在发布后进行更改。作为客座作者,您不必担心元数据,编辑或管理员会负责处理这些内容。

使用图片#

尽量不要链接到外部图片。如果您想在文章中放置图片,请在编辑器视图中插入 ![](),然后将图片从您的桌面拖放到预览中新创建的字段中。外部图片可能会发生变化,如果它们被删除,则可能会破坏博客文章。如果您拖放图片,则不会出现这种情况。此外,这些图片将与博客使用相同的 CDN(内容分发网络),这将确保为我们的读者提供最佳的整体体验。

你在博文顶部看到的特色图片是从元数据字段设置的,而不是使用 ![]()。特色图片的处理方式与许多 feedreader(尤其是在移动设备上)中的内联图片不同,并且允许慢速连接的用户更早地阅读博文内容,这比等待特色图片呈现要给用户带来更好的体验。

草稿审查#

要求审查#

一旦你认为你完成了,请让其他人重新阅读你的帖子,并在发布前检查你可能忘记的各种参数。你并不孤单,这是团队合作,我们在这里帮助你。如果你匆忙行事,你可能会花更多时间来修复错误,而不是一开始就正确地做事。

编辑接受#

发布帖子#

通常,编辑或管理员会负责发布帖子。编辑/管理员的任务是检查所有元数据是否设置正确,没有使用外部图像,以及之前描述的所有其他质量检查。

然后,只需让帖子对每个人可见即可。

更改现有帖子#

帖子更新#

博客订阅者可能会在每次更新时收到通知。因此,请谨慎使用更新和修复。等待几个小时来修复拼写错误是可以的。

如果必须进行一些实质性更新,例如更改位置、时间等,请在顶部(或博客文章底部,具体取决于重要性)插入一个 [更新] 部分,其中包含更新的日期/时间。如果博客正文中的信息不正确,请尝试不要替换它,而只是使用删除线将其标记为过时。这将帮助读者在处理提供不同信息的多个来源时确定哪些信息是正确的。

时事通讯#

文档正在进行中。

网站#

文档正在进行中。