通信指南#
博客#
我们在 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跟踪。
草稿审查#
请求审核#
一旦你认为你完成了,请让别人重新阅读你的帖子,并在发布前检查你可能忘记的各种参数。你不是一个人,这是团队合作,我们在这里帮助你。如果我们匆忙行事,你可能会花更多时间修复错误,而不是一开始就做对事情。
编辑接受#
发布帖子#
通常,编辑或管理员会负责发布帖子。编辑/管理员的任务是检查所有元数据是否正确设置,确保没有使用外部图片,以及进行之前描述的所有其他质量检查。
接下来只需要让帖子对所有人可见。
修改现有帖子#
帖子更新#
博客订阅者可能会在每次更新时收到通知。因此,请谨慎使用更新和修复。等待几个小时来修复一个错别字是可以的。
如果需要进行一些实质性的更新,例如更改地点、时间等,请在顶部(或根据重要性在博客文章的底部)插入一个 [更新] 部分,并附上更新日期/时间。如果博客正文中的信息有误,尽量不要替换它,只需使用删除线标记为过时。这将有助于读者在处理多个提供不同信息的来源时,确定哪些信息是正确的。
网站#
文档正在编写中。