新手上路

Table of Contents 准备工作 工作环境 系统目前的结构 需要的知识

准备工作

对于Linux用户一切都很方便；对于Window用户， Cygwin系统是必须的；对于Mac用户，建议先行安装 Homebrew 。

• http://www.cygwin.com/
• https://github.com/mxcl/homebrew
• http://blog.jjgod.org/2009/12/21/homebrew-package-management/

下面我们需要 Git 和 Node.js 两个工具。

• http://book.git-scm.com/2_installing_git.html
• http://howtonode.org/how-to-install-nodejs

对于Git我们没有版本要求，但 Node.js 至少要 0.4.0 。

工作环境

首先安装 Node.js 的包管理器 npm http://npmjs.org/

下载代码开始尝试调试程序，请参照 https://github.com/mountain/distilled 的 How to start 章节。

系统目前的结构

• 归档脚本： bin/magazine 和 bin/index 是入口
• 在线杂志的后台程序： bin/start 是入口
• 简单的在线编辑器：需要配置好用户，从浏览器访问类似网址 http://localhost:8080/editor/issues/2011/2/15
• 用户管理：见配置文件 config/users.js

另外，陈恺同学对 vendors/minimal 贡献很大，这是我们 Web 编程的核心；而 vendors/distilled 是归档脚本的业务逻辑所在。 整个项目的文件目录结构是仿照 rails 来设置的：

• app/ Web应用的所有页面和控制器在此
• bin/ 可执行文件
• config/ 配置
• lib/ 公用的库
• public/ 可以被浏览器直接访问到的文件夹，client端需要的一切程序和数据在此
• scripts/ 工具脚本
• spec/ 测试程序
• vendors/ 第三方工具

需要的知识

归档部分要了解如下几个知识：

• MediaWiki API ： http://www.mediawiki.org/wiki/API
• jsdom：http://jsdom.org/documentation ，有了DOM，我们就可以在Server上跑jQuery，具体请研究代码

在线杂志部分主要是掌握jQuery和CSS。

• http://docs.jquery.com/Main_Page

CSS对这个项目非常重要，这里有我几年下来积累的css相关的文档和资源： http://www.delicious.com/mountain/css

比如下面几个是很好的参考：

• http://www.designyourway.net/blog/resources/31-css-code-snippets-to-make-you-a-better-coder/
• http://www.stevesouders.com/blog/2009/03/10/performance-impact-of-css-selectors/
• http://www.betaversion.org/~stefano/linotype/news/169/
• http://www.webstyleguide.com/index.html?/
• http://www.smashingmagazine.com/2007/01/19/53-css-techniques-you-couldnt-live-without/
• http://www.typetester.org/
• http://www.thinkingwithtype.com/
• http://css-discuss.incutio.com/wiki/Main_Page

Git是我们工作的基本工具，请参照：

• http://progit.org/book/
• http://help.github.com/
• http://help.github.com/forking
• http://help.github.com/pull-requests

工作流程参考 git-flow 来作的 http://nvie.com/posts/a-successful-git-branching-model/