本文转载自: http://article.yeeyan.org/view/35282/120742
Bottle 是一个快速、简单和轻量的 Python WSGI 微框架。它以一个单一的文件模块进行发行，并且不依赖其它 Python 标准库。
1. Bottle：Python Web 框架
1.1. 核心特征
1.2. 示例：Bottle 里的“你好世界”
1.3. 下载和安装
2. 用户指南
3. API 文档
4. 教程和资源
5. 开发和贡献
6. 许可证
a. 脚注
1. Bottle：Python Web 框架
Bottle 是一个快速、简单和轻量的 Python WSGI 微框架。它以一个单一的文件模块进行发行，并且不依赖其它 Python 标准库。
1.1. 核心特征
路由：支持请求干净和动态的 URLs 的调用式函数映射。
模板：快速和 pythonic 的内建模板引擎，并支持 mako、jinja2 和 cheetah 模板。
效用：方便地访问表单数据、文件上传、cookies、头信息和其它与 HTTP 有关联的元数据。
服务器：内建的 HTTP 开发版服务器，并支持 paste、fapws3、Google 应用程序引擎、cherrypy 或任何其它具有 WSGI 功能的 HTTP 服务器。
1.2. 示例：Bottle 里的“你好世界”
from bottle import route, run
@route(‘/:name‘)
def index(name = ‘世界‘):
return ‘你好%s‘ % name
run(host = ‘localhost‘, port = 8080)
1.3. 下载和安装
通过 PyPi（easy_install -U bottle）或下载 bottle.py 到你的项目目录中来安装最后的稳定发行版。它没有强制 [1] 依赖于其它的 Python 标准库。Bottle 运行在 Python 2.5+ 和 3.x（使用 2to3）上。
2. 用户指南
如果你想学习如何在 Web 开发中使用 Bottle 框架，请从这里开始。如果你有再次没有回答的任何问题，随时询问邮件列表。
教程
1. 开始
2. 路由
3. 生成内容
4. 访问请求数据
5. 模板
6. 开发
7. 部署
8. 词汇表
SimpleTemplate 引擎
1. SimpleTemplate 语法
2. SimpleTemplate API
3. 已知的 bugs
常见问题解答
1. 关于 Bottle
2. 常见问题和缺陷
3. API 文档
要寻找一个指定函数、类或方法？这些章节涵盖了由框架提供的所有接口，并解释了如何去使用它们。
API 参考
1. 模块内容
2. Bottle 类
3. HTTP Request 和 Response 对象
4. 模板
4. 教程和资源
教程：“待办事宜”应用程序
1. 目的
2. 在我们开始之前...
3. 为一个基于 Web 的“待办事项”使用 Bottle
4. 服务器设置
5. 最后的话
6. 完整的示例列表
资源
1. 保存会话跟踪
2. 调试风格：调试中间件
3. 嵌入到其它 WSGI 应用程序中
4. 忽略尾随的斜线
5. 开发和贡献
这些章节旨在对 Bottle 开发和发行工作流程感兴趣的那些开发者。
发行说明和更新日志
1. 修正发行版 0.8.3
2. 修正发行版 0.8.2
3. 发行版 0.8
开发人员说明
1. 介入
2. 获取源码
3. 分支和它们的目的
4. 发行和更新
5. GIT 工作流程示例
6. 许可证
代码和文档是在 MIT 许可证下可用的：
Copyright (c) 2010, Marcel Hellkamp.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
然而，Bottle 标志不在该许可证下。标志是被允许使用的，作为一个连接到 Bottle 主页的链接，或直接在未修改的库中。在所有其它情况下请首先问询一下。
a. 脚注
[1] 模板的用法或服务器适配器类的课程需要相应的模板或服务器模块。