Dialect

在语言之间进行翻译

在本页面您可以了解如何为Dialect做出贡献。如果您对该应用程序的一般信息感兴趣,请访问GNOME 应用程序页面

应用程序翻译

应用程序的原始文本通常使用美式英语编写。翻译人员可以单独添加其他语言的翻译。翻译通常包括应用程序的用户界面以及在诸如 软件apps.gnome.org 之处显示的元数据。在此上下文中常用的缩写是 l10n(本地化)和 i18n(国际化)。

此项目的翻译通过 Weblate 托管进行管理。该平台不属于 GNOME 项目。

尝试最新版本

在报告问题或提出功能建议时,基于应用程序的最新版本进行报告可能会有所帮助。为此,您可以检查下面的安装方法。

从 Flathub 安装

如果您发现问题或想要提出更改,您应该尝试确保您已经试用了 Dialect 的最新版本。您可以在应用程序的“关于”部分查看当前版本。

Flathub 上发布的最新版本是 2.6.1。

质量测试

在稳定版本发布之前捕获问题和回归对于项目来说非常有价值。您可以通过尝试即将发布的版本来提供帮助。

您可以通过 手动构建应用程序 并试用它来做到这一点。

追踪问题

对于许多应用程序,问题追踪器是应用程序开发协调的中心位置。它不仅用于跟踪所有现有问题,还用于计划新功能和其他杂项任务。

报告发现的问题

报告在使用应用程序时发现的问题对于应用程序维护者来说非常有价值。但是,处理问题报告也可能需要大量时间。您可以尝试执行以下步骤来分担一些工作

诊断已列出的问题

追踪问题的确切原因是一项非常重要的任务。特别是对于带有“需要诊断”或“需要信息”等标签的问题。如果您可以重现,也就是说,您可以自己触发报告的问题,您可以尝试深入挖掘。这可以从找出问题出现的确切条件,到使用 启用调试输出 运行应用程序,再到将调试输出添加到缩小问题范围的代码中。

建议功能

大多数应用程序也通过问题追踪器处理功能请求。请注意,实现功能并在未来将其作为代码库的一部分进行维护可能需要大量的额外工作。因此,您应该考虑新功能是否甚至足够相关,才能成为此应用程序的一部分。

在建议新功能时,有帮助的是专注于该功能应该解决的实际问题。而不是应用程序应该如何解决问题或确切的实现方式。最好还能提供一个实际的例子,说明您需要该功能的情况。

寻找任务

问题追踪器还可以帮助您找到可以处理的开放任务。在实现新功能之前,通常最好先与维护者确认是否会接受针对此功能的合并请求。

处理代码

无论您是想修复拼写错误、更改用户界面还是处理应用程序的代码,以下信息都可以帮助您入门。第一步是在您的计算机上构建应用程序,以便您可以尝试进行更改。之后,您可以查看提供的文档,了解如何完成各自的任务。随后的部分将向您展示如何提交您的更改。

如果您计划对应用程序进行较大规模的更改或添加,通常最好先与应用程序的维护者确认该更改是否会被接受。为此,您应该首先通过执行最初的实现步骤来说服自己可以处理该任务,然后通过问题追踪器与维护者确认。这也是检查项目是否有活跃维护者可以接受您的贡献的好方法。尽管我们尽了最大的努力,但并非所有项目都始终得到持续维护。

请注意,虽然许多社区成员乐于在您遇到困难时为您提供帮助,但维护者通常可能没有资源来指导您完成贡献。

如果您对处理现有的 GNOME 应用程序感到不知所措,您也可以查看 构建您自己的应用程序 以便先进行学习。

构建应用程序

在更改应用程序时,您通常希望使用更改在您的计算机上构建和测试应用程序。对于大多数应用程序,可以使用 Builder 应用程序大大简化此过程。

启动 Builder 后,您可以选择克隆一个项目。这将把应用程序下载到您的计算机上。

克隆仓库…

您必须输入仓库位置。正确的 URL 可以从下面复制。

