【编程随想】整理的《太子党关系网络》,专门揭露赵国的权贵
Go to file
Debian Live user b308b6d7e1 添加肖建华和向前的信息 2017-04-23 13:45:15 +00:00
bin add new files and modified some old files. 2016-03-22 02:06:31 +08:00
data 添加肖建华和向前的信息 2017-04-23 13:45:15 +00:00
download 更新下载pdf 2016-03-01 11:27:07 +08:00
LICENSE Initial commit 2016-02-28 23:38:57 +08:00
README.wiki 补充下载说明 2016-03-03 17:28:08 +08:00

README.wiki

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

= 俺整理的《太子党关系网络》 =

== 简介 ==

此项目专门用来揭露天朝的权贵(也就是传说中的“赵家人”)。

2月29日俺把这几年收集整理的数据开源到 GitHub便于多人协作——大伙儿群策群力一起来曝光权贵家族。

目前收集的资料——包括700多个数据文件 '''对应700多人130多个家族''' 另有200多张图片人物头像。

为了确保数据的可信度,俺主要参考“维基百科”以及一些国际权威媒体的报道(比如《纽约时报》、《华尔街日版》、《金融时报》等等)。

另外,对于某些客观事实(比如:生卒年月、简历、亲戚关系),俺也参考了天朝政府的官方网站,以及墙内的“百度百科”。


== 下载说明 ==

GitHub 提供了“下载整个项目”的功能,但是会比较大。

如果你仅仅想看《太子党关系网络》这份文档,只需在首页上方点击进入 '''download''' 这个目录。

该目录下有 '''pdf''' 和 '''jpg''' 两个子目录,分别存放对应的 '''【文件类型】''' 。你想要看哪一种文件格式,就进入哪个子目录里面。

进入【文件类型】的子目录之后会看到一个文件列表目前有13个文件。先点击你想要的某个文件会进入该文件的页面。

然后在【右上方】你会看到一个 '''Raw 按钮''' ,在这个按钮上点【右键】,在【右键菜单】里面选“保存”或“另存为”,就可以把这个文件下载到你本机。


== 多人协作说明 ==

俺非常希望有更多的网友参与该项目,大伙儿一起来完善天朝权贵家族的资料。

想要参与的同学,可以通过如下方式:

* 到[https://program-think.blogspot.com/ 俺博客]留言进行反馈,补充信息或反馈错误。

* 在[https://github.com/programthink/zhao/issues 本项目发一个 issue],补充信息或反馈错误。

* Fork 该项目,进行修改,然后向俺发一个 Pull Request

(后面两种方式,你需要有 GitHub 的帐号)


== 数据格式说明 ==

本项目的数据文件,全部采用[https://zh.wikipedia.org/wiki/YAML YAML 格式]。这种格式非常简洁明了,有利于完全不懂技术的网友参与编辑。

而且俺在每一个 YAML 格式的文件中都写了详细的注释,便于其他网友修改。


== 目录说明 ==

=== data 目录 ===

data 目录用来保存数据文件,该目录下另有如下三个子目录:

* person

这个目录存放个人的资料,每个人一个目录,目录名就是人名。对于偶尔有同名的情况,在目录名末尾追加数字序号来区分。

每个目录下都有一个 brief.yaml 文件,包含此人的简介。

有些目录下还有一个 portrait.png 文件,对应此人的头像。

* company

这个目录存放与太子党有关的公司或组织机构。目录结构与 person 类似。

* family

这个目录存放家族关系的信息。每个家族是一个 yaml 格式的文件。

=== bin 目录 ===

该目录存放编译脚本。该脚本的使用参见下面的章节。

=== download 目录 ===

该目录存放制作好的文件,目前先提供 jpg 和 pdf 两种格式。

如果你需要其它格式,可以用 bin 目录下的编译脚本自行搞定(编译脚本的使用,参见下面的章节)。


== 编译脚本使用说明 ==

(俺是在 Linux 上编写该脚本,尚未在 Windows 上进行测试)

如果你在 Windows 上使用碰到问题,可以到[https://program-think.blogspot.com/ 俺博客]留言进行反馈。也可以在[https://github.com/programthink/zhao/issues 本项目发一个 issue]。

=== 脚本的命令行参数 ===

俺使用 python 作为编译脚本,该脚本位于 bin 目录下。

通过该脚本可以把原始数据生成为 dot 语言的脚本。然后再调用 Graphviz 把 dot 脚本生成各种格式比如pdf、jpeg。

要使用该脚本,先在命令行模式下进入 bin 目录,然后运行如下命令:

(生成 pdf 格式的示例)

'''python make.py pdf'''

(生成 jpg 格式的示例)

'''python make.py jpg'''

=== 依赖的软件 ===

要使用上述脚本,你需要事先安装相关的软件(如下)

* Python2 或 3

因为俺用的是 Python 脚本,所以你需要先安装 python 软件。

目前 Python 有两种大版本——python2 和 python3——俺的编译脚本 '''【同时兼容】''' 这两种 Python 的大版本。

对于 Python 的小版本,俺本人在 '''2.7''' 和 '''3.5''' 上测试通过。2.6 和 3.4 估计也可以。

* PyYAML

这是一个基于 python 开发的软件包,专门用来处理 YAML 格式的文件。

你需要在你的 python 环境中安装该软件包。其官方链接如下:

[http://pyyaml.org/wiki/PyYAML PyYAML 的官网的 wiki]

[https://pypi.python.org/pypi/PyYAML Python 官网的 PYPI]

* Graphviz

这个软件是用来生成【关系图】的。关于该这个软件,俺已经写了一篇扫盲教程:

《[https://program-think.blogspot.com/2016/02/opensource-review-graphviz.html 开源项目【自动】绘图工具Graphviz——《太子党关系网络》就是用它制作]》


== 致“反对此项目的墙内程序员” ==

本项目上线第二天,就收获 363 个 star 兼 88 个 fork甚至还挤进 GitHub 的“当日 Trending”——俺很荣幸也很高兴有这么多人给俺捧场。

但是在[https://github.com/programthink/zhao/issues 本项目的 issue 列表]中也看到好几个反对此项目的程序员(应该都来自墙内),他们担心这个项目导致 GitHub 被 GFW 封杀。

这几年来,类似的言论俺已经看了不少。就好比强盗拿刀杀人,围观者不但没有谴责强盗,反而去谴责卖刀的店家——这就是传说中的“斯德哥尔摩综合症”。

有兴趣的同学,可以看俺之前的博文——《[https://program-think.blogspot.com/2012/06/stockholm-syndrome.html 天朝民众的心理分析:斯德哥尔摩综合症]》