Add plan B for dependency management

README.md

@@ -2,34 +2,47 @@
 
 这里是《Flask Web开发实战》（Python Web Development with Flask）的Meta仓库，包含第1-6章、13章的示例程序源码和勘误等信息。访问[本书主页](http://helloflask.com/book)查看本书的资源索引、目录、购买链接等详细信息。
 
-## 勘误 & FAQ & 可改进实现 & 版本更新记录
+## Resources
 
 * [阅读勘误表](http://helloflask.com/book/errata)（优化格式后便于阅读的勘误表）
 * [FAQ](https://github.com/greyli/helloflask/blob/master/faq/faq.md)（常见问题）
 * [可改进实现](https://github.com/greyli/helloflask/blob/master/improvement/improvement.md)（可改进的内容描述或代码实现）
 * [版本更新记录](https://github.com/greyli/helloflask/blob/master/CHANGES.md)（电子书与实体书版本更新与改进记录）
 
-## 反馈 & 讨论 & 评价
+## Feedback
+
+欢迎在本书的[豆瓣图书页面](https://book.douban.com/subject/30310340/)、对应的[知乎问题](https://www.zhihu.com/question/296048455)或是电商网站撰写评价。
 
 如果你发现了书中的错误、运行实例程序出错或是有其他的问题，可以[创建Issue](https://github.com/greyli/helloflask/issues/new/)或是在 [HelloFlask 论坛](https://discuss.helloflask.com)发帖进行反馈。
 
-欢迎在本书的[豆瓣图书页面](https://book.douban.com/subject/30310340/)、对应的[知乎问题](https://www.zhihu.com/question/296048455)或是电商网站撰写评价。
+## Demos
 
-## 运行示例程序
+这个仓库的 demos 文件夹包含本书第一部分的示例程序，每一章对应一个文件夹。使用下面的步骤运行示例程序。
 
 克隆仓库：
 ```
 $ git clone https://github.com/greyli/helloflask.git
 $ cd helloflask
 ```
-安装依赖包：
+创建&激活虚拟环境并安装依赖包（下面两种方式二选一）：
+
+Option 1 使用 venv/virtualenv + pip：
+```
+$ python -m venv env  # Python 2 使用 virtualenv env 命令
+$ source env/bin/activate  # Windows 使用 env\Scripts\activate 命令
+$ pip install -r requirements.txt
+```
+
+对于上面的命令，根据你安装的 Python 版本和所在操作系统选用 `python` 或 `python3`，`pip` 或 `pip3`。
+
+Option 2 使用 Pipenv：
 ```
-$ pipenv install --dev --pypi-mirror https://mirrors.aliyun.com/pypi/simple
+$ pipenv install --dev
 $ pipenv shell
 ```
-*如果你还没有安装Pipenv，那么可以在运行`pipenv`命令前通过pip安装（`pip install pipenv`）。*
+如果你还没有安装Pipenv，那么可以在运行`pipenv`命令前通过pip安装（`pip install pipenv`）。
 
-运行实例程序：
+运行示例程序（以第一章示例程序为例）：
 ```
 $ cd demos/hello
 $ flask run
@@ -44,7 +57,7 @@ $ flask run
 
 *在书中，每一章的开头都会包含运行实例程序的提示。*
 
-## 相关项目
+## HelloFlask Projects
 
 * [SayHello](https://github.com/greyli/sayhello)： 本书第7章示例程序，一个简单的留言板程序。
 * [Bluelog](https://github.com/greyli/bluelog)：本书第8章示例程序，一个个人博客。

requirements.txt

@@ -0,0 +1,35 @@
+alembic==1.0.0
+blinker==1.4
+click==6.7
+cssmin==0.2.0
+flask-assets==0.12
+flask-caching==1.4.0
+flask-ckeditor==0.4.3
+flask-debugtoolbar==0.10.1
+flask-dropzone==1.4.6
+flask-mail==0.9.1
+flask-migrate==2.2.1
+flask-sqlalchemy==2.3.2
+flask-wtf==0.14.2
+flask==1.0.2
+itsdangerous==0.24
+jinja2==2.10
+jsmin==2.2.2
+mako==1.0.7
+markupsafe==1.0
+python-dateutil==2.7.3
+python-dotenv==0.10.0
+python-editor==1.0.3
+python-http-client==3.1.0
+redis==2.10.6
+sendgrid==5.3.0
+six==1.11.0
+sqlalchemy==1.2.10
+webassets==0.12.1
+werkzeug==0.14.1
+wtforms==2.2.1
+# dev
+argh==0.26.2
+pathtools==0.1.2
+pyyaml==3.13
+watchdog==0.8.3