README

• 子孙图谱
  • 安装
    • 手动安装
      • 配置
      • 使用方法
    • 使用Composer
    • 使用Git
  • 开发
    • 运行测试

子孙图谱

此模块为 webtrees 家谱应用提供 SVG 子孙图谱。它能够显示一个人的最多25代子孙。

但请注意，如果您选择太多代，这可能需要一段时间，甚至可能显著减慢您的系统。

除了子孙，还显示了每个人的配偶。可以通过配置表禁用显示，以便只显示直接子孙。

图1：带有配偶的四代子孙图谱（从上到下绘制）

安装

需要webtrees 2.2。

有几种安装模块的方法。使用 composer 的方法适合经验丰富的用户，作为开发者，您还可以使用 git 获取存储库的副本。但是，对于所有其他用户，手动安装是推荐的。

手动安装

要手动安装模块，请执行以下步骤

1. 下载模块的最新 发布版。
2. 将下载的文件上传到您的Web服务器。
3. 将包解压到您的 modules_v4 目录。
4. 将文件夹重命名为 webtrees-descendants-chart

如果一切顺利，您应该在 modules_v4 目录中看到一个名为 webtrees-descendants-chart 的子目录，其中包含解压的内容。

现在需要在Webtrees中激活该模块。

配置

转到您的安装的控制面板（管理员部分），滚动到 模块 部分。点击 图谱（在 家谱 子部分中）。启用 子孙图谱 自定义模块（可选：禁用原始安装的子孙图谱模块）并保存您的设置。

图2：控制面板 - 模块管理

使用方法

在图谱菜单中，您将找到一个名为 子孙图谱 的新链接。使用提供的配置选项调整图谱布局以符合您的需求。

此外，还可以将生成的树状图导出为SVG或PNG图像，以便在其他地方使用。

使用Composer

通常，要使用 composer 安装，只需在命令行中从您的Webtrees安装的根目录运行以下命令。

composer require magicsunday/webtrees-descendants-chart --update-no-dev

模块将自动安装到您的Webtrees安装的 modules_v4 目录。为此，使用了 "magicsunday/webtrees-module-base" 包。在此可能需要Composer内的批准以授权执行该包。

要删除模块，请运行

composer remove magicsunday/webtrees-descendants-chart --update-no-dev

然后按照 配置 和 使用 中描述的步骤进行。

最新版本

如果您正在使用Webtrees的开发版本（主分支），您可能还需要安装该模块的开发版本。为此，请使用以下命令

composer require magicsunday/webtrees-descendants-chart:dev-main --update-no-dev

使用Git

如果您使用的是git，您也可以通过调用以下命令将当前主分支直接克隆到您的modules_v4目录中

git clone https://github.com/magicsunday/webtrees-descendants-chart.git modules_v4/webtrees-descendants-chart

然后按照 配置 和 使用 中描述的步骤进行。

开发

要构建/更新JavaScript，请运行以下命令

nvm install node
npm install
npm run prepare

运行测试

composer update

composer ci:test
composer ci:test:php:phpstan
composer ci:test:php:lint
composer ci:test:php:rector