项目作者: fmalee

项目描述 :
Guzzle中文文档,不定期同步
高级语言:
项目地址: git://github.com/fmalee/guzzle-docs-cn.git
创建时间: 2018-12-31T12:01:43Z
项目社区:https://github.com/fmalee/guzzle-docs-cn

开源协议:

下载


Guzzle中文文档

nullest/guzzle的翻译基础上增加了翻译文档。

那为什么还在造轮子:

  • 该项目在GitHub上已经不存在。
  • 再次建立一个翻译项目也是为了防止该中文文档的托管也消失。
  • 大多数都没有翻译,所以如果有条件会进行翻译。

限于有限的水平:

  • 英语一般,仅能尽可能将原语句翻译明确,但中文下的语句可能不够通顺。
  • 非程序猿、设计狮,翻译的术语可能有些变味,已经尽量避免,并整理出术语对译。
  • Guzzle水平有限,有些不确定的句子没有翻译。
  • 时间有限,仅翻译当下本人会用上的章节,其余回头再译(一般情况下是回不了头的)。
  • 每次修改、调整本文档时,都会顺手同步官方的文档。

同步记录

  • master
    • c5da4c3128db9f892f0911043cfffb6c559bd6da(2018-12-30)

未译章节

  • testing.rst

术语约定

  • Application:应用
  • Header:标头
  • Body:正文、主体
  • Handler:处理器
  • Middleware:中间件
  • Transfer:传输
  • Stream:流
  • Metadata:元数据
  • Callable:回调
  • Decorator:装饰器

构建文档

Docker

  1. # 进入文档目录
  2. $ cd guzzle-docs-cn
  3. # 构建Docker镜像
  4. # 因为有不少依赖,所以不能使用Sphinx官方的镜像
  5. $ docker build -t guzzle:sphinx .
  6. # 运行新生成的Docker镜像,并生成HTML文档
  7. $ docker run --rm -v $(pwd):/docs guzzle:sphinx make html

本机环境

  1. # 进入文档目录
  2. $ cd guzzle-docs-cn
  3. # 安装相关依赖
  4. $ python3 -m pip install --no-cache-dir -r requirements.txt
  5. # 生成HTML文档
  6. $ make html

生成的文档在 guzzle-docs-cn/__build/html 目录

资源