[豆瓣酱]
This repo has been deprecated. 由于豆瓣关闭了 API 通道,本网站已下线。
豆瓣 私人收藏数据可视化。
依赖
数据库服务器
同时依赖 mongodb 和 redis ,配置参数参见 conf/default.conf.js
。
工具包
npm install forever -g
npm install component -g
npm install grunt-cli -g
npm install
开始开发
make init
make grunt
make
make 的默认命令是使用 forever
执行 app.js
。
如果需要修改静态文件,请执行 make watch
,利用 grunt
监视静态文件改动。
一点说明
MongoDB 的用处
- 存储用户账户信息、收藏信息、条目信息
- 利用 aggregation 生成统计结果
redis 的用处
- 替代 memcached 的缓存服务
- 存储统计结果(计划中)
队列管理
使用 node-pool,数据库请求、API请求、统计请求,都有分别的队列。
静态文件
- 依赖的开源库都用 component 来管理。
- 使用 grunt 来打包。具体配置参见
Gruntfile.js
。 - 服务器递送的总是
/static/dist
目录下的文件,调试时也要保证 dist 目录下有所有需要的文件。没有 fallback 。因此请保证修改静态文件时,watch 有运行。
客户端JS的模块化
- static/js/do.core.js 是由豆瓣的 do.js 修改而来的文件加载器
- 用了 component-build 的一套东西,参看 static/js/do.cmd.js
- Gruntfile.js 里定义了对 js 文件包裹 CommonJS
require
定义的命令 - 使用模版配套的
#{urlmap()}
方法为 Do 生成所需文件的真实地址 - 使用
Do('module1', 'module2', ...
显式延时加载你需要的模块,模块名即文件名,在 Do 内部安全地使用require('xxx')
具体使用实例参见 static/js/people/booter.js
版本管理
发布上线前执行 grunt build
,将为压缩后的文件生成一个 hashmap (即 static/hash.json ),并重命名文件为 static/dist/js/xx_HASH.js 格式。
为了保证这套机制的顺利运行,请保证新加的静态文件名中不包括下划线(_)。
提供 API Key
采集豆瓣数据需要使用豆瓣 API。请配置一下环境变量来制定豆瓣 API KEY:
- DOUBAN_APP_KEY
- DOUBAN_APP_SECRET
- DOUBAN_APP_MORE - 格式:key1:secret1, key2:secret2