RealPython

Contents

  1. 大蟒本色
    1. 緣起
    2. 写作团队
    3. 时间表（最新进展）
    4. 团队规约
      1. Hg协同
        1. push 得注意什么?
      2. 仓库规范
      3. 如何对已有章节提出修改意见？
    5. 章节任务
      1. 周报
      2. 写作计划

一个计划

大蟒本色

本来来像叫“实战python”的，翻译成英文就叫RealPython了……

感谢zoom.quiet提供vps援助(点2) 每四小时编译

计划

  • 就当 可爱的python 的进阶版吧，介绍介绍大牛们认为比较好的东西;比如各个模块、工作环境，使新手能够获取最爽的体验。大妈觉得比较好用的Leo啥的详细介绍一下吧。要解决一下新手在使用Python时会遇到的实际问题

写作范围

  • 顺手的工作环境的搭建 包括Leo,MoinMoin,Trac,SVN等（我现在还没学会SVN……）

  • 在实例故事中介绍各个模块
  • 真正教会新手如何使用python解决实际问题

緣起

*新手想要的书* ~ 我本身就是一个新手，在使用python的时候有大不爽！

写作团队

同志们先建立自己的维基页面？——QidongSu

目前已有成员
  1. Qidong Su - 神秘失踪
  2. ream D
  3. He Jibo
  4. fxiao~默认退出

  5. 行者们:参与项目的行者列表

时间表（最新进展）

#

时间

干了什么

状态

说明

备注

2011.3.17

~

大蟒本色项目建立

？

？

？

？

2011.4.10

~

完成第一部分

？

？

？

？

2011.5

~

完成主体部分，进入修改，重构阶段

？

？

？

？

2012年4.14

~

联系编辑，发布前冲刺ing...

？

？

？

？

团队规约

结合最近团队状况，增加一些团队规约。 

    - 只要有真实的贡献检入仓库,就算中途 退出,也承认贡献的
    - 如果的确没有任何理由就不参加进展了,算自动退出
    - 想回来,只要说明原因,也就自然回来了
    - 唯贡献和团队协同为先不管面子的

    1.常规状态下，不回复obp列表30次算自愿退出
    2.常规状态下，不执行计划的任务5次算自动退出
    3.常规状态下，拖延承诺的时间10次算自动退出
    4.如有特殊情况需要延期或暂停任务时，要在obp列表中说明
    4.破坏仓库3次，自动退出
    5.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次关闭仓库写权限，自己另开仓库进行hg练习，再向主持人发邮件申请合并。再犯退出。

Hg协同

选择: 基于Sphinx的图书协同

为了方便追踪进展，决定使用BitBucket的仓库进行协同编写，以下是加入步骤，请团队成员注意：

环境搭建

  1. 首先到 http://bitbucket.org 注册帐号，并向列表申请加入obp

  2. 把账号名以邮件方式吼给主持人(dream.python.org AT gmail.com)

  3. 在 http://mercurial.selenic.com/downloads/ 下载Hg，安装

  4. 在http://sphinx.pocoo.org/下载sphinx，安装
日常撰写/推送
  1. 首先，cmd输入以下指令建立本地仓库：

  2. 在各仓库目录中,配置身份: `打开章节仓库中的.hg/hgrc文件，编辑： 

    [ui]
username = You Name <[email protected]>
[paths]

default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1
username = You Name <[email protected]>
[hostfingerprints]
bitbucket.org = 81:2b:08:90:dc:d3:71:ee:e0:7c:b4:75:ce:9b:6c:48:94:56:a1:fe



# 打开实例仓库(已废)中的.hg/hgrc文件，编辑：
#[ui]
username = You Name <[email protected]>
[paths]
default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.myaddr
[hostfingerprints]
bitbucket.org = 81:2b:08:90:dc:d3:71:ee:e0:7c:b4:75:ce:9b:6c:48:94:56:a1:fe
    • 然后，在大蟒本色的obp维基中明确宏观剧情和目录，选定认领章节。
    • 在列表中发帖，申请认领相关章节。 最后，展开撰写

    1.完成撰写后， 推送到团队远程中央仓库:

    $ hg add 自个儿增加的文件或文件夹   # 如在src下增加hello.rst 则为"hg add src\hello.rst"

    • 建议使用hg add 单个文件 不易造成仓库混乱或冲突。

    • 完成实例或章节时，可以推送，参照：推送时应注意什么？

非常简明的教程，大家有不懂可以问我，千万不要在不清楚团队规约的状态下往主仓库推送，否则后果自负。

push 得注意什么?

by zoom.quiet

     每次提交前,先 hg ci 到本地仓库
     hg in 探查是否有主仓库变化
         如果有,就 hg pull -u
         根据提示,进行 hg heads 观察,以及 hg merge 对应最新版本
     然后,修订冲突的,hg ci 到本地
     hg push
   收功!

仓库规范

#章节文件夹对应表：
ch01     第一章
ch02     第二章
ch03     第三章
ch04     第四章
ch05     第五章
ch06     第六章

#截图文件存放：
source\_static\snap\

#文件命名规范：
全小写e文命名.

如何对已有章节提出修改意见？

任何人对任何章节持有意见，应：

  1. 克隆仓库
  2. 查阅有意见的章节，找出并记录其中的错误和不足
  3. 撰写审阅报告：
    • 报告应包含：
      1. 前后故事是否连贯
      2. 是否背离宏观剧情
      3. 有无知识点错误？
      4. 自个儿对本章的建议
    • 报告完成后，发到obp列表中，和大家讨论，斟酌后进行修改。

    • 也可以直接在 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner/issues 创建提案来追踪!

章节任务

认领规则
  • 在相应的章节后写上自个儿姓名，认领节数，具体认领内容，进度，作品的文档 

如：第一章:
 ream d       1.1-1.4    认领本章所有故事情节和实例  10%   attachment:测试
 (认领者姓名)  (认领节数)  (具体认领内容)            (进度)  （作品的文档）

#

认领者

章节范畴

进度

附件

备注

第一章

~

ream D

1.1-1.5

100%

附件?

认领本章所有故事情节和实例

第二章

~

QidongSu

前言,第二章

100%

附件?

认领本章

第三章

~

hejibo1984

通信录gui化

100%

附件?

所有故事和代码实例

第四章

~

QidongSu,ream D,HeJiBo

setup.py,发布途径

100%

附件?

故事与实例

第五章

~

ream D

通信录移植

100%

附件?

~

第六章

~

QidongSu

web bottle部分和apache 第六章全部

100%

附件?

认领本章部分故事情节和实例

第七章

~

??

??

0%

附件?

~

第八章

~

??

??

0%

附件?

~

#

认领者

章节范畴

进度

附件

备注

周报

RealWorldPyLivin 周报

写作计划

ream D
  • 继续往前冲！感觉自个儿发布途径的章节和第五章的内容太少了，这周增补，并完成截图。
  • 进入第六个工作周，大家激情都不错，继续保持啊
  • 团队本星期计划：
    1. 完成主体部分~doing
    2. 完善已经写过的章节~doing
    3. 统一各章节的格式与文件储存方式~doing
QiDongSU
  • 将自己所写的章节每章达到150～ 300linux行，完成截图
fxiao
  • 长期不关注本书进程，默认退出
hejibo1984
  • 我上周完成了qt.rst，基本上完成了gui一章的写作。 我下周四考完继续写py2exe打包

::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z

RealPython (last edited 2012-04-16 10:07:09 by huangxun)