Nissaga，家谱树生成器

关于

Nissaga可以从YAML格式的简单数据描述生成家谱树。

Nissaga是加泰罗尼亚语中表示“血统”的词汇。

安装

pip install nissaga

您需要安装graphviz。不是python包装库，而是程序本身。

使用方法

命令行界面仍然相当简单，未来的版本将使其更强大。目前它的工作方式如下

nissaga myfamily.yaml

这将生成一个名为myfamily.pdf的文件

您可以指定第二个参数来选择输出格式：png、svg或graphviz支持的任何格式。

nissaga myfamily.yaml svg

输入文件

输入文件遵循此模式，详情请参见此处

一个简单的示例

people:
  me:
    fullname: Alférez Boye, Carmen
    born: 1988-06-12
  sis:
    fullname: Alférez Boye, Diana
    born: 1985-07-04
  dad:
    fullname: Alférez Esquerra, Fran
    born: 1957-03-23
  mom:
    fullname: Boye Gener, Hipatia
    born: 1951-10-28
  dadgranpa:
    fullname: Boye Isidro, Javier
    born: 1932-07-22
    died: 2013-03-19
  dadgranma:
    fullname: Gener Krahe, Laura
    born: 1933-02-12
    died: 2017-09-19
  momgranpa:
    fullname: Alférez Miró, Natanael
    born: 1944-04-15
  momgranma:
    fullname: Esquerra Olivera, Pandora
    born: 1931-01-13
    died: 2007-05-19

families:
  - parents: [mom, dad]
    children: [sis, me] 
  - parents: [dadgranma, dadgranpa]
    children: [dad]
  - parents: [momgranma, momgranpa]
    children: [mom]

与kingraph的不同之处

此应用程序最初是kingraph功能的克隆，旨在克服大型树结构性能和可扩展性问题，并扩展其功能。

因此，它与kingraph格式基本兼容。

以下kingraph功能目前不支持

• family.children2和family.parents2关系尚未支持

以下功能由nissaga引入，在kingraph中不可用（但YAML仍然兼容）。

• 带有日期、照片以及分开的姓氏和名字的丰富人物框。
  • person.born 可以设置为日期，并在人物名称下方显示为 *YYYY-MM-DD。
  • person.died 可以设置为日期或 true，并在人物名称下方显示为 +YYYY-MM-DD。
  • person.age 死亡者的年龄，未使用，仅用于记录当只有此数据时。
  • person.pics 是一个包含图片文件列表，相对于 yaml 文件。第一个文件将被添加为人物的肖像。其他图片尚未使用。
• 包含婚姻和离婚注解的丰富 联合。
  • family.married：默认为 true。将其设置为 false 表示未婚伴侣关系（⚯）。将其设置为日期，可以在联合节点中看到 ⚭YYYY-MM-DD。
  • family.divorced：默认为 false。将其设置为 true 表示离婚（⚮）。将其设置为日期，可以在联合节点中看到 ⚮YYYY-MM-DD。
• 内部文档 的属性
  • person.todo 人员的待办事项字符串或字符串列表
  • person.from 人员的起源（国家、城市等）
  • person.comments 评论字符串或字符串列表
  • family.notes 注记字符串或字符串列表
  • family.docs 关于家庭的文档。相对于 yaml 文件的文档路径列表。尚未使用，但预计将提供研究来源的链接。