使用 git 进行 Debian 网站开发

使用 Git 存储库开展工作
Git 存储库写入权限
接收通知

使用 Git 存储库开展工作

让我们直奔主题——本节中您将了解如何创建主存储库的本地副本、如何使本地副本保持最新，以及如何提交您的工作。我们也会介绍如何开展翻译工作。

获取一份本地副本

首先，安装 Git。然后，配置 Git 并输入您的姓名和电子邮件地址。如果您是 Git 的新用户，先阅读通用的 Git 文档可能是个好主意。

下一步是克隆存储库（换句话说，对其创建本地副本）。有两种方法：

在 https://salsa.debian.org 上注册一个帐户，并通过将 SSH 公钥上传到您的 salsa 帐户来启用 SSH 访问。更多信息，请参见 Salsa 帮助页面。然后，您可以使用以下命令克隆 webwml 存储库：
```
  git clone git@salsa.debian.org:webmaster-team/webwml.git
```
另一种方式是，您可以使用 HTTPS 协议克隆存储库。请注意，虽然这会创建一个本地副本，但是您将无法直接以这种方式将修改直接推送回远程仓库：
```
  git clone https://salsa.debian.org/webmaster-team/webwml.git
```

提示：克隆整个 webwml 存储库需要下载大约 1.3 GB 的数据，如果您的网络连接太慢或不稳定，这个数据量就太大了。所以，可以先以最小深度进行克隆，以减少首次下载的数据量：

  git clone git@salsa.debian.org:webmaster-team/webwml.git --depth 1

获得可用的（浅）存储库后，您可以加深本地副本，并最终将其转换为完整的本地存储库：

  git fetch --deepen=1000 # 为仓库加深 1000 次提交
  git fetch --unshallow   # 获取所有未获取的提交，将仓库转换成完整的

您也可以仅检出部分页面，如下所示：

git clone --no-checkout git@salsa.debian.org:webmaster-team/webwml.git
cd webwml
git config core.sparseCheckout true
在 webwml 中创建文件 .git/info/sparse-checkout，定义您想要检出的内容。例如，如果您只想要基本文件、英语、加泰罗尼亚语和西班牙语翻译，文件内容应该像下面这样：
```
      /*
      !/[a-z]*/
      /english/
      /catalan/
      /spanish/
    
```
最后，您就可以检出库：git checkout --

提交本地修改

令您的本地仓库保持最新

每隔几天（也一定要在开始一些编辑工作之前！），您应该运行一次

  git pull

以从存储库中获取已被更改的文件。

强烈建议在执行 git pull 和开始编辑文件之前保持本地 Git 工作目录的干净。如果您有未提交的更改，或者当前分支的远程存储库中不存在的本地提交，则执行 git pull 将会自动创建合并提交，甚至会由于冲突而导致拉取失败。请考虑将未完成的工作保存在另一个分支中，或使用 git stash 之类的命令。

注意：Git 是一个分布式（而非集中式）版本控制系统。这意味着当您提交更改时，它们将仅存储在本地存储库中。要与他人共享它们，您还需要将所做的更改推送到 Salsa 上的中央存储库。

示例：编辑文件

让我们看一个更实际的例子，也就是典型的编辑过程。我们假设您已经使用 git clone 获得了库的一份本地副本。接下来的步骤是：

git pull
现在您可以开始编辑并对文件进行修改。

当您完成后，使用以下命令将您的更改提交到本地存储库：

    git add /path/to/file(s)
    git commit -m "Your commit message"

如果您有对远程 webwml 存储库的不受限制的写入权限，那么现在可以将您所做的更改直接推送到 Salsa 存储库中：git push
如果您无权直接写入 webwml 存储库，请考虑使用合并请求提交您的更改，或寻求其他开发人员的帮助。

在 Git 提交中关闭 Debian 的缺陷

如果您的提交日志条目中包含 Closes: #nnnnnn，那么在您推送您的更改后，缺陷编号 #nnnnnn 将会被自动关闭。精确的格式与 Debian 政策中的介绍相同。

使用 HTTP/HTTPS 链接

许多 Debian 网站都支持 SSL/TLS，因此请尽可能使用 HTTPS 链接。但是，某些 Debian/DebConf/SPI 等网站要么不具有 HTTPS 支持，要么仅使用 SPI 数字证书认证机构（并不是一个被所有浏览器信任的 SSL 证书认证机构）。为了避免给非 Debian 用户带来错误消息的困扰，请不要使用 HTTPS 链接到此类站点。

Git 存储库会拒绝那些包含使用纯 HTTP 链接到支持 HTTPS 的 Debian 网站的内容或包含使用 HTTPS 链接到已知不支持 HTTPS 或仅使用 SPI 签名的证书的 Debian/DebConf/SPI 网站的内容的提交。

开展翻译工作

翻译应始终与相对应的英文文件同步并保持最新。翻译文件中的 translation-check 头用于跟踪当前翻译所基于的英语文件的版本。如果您更改了已翻译的文件，则需要更新 translation-check 头以匹配英语文件中相应更改的 Git 提交哈希值。您可以使用以下命令找到该哈希值：

  git log path/to/english/file

如果您要对一个文件新建翻译，请使用 copypage.pl 脚本，它将为您的语言创建一个模板，该模板包含了正确的翻译头。

使用 smart_change.pl 进行翻译修改

smart_change.pl 是一个脚本，目的是让同时更新原始文件及其翻译更为容易。有两种方法供您使用，选择哪种取决于您进行的更改。

以下步骤说明了如何使用 smart_change.pl，以及当手动修改文件时，如何只更新 translation-check 头：

对原始文件进行更改，然后提交。
更新翻译。
运行 smart_change.pl -c COMMIT_HASH（使用对原始文件的更改产生的提交哈希值）。它会获取该更改，并更新已翻译文件的头。
检查更改（例如，使用 git diff）。
提交翻译更改。

或者，您可以使用正则表达式来一次性对文件进行多个更改：

运行 smart_change.pl -s s/FOO/BAR/ origfile1 origfile2 ...
检查更改（例如，使用 git diff）。
提交原始文件。
运行 smart_change.pl origfile1 origfile2（即，这次不带正则表达式）。它就会只更新已翻译文件的头。
最后，提交翻译更改。

必须承认，这比第一个例子更麻烦一点，因为涉及到两次提交，但是，由于 Git 哈希值的工作方式，这是无法避免的。

打开网页浏览器并访问 https://tracker.debian.org/pkg/www.debian.org。
订阅 www.debian.org 伪软件包（如果您尚未在其它情况下使用过 tracker.debian.org，则可以使用 SSO 通过验证或使用电子邮件和密码进行注册）。
跳转到 https://tracker.debian.org/accounts/subscriptions，然后点击 modify keywords，选中 vcs（如果其未被选中）并保存。
从现在开始，每当有人提交更改到 webwml 存储库时，您将收到电子邮件。

接收合并请求通知

如果您想要在 Salsa 上的 webwml 存储库收到新的合并请求（Merge Request）的时候得到电子邮件提醒，您可以在网页界面上配置您的通知设置。步骤如下：

登陆您的 Salsa 帐号并前往项目页面。
点击项目主页顶部的铃铛图标。
选择您所需的通知级别。