Kart：面向数据集的分布式版本控制

安装

升级到 v0.17.1

请参阅 v0.17.1 发布说明 了解变更、升级及兼容性说明。

Windows

从 发布页面 下载 .msi 安装程序。

💡 如果下载后 Windows Defender SmartScreen 提示“已阻止未识别的应用启动”，您需要点击“仍要运行”。

macOS

从 发布页面 下载 .pkg 安装程序；

或者使用 Homebrew 进行安装： brew install koordinates/kart/kart

Linux

对于基于 Debian/Ubuntu 的发行版，从 发布页面 下载 .deb 软件包并通过 dpkg -i kart_*.deb 安装。

对于基于 RPM 的发行版，从 发布页面 下载 .rpm 软件包并通过 rpm -i kart-*.rpm 安装。

源码

有关 Kart 开发，请参阅 贡献指南。

使用

请参阅 文档 获取教程和参考。

💡 如果您是 git 新手

使用以下命令配置您将在 Kart 提交中使用的身份：

$ kart config --global user.email "you@example.com"
$ kart config --global user.name "Your Name"

快速入门

1. 从 Koordinates 导出一个 GeoPackage，包含任意组合的矢量图层和表。
2. 创建一个新的 Kart 仓库并导入该 GeoPackage（例如 kx-foo-layer.gpkg）。

   $ kart init myproject --import GPKG:kx-foo-layer.gpkg
   $ cd myproject

   将此仓库作为目录，在其中运行所有其他命令。 这还会创建一个工作副本 myproject/myproject.gpkg 供编辑。
3. 在 QGIS 等软件中编辑工作副本：
   • 将跟踪内部 kart 表中的更改
   • 支持要素的添加/编辑/删除
   • 支持更改要素主键
   • 应能检测到模式更改，但尚不支持（会报错）。
   • 使用 kart 更改底层工作副本数据后，按 F5 刷新 QGIS 地图。
4. 对于工作副本，如果从 myproject/ 文件夹运行，kart 命令应能正常工作。查看 --help 了解选项，最重要的选项均受支持。在某些情况下，选项会直接传递给底层的 git 命令：
   • kart diff 将工作副本与仓库进行差异比较（无索引！）
   • kart commit -m {message} 提交工作副本中未提交的更改
   • kart log 查看提交历史
   • kart branch 和 kart checkout -b 分支管理
   • kart fetch 获取上游更改。
   • kart status 显示工作副本状态。
   • kart merge 合并。支持来自一个合并源的 --ff/--no-ff/--ff-only。
   • kart switch 切换到现有或新分支。
   • kart reset 和 kart restore 丢弃工作副本中的更改。
   • kart tag ...
   • kart remote ...。请记住，简单的远程仓库可以只是另一个本地目录。
   • kart push / kart pull
   • kart clone 从远程 URL 初始化一个新仓库，

许可证

GPLv2 及链接例外

本程序是自由软件；您可以按照自由软件基金会 发布的 GNU 通用公共许可证第 2 版的条款重新分发 和/或修改它。

除了 GNU 通用公共许可证中的权限外， 作者授予您无限制的权限，将本文件的编译版本 与其他程序组合链接，并分发这些组合， 且不受使用本文件带来的任何限制。 （通用公共许可证的限制在其他方面仍然适用； 例如，它们涵盖对本文件的修改， 以及未链接到组合可执行文件时的分发。）

本程序分发的希望是它会有用， 但没有任何保证；甚至没有对 适销性或特定用途适用性的隐含保证。 请参阅 GNU 通用公共许可证以获取更多详情。

您应该已经随本程序收到了一份 GNU 通用公共许可证的副本； 参见文件 COPYING。如果没有，请写信给 自由软件基金会，51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA。