欢迎使用Sage开发人员指南

备注

Sage开发迁移到 GitHub 2023年2月，从 the Sage Trac server 在很长一段时间里，它一直是Sage发展的中心。在过渡之后，本指南进行了相应的更新。然而，在当前Sage发展的许多方面，遗产仍然与我们同在。

每个使用Sage的人都被鼓励在某个时候回馈Sage。您可以：

  • 向文档中添加示例

  • 查找错误或打字错误

  • 修复错误

  • 实现新函数或创建新类

  • 为数学主题贡献有用的教程

  • 将现有文档翻译成新语言

  • 升级包，创建一个快速的新C库，等等。

本文档告诉您完成上述所有操作所需了解的内容。我们还将讨论如何与全球其他Sage用户共享您的新代码和修改后的代码。

首先，您当然需要您自己的Sage源代码副本来更改它。使用我们的 Installation guide 获取源代码并从源代码构建Sage。如果您以前从未从事过软件工作，请密切关注在您的平台上构建的先决条件。

下面是本指南的简要概述。

  • 第一步 ：要与Sage社区共享更改，您需要了解修订控制。我们使用Git软件来实现这一目的。在这里，我们将带您完成从在您的平台上设置Git到准备一个本地分支以与所有Sage用户共享的过程。

    备注

    作为一种简单的入门方法，您可以运行和编辑Sage的代码，并使用 Gitpod ，一个基于VS Code的免费在线开发环境。它将启动一个预制的工作区，其中安装了所有依赖项和工具，这样您就可以立即开始贡献。开始方式 going to Gitpod ，并阅读 our Gitpod guidelines 了解更多信息。

  • 使用GitHub ：所有更改都要经过 the Sage repository on GitHub 在某种程度上。它包含错误报告、增强建议、正在进行的更改，甚至包括Sage今天的所有历史。您必须熟悉它才能参与Sage开发。

  • 使用Git ：在这里，我们给出了使用Git进行Sage开发的深入指南。如果您在棘手的情况下需要Git的帮助，如合并冲突，请阅读本文。

  • 为Sage编写代码 ：这是关于编写代码和文档的约定的指南。初级开发人员应该阅读这篇文章才能成为一名优秀的开发人员。随着约定随着时间的推移而发展，也有经验的Sage贡献者可能想偶尔回顾一下这一章。

  • 测试Sage ：我们最重视测试Sage。Sage源代码的每一次更改都有破坏Sage的风险，在合并之前必须进行测试。这部分解释了我们用来帮助测试Sage的各种工具。

  • 更新SAGE文档 ：Sage的所有功能都记录在我们的手册中。本部分介绍更新SAGE文档的技术方面。

  • 有关为Sage编码的更多信息 ：当您需要了解Sage深度编码的技术细节时，请阅读以下内容。

  • 包装 ：Sage由许多第三方程序包和自己的分发程序包组成。本部分面向高级开发人员。

有关更多详细信息，请参阅下面的目录。无论你从哪里开始，祝你好运，欢迎来到圣贤发展！

目录表

第一步

使用GitHub

使用Git

为Sage编写代码

测试Sage

更新SAGE文档

有关为Sage编码的更多信息

包装

索引和表格

这部作品是按照 Creative Commons Attribution-Share Alike 3.0 License 。