阅读Docs时事通讯-2023年2月

新闻和更新

以下是自以前的新闻稿以下为:

  • 🪄生成输出现在存储在一个众所周知的位置:_阅读文档/<格式>.这为生成和处理最终输出格式提供了许多新的、令人兴奋的可能性,我们将在即将发布的博客文章中揭示这一点。MkDocs的PDF加密文档只是我们准备好的两个演示。敬请期待!

  • 🌪️ 上传速度更快,并行完成,感谢我们迁移到rclone(克隆)分阶段部署以确保可用性。

  • 🔒对我们批准的API端点的跨站点请求现在拒绝包含凭据(cookie)的请求。不需要此功能,并有可能引发未来的安全问题。

  • 🛠️ 现在可以在手动导入中正确检测Git存储库的默认分支。这是一个长期存在的错误,我们非常乐意修复。

  • 🔒发现并修复了安全问题:路径遍历:从任何项目访问文件.

  • 🔒发现并修复了安全问题:Symlink following:从生成器服务器进行任意文件访问

  • 🔒发现并修复了安全问题:缓存中毒

  • 🎤Write the Docs已宣布其2023年会议。在中阅读更多信息他们的声明.

您可以在我们的阅读文档更改日志.

即将推出的功能

  • 构建过程的更多内部组件将具有公共API,提供完全控制和灵活性,并允许使用更多文档工具。

  • 我们的Diátaxis文档重构正在进入第一次发布之前的最后阶段。

对所有细节感兴趣吗?查看我们的完整路线图📍

可能的问题

  • 🚦Cloudflare上有一个时间表维护窗口,提供CDN和SSL供应。我们正在努力确保除了创建新域之外,没有其他东西处于脱机状态:

    2023年2月14日,Cloudflare将进行数据库维护,这将影响SSL API的可用性,并可能导致证书颁发延迟。计划维护时间为2023年2月14日14:00-16:00 UTC。

  • 标准构建输出目录的更改将给任何拥有自定义构建并猜到旧的非官方输出目录的人带来问题。请参阅中的技术详细信息阅读docs.org#9888

  • 如果您想将狮身人面像6与狮身人身像rtd-theme结合使用,我们已经发布了新主题的更新和平台上处理从Sphinx中删除jQuery的更新。另请参见狮身人面像6已经出局,有重要的突破性变化.

  • 关于前一次更新,我们删除了一个旧设置的注入html_theme_path与非常古老的狮身人面像一起使用<1.6.如果您正在使用此版本的狮身人面像构建文档,请注意这一点。建议对该问题进行修复,以升级您的Sphinx版本。

很棒的阅读文档项目🕶️

寻找更多灵感?我们继续建设很棒的阅读文档项目🕶️,一个充满灵感的文档项目列表。

欢迎您在存储库中打开问题或拉入请求并提供建议。


问题?评论?对下一份新闻稿有什么想法?联系我们