diff --git a/README.md b/README.md index 4f7ae8b..0bf9f98 100644 --- a/README.md +++ b/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章示例程序,一个个人博客。 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..e3bcf3a --- /dev/null +++ b/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