/relationship

Chinese kinship system.**亲戚关系计算器 - 家庭称谓/称呼计算/亲戚关系算法/親戚稱呼計算機

Primary LanguageJavaScriptMIT LicenseMIT

Build Status

由于工作生活节奏不同,如今很多关系稍疏远的亲戚之间来往并不多。因此放假回家过年时,往往会搞不清楚哪位亲戚应该喊什么称呼,很是尴尬。然而搞不清亲戚关系和亲戚称谓的不仅是小孩,就连年轻一代的大人也都常常模糊混乱。

“**家庭称谓计算器”为你避免了这种尴尬,只需简单的输入即可算出称谓。输入框兼容了不同的叫法,你可以称呼父亲为:“老爸”、“爹地”、“老爷子”等等,方面不同地域的习惯叫法。快捷输入按键,只需简单的点击即可完成关系输入,算法还支持逆向查找称呼哦~!

演示地址:https://passer-by.com/relationship/

借助这套算法结合vue开发的APP: https://passer-by.com/relationship/vue/

在微信中搜索“亲戚关系”,还可以体验小程序版本

亲戚关系计算器

一、下载 & 安装

该 Javascript 库 / 模块可以用于前端也可以用于后端 Nodejs 中。

  1. 直接下载dist/relationship.min.js,然后使用 <script>标签引入,可以得到全局的方法 relationship.

  2. 使用 npm 进行包管理,具体为:

    npm install relationship.js

然后使用 require 引入模块

var relationship = require("relationship.js");

二、使用

  1. 内部属性:获取当前数据量 relationship.dataCount.

  2. 内部方法:用户自定义模式 relationship.setMode(mode_name,mode_data).

代码示例:

// 关系解析语法
// 【关系链】f:父,m:母,h:夫,w:妻,s:子,d:女,xb:兄弟,ob:兄,lb:弟,xs:姐妹,os:姐,ls:妹
// 【修饰符】 1:男性,0:女性,&o:年长,&l:年幼,#:隔断,[a|b]:并列
relationship.setMode('northern',{
	'm,f':['姥爷'],
	'm,m':['姥姥'],
	'm,xb,s&o':['表哥'],
	'm,xb,s&l':['表弟'],
});
  1. 通用方法: 唯一的计算方法 relationship(options).

参数options结构为:

var options = {
	text:'',		    //输入文本(称谓的汉字表达,称谓间用‘的’字分隔)
	target:'',	    	//针对对象:空表示自己
	sex:-1,			    //自己的性别:0女性,1男性
	type:'default',		//转换类型:'default'算称谓,'chain'算关系
	reverse:false,		//称呼方式:true对方称呼我,false我称呼对方
	mode:'default'		//模式选择,可由用户自定义
};

代码示例:

// 如:我应该叫外婆的哥哥什么?
relationship({text:'妈妈的妈妈的哥哥'});

// 如:七舅姥爷应该叫我什么?
relationship({text:'七舅姥爷','reverse':true,'sex':1});

// 如:舅公和我是什么关系?
relationship({text:'舅公',sex:0,type:'chain'});

// 如:舅妈如何称呼外婆?
relationship({text:'外婆',target:'舅妈',sex:1});

三、开发 & 贡献

# 安装开发依赖
npm install 

# build 模块: 将 relationship 打包压缩
npm run build

# 执行测试用例(可以在tests/test.js中完善测试用例)
npm test

当然也可以直接浏览器打开 index.html 来在查看网页demo。

四、关于分歧

一些称呼存在南北方或地区差异,容易引起歧义,并不保证和你所处地区的称谓习惯一致。本程序默认以现代生活常见的理解为主。例如:

  • 媳妇:在古代或者当今北方地区指儿子的妻子,这里指自己的妻子。
  • 大爷:北方指父亲的哥哥,这里指爷爷的哥哥
  • 太太:一些地方指年长的妇人,这里指自己的妻子

针对不同地区的使用,你可以通过上述所说的自定义模式实现。

五、其他

他们都在用:

查询网 http://www.ip138.com/chengwei/

在线查询网 http://qinshu.supfree.net/

在线工具 http://www.atool.org/relateship.php

有道语文达人 http://dict.youdao.com/k12yuwen/html/relation.html

小米MIUI系统计算器 http://www.miui.com/

小米MIUI网页版本 http://www.miui.com/zt/calculator2016/dist.php

符号库 http://www.fuhaoku.com/tool/qinqiguanxi.html