编辑文本文件
在本页面您可以了解如何为文本编辑器做出贡献。如果您对此应用程序的一般信息感兴趣,请访问 GNOME 应用页面。
应用程序的原始文本通常使用美式英语编写。翻译人员可以单独添加其他语言的翻译。翻译通常包括应用程序的用户界面以及在诸如 软件 或 apps.gnome.org 之处显示的元数据。在此上下文中常用的缩写是 l10n(本地化)和 i18n(国际化)。
此应用程序通过名为 Damned Lies 的 GNOME 翻译系统 进行翻译。
在报告问题或提出功能建议时,基于应用程序的最新版本进行报告可能会有所帮助。为此,您可以检查下面的安装方法。
如果您发现问题或想要提出更改,您应该尝试确保您已经试用了文本编辑器的最新版本。您可以在应用程序的“关于”部分查看当前版本。
Flathub 上发布的最新版本是 49.0。
此应用程序允许安装其当前开发状态的版本。 这种安装传统上每天生成一次,因此被称为“夜间构建版本”。 如今,它们通常在主开发版本发生变化时重新生成。
警告:应用程序的夜间构建版本仅应用于测试,不应用于实际任务。 您可以通过应用程序图标和应用程序标题栏中的条纹来识别应用程序的夜间构建版本。 它们通常使用与其他安装此应用程序不同的配置。 但是,不能保证这些应用程序的安装能够按预期工作。 在没有备份的情况下,切勿使用应用程序的夜间构建版本处理数据。
如果夜间仓库已经 配置,夜间版本也可以通过 Console 安装。
$ flatpak install gnome-nightly org.gnome.TextEditor.Devel
$ flatpak run org.gnome.TextEditor.Devel
在稳定版本发布之前捕获问题和回归对于项目来说非常有价值。您可以通过尝试即将发布的版本来提供帮助。
这在 功能冻结期间尤其有用,该期间致力于查找和修复错误。
您可以通过试用应用程序的 nightly build 来做到这一点。
作为核心应用程序,它也预装在 GNOME OS Nightly 上,您可以将其安装为虚拟机。
对于许多应用程序,问题追踪器是应用程序开发协调的中心位置。它不仅用于跟踪所有现有问题,还用于计划新功能和其他杂项任务。
报告在使用应用程序时发现的问题对于应用程序维护者来说非常有价值。但是,处理问题报告也可能需要大量时间。您可以尝试执行以下步骤来分担一些工作
搜索问题追踪器,以确定问题是否已报告。
检查问题是否也存在于 应用程序的最新版本 中。
如果适用,请尝试确定问题在什么确切情况下发生。
报告所有潜在的相关信息,例如暴露该行为的应用程序版本。
追踪问题的确切原因是一项非常重要的任务。特别是对于带有“需要诊断”或“需要信息”等标签的问题。如果您可以重现,也就是说,您可以自己触发报告的问题,您可以尝试深入挖掘。这可以从找出问题出现的确切条件,到使用 启用调试输出 运行应用程序,再到将调试输出添加到缩小问题范围的代码中。
大多数应用程序也通过问题追踪器处理功能请求。请注意,实现功能并在未来将其作为代码库的一部分进行维护可能需要大量的额外工作。因此,您应该考虑新功能是否甚至足够相关,才能成为此应用程序的一部分。
在建议新功能时,有帮助的是专注于该功能应该解决的实际问题。而不是应用程序应该如何解决问题或确切的实现方式。最好还能提供一个实际的例子,说明您需要该功能的情况。
问题追踪器还可以帮助您找到可以处理的开放任务。在实现新功能之前,通常最好先与维护者确认是否会接受针对此功能的合并请求。
此应用程序还具有标记为“新手”的任务。这些任务通常需要较少的先验知识或复杂度较低。
无论您是想修复拼写错误、更改用户界面还是处理应用程序的代码,以下信息都可以帮助您入门。第一步是在您的计算机上构建应用程序,以便您可以尝试进行更改。之后,您可以查看提供的文档,了解如何完成各自的任务。随后的部分将向您展示如何提交您的更改。
如果您计划对应用程序进行较大规模的更改或添加,通常最好先与应用程序的维护者确认该更改是否会被接受。为此,您应该首先通过执行最初的实现步骤来说服自己可以处理该任务,然后通过问题追踪器与维护者确认。这也是检查项目是否有活跃维护者可以接受您的贡献的好方法。尽管我们尽了最大的努力,但并非所有项目都始终得到持续维护。
请注意,虽然许多社区成员乐于在您遇到困难时为您提供帮助,但维护者通常可能没有资源来指导您完成贡献。
如果您对处理现有的 GNOME 应用程序感到不知所措,您也可以查看 构建您自己的应用程序 以便先进行学习。
在更改应用程序时,您通常希望使用更改在您的计算机上构建和测试应用程序。对于大多数应用程序,可以使用 Builder 应用程序大大简化此过程。
启动 Builder 后,您可以选择克隆一个项目。这将把应用程序下载到您的计算机上。
您必须输入仓库位置。正确的 URL 可以从下面复制。
根据您的互联网连接和项目的大小,克隆项目可能需要一段时间。在 Builder 完成此步骤后,应该打开项目窗口。您可能需要确认安装一些必需的依赖项。要尝试是否可以成功构建和启动应用程序,您现在可以按“运行项目”按钮。
如果一切顺利,应用程序应该构建完成。构建完成后,构建的应用程序应该自动启动。
此应用程序是用 C 编程语言构建的。
要开始使用 C 开发 GNOME 应用程序,我们推荐 初学者教程,该教程也涵盖 C 语言。您可以在下方找到其他重要资源。
在更改项目后,您可以提交它们以供审核。我们的目标是创建所谓的合并请求或拉取请求。这意味着建议更改项目的代码和数据。
我们从 GNOME GitLab 上的一些准备工作开始,项目托管在那里。如果您是第一次执行此操作,此过程可能看起来很复杂,但随着时间的推移,您会越来越习惯它。
第一步是如果您还没有 GNOME GitLab 帐户,请 创建一个新的 GNOME GitLab 帐户。您只需使用链接的 Web 表单即可完成此操作。
接下来,我们希望确保您计算机上的 git 也可以使用您的 GNOME GitLab 帐户。为此,您需要一个 SSH 密钥。如果您还没有 SSH 密钥,可以使用 生成一个新密钥 使用 控制台。或者,您可以使用 密码和密钥 应用程序生成一个密钥。
现在您必须将您的公共 SSH 密钥添加到 GNOME GitLab 上的 “SSH 密钥”设置 中。公共 SSH 密钥存储在您的主目录的 .ssh 文件夹中,文件以 .pub 结尾。您可以使用命令 cat ~/.ssh/*.pub 打印所有公共 SSH 密钥。您也可以使用密码和密钥应用程序查看公共 SSH 密钥。
要建议对项目进行更改,您首先必须在 GNOME GitLab 上创建项目的副本。创建此副本也称为分叉。您需要您自己的项目副本 – 或分叉 – 来上传您的更改。
注意: 要分叉仓库,您必须将 SSH 密钥添加到您的 GitLab 帐户,如 上述 所示。添加 SSH 密钥后,可能需要最多 20 分钟才能使用分叉功能。
首先,您可以通过 GNOME GitLab 页面 分叉文本编辑器。您只需要为每个您参与的项目执行一次此操作。
现在,我们必须让您本地项目的 git 通过此 URL 了解您在 GNOME GitLab 上的个人副本。为此,我们需要返回命令行。首先,您必须使用 (cd) 切换到您一直在使用的项目。然后,您可以使用命令
$ git remote add my-copy <ssh-fork-url>
其中 <ssh-fork-url> 必须替换为您在上一步骤中查找的 SSH URL。
现在我们到达了使用 git 时更常规的任务。
首先,我们想切换到所谓的另一个分支。分支是原始代码的变体,您可以在其中,例如,开发一个功能,直到它准备好进入实际使用的代码。为此,您可以调用
$ git checkout -b my-changes
其中 my-changes 是您正在处理的内容的简短描述,不含空格。
接下来,我们想使用 git 保存您所做的更改。这通常被称为创建提交。您可以使用以下命令执行此操作
$ git commit -am "Commit Message"
提交消息应描述您的更改。您可以了解更多关于 选择合适的提交消息 的信息。
现在,我们必须将您的保存的更改上传到 GitLab。幸运的是,我们已经在之前的 git remote add 命令中完成了所有设置。剩下的就是调用
$ git push my-copy
我们终于到了最后一步。如果您在之前的 git push 命令之后查看控制台中的输出,您可能会看到一个网站链接,显示您如何创建拉取或合并请求。您可以按住 Ctrl 键并单击它来打开它。剩下的就是按照网站上的说明来完成提交您的更改。