仓库 URL
克隆仓库

根据您的互联网连接和项目的大小,克隆项目可能需要一段时间。在 Builder 完成此步骤后,应该打开项目窗口。您可能需要确认安装一些必需的依赖项。要尝试是否可以成功构建和启动应用程序,您现在可以按“运行项目”按钮。

Dialect

如果一切顺利,应用程序应该构建完成。构建完成后,构建的应用程序应该自动启动。

Python 语言

此应用程序使用 Python 编程语言构建。

如果您熟悉 Python 语言 的基础知识,我们建议您阅读 初学者教程,该教程也涵盖 Python 语言。您可以在下面找到其他重要资源。

有用的应用程序

提交您的工作

在更改项目后,您可以提交它们以供审核。我们的目标是创建所谓的合并请求拉取请求。这意味着建议更改项目的代码和数据。

设置 GitHub

我们首先在 GitHub 上进行一些准备,该项目就在这里托管。如果您是第一次进行此操作,此过程可能看起来有些复杂,但随着时间的推移,您会逐渐习惯。

  1. 第一步是如果您还没有 GitHub 帐户,请创建一个新的 GitHub 帐户。您只需使用链接的网络表单即可。

  2. 接下来,我们希望确保您计算机上的 git 也可以使用您的 GitHub 帐户。为此,您需要一个 SSH 密钥。如果您还没有 SSH 密钥,可以使用生成一个新的密钥,方法是使用Console。或者,您可以使用密码和密钥应用程序生成一个密钥。

  3. 现在,您必须将您的公共 SSH 密钥添加到 GitHub 上的“SSH 密钥”设置。公共 SSH 密钥存储在您的主目录中的.ssh文件夹中,文件后缀为.pub。您可以使用命令cat ~/.ssh/*.pub打印所有公共 SSH 密钥。您还可以使用密码和密钥应用程序查看公共 SSH 密钥。

创建您自己的项目副本

要提出对项目的更改建议,您首先必须在 GitHub 上创建您自己的项目副本。创建此副本也称为forking。您需要您自己的副本 – 或fork – 来上传您的更改到此副本。

  1. 首先,您可以通过GitHub 页面来 fork Dialect。您只需要为每个您参与的项目执行一次此操作。

  2. 现在,我们必须找到您 fork 的 SSH URL。您可以在创建 fork 后重定向到的页面上找到它。fork 的页面也会列在您的个人资料中。URL 在“SSH”下方的“代码”按钮下可用。
  3. 现在,我们必须通过此 URL 让您本地项目中的 git 知道您在 GitHub 上的个人副本。为此,我们需要返回命令行。首先,您必须更改 (cd) 到您一直在使用的项目。之后,您可以使用命令

    $ git remote add my-copy <ssh-fork-url>
    

    其中 <ssh-fork-url> 必须替换为您在上一步骤中查找的 SSH URL。

创建合并请求

现在我们到达了使用 git 时更常规的任务。

  1. 首先,我们想切换到所谓的另一个分支。分支是原始代码的变体,您可以在其中,例如,开发一个功能,直到它准备好进入实际使用的代码。为此,您可以调用

    $ git checkout -b my-changes
    

    其中 my-changes 是您正在处理的内容的简短描述,不含空格。

  2. 接下来,我们想使用 git 保存您所做的更改。这通常被称为创建提交。您可以使用以下命令执行此操作

    $ git commit -am "Commit Message"
    

    提交消息应描述您的更改。您可以了解更多关于 选择合适的提交消息 的信息。

  3. 现在,我们必须将您的保存的更改上传到 GitLab。幸运的是,我们已经在之前的 git remote add 命令中完成了所有设置。剩下的就是调用

    $ git push my-copy
    
  4. 我们终于到了最后一步。如果您在之前的 git push 命令之后查看控制台中的输出,您可能会看到一个网站链接,显示您如何创建拉取合并请求。您可以按住 Ctrl 键并单击它来打开它。剩下的就是按照网站上的说明来完成提交您的更改。

选择语言