跳到主要内容

新的 conda-forge.org

您可能已经注意到,在过去的几个月中,我们一直在更改 conda-forge.org 网站的不同部分。阅读更多内容以了解我们更改了什么、它是如何工作的以及如何贡献。

旧版与新版

旧版 conda-forge.org 文档是使用 Sphinx 编写的。一些额外的扩展负责网站的其他部分;例如 博客RSS feed首页Feedstock 输出状态页面

新网站已使用 Docusaurus 项目重写。这使我们能够为网站的所有部分使用单一框架。如果我们将新网站与旧网站进行比较,会发现一些重大差异

  • Sphinx 是用 Python 编写的。Docusaurus 使用 Node.js 堆栈。
  • 我们的大部分文档是用 RST 编写的。Docusaurus 处理 Markdown 和 MDX(Markdown + JSX)。
  • 我们现在不再从 Jinja 模板生成静态 HTML,而是更喜欢获取 JSON 有效负载并在构建时(即当我们运行 npm run build 时)或加载时(当用户访问网站时)渲染相关页面。这允许将所有网站渲染逻辑放在同一个存储库中,并具有统一的主题、搜索引擎和统计信息。

我们更改了什么

  • 整个站点的主题是响应式的、可访问的、移动友好的,并支持深色/浅色模式。样式指南也可用。
  • 状态仪表板动态获取数据,并为每次迁移提供详细视图。
  • “软件包”部分列出了最新更新,以及软件包到 feedstock 的映射。
  • 新的“下载”页面显示了最新 Miniforge 安装程序的链接。
  • 文档已分为两个顶级类别:“文档”和“社区”。
  • Algolia 为搜索栏慷慨地提供了后端服务。
  • Netlify 将为每个打开的 PR 渲染预览,以实现更顺畅的贡献过程。
  • 博客文章和公告 feed 由 Docusaurus 原生提供服务。
  • 我们将所有 Sphinx 原生的 ReStructuredText 文档转换为 Docusaurus 友好的 Markdown。
  • conda-forge.yml 文档是从 conda-smithy 模式自动生成的。
  • ……以及文档中的一些较小的更改。有关更多信息,请参阅元问题

您可以使用的新功能

  • 主文档部分了解如何使用和维护来自 conda-forge 的软件包。
  • 社区部分阅读有关我们社区如何建立的信息
  • 我们基础设施的最新更改将在新闻中公布。您还可以订阅RSS feed 并浏览存档
  • 有关生态系统的重要信息在博客中讨论。您还可以订阅RSS feed 并浏览存档。帖子有时也按标签分类。
  • 使用搜索栏查找网站中的任何文档!它应该足够智能,可以记住您更经常需要的内容。使用 Cmd/Ctrl+K 快捷键可更快访问。
  • 状态仪表板将告知您最新的事件和正在进行的迁移。现在,每次迁移都有一个您可以探索和分享的永久链接!
  • 软件包部分将帮助您查找 conda-forge 中的所有软件包。如果您在搜索栏中未键入任何内容,它将列出最近 100 个上传到 Anaconda.org 频道的内容。每行中的元数据链接将带您到 conda-metadata-app 仪表板
  • 使用下载页面获取最新的 Miniforge 安装程序。

如何帮助和贡献

我们已经更改了很多内容,因此我们有可能在某些地方遗漏了一些东西。如果您有建议或错误要报告,请在网站问题跟踪器中告知我们。也请随时查看文档贡献指南

致谢

这次改版是历时数月的努力。核心团队想借此机会感谢所有为此做出贡献的贡献者(按字母顺序排列):Afshin Darian、Asmit Malakannawar、Gabriela Vives、Isabela Presedo-Floyd、Klaus Zimmermann、Tania Allard。