新的 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。