一个计划

大蟒本色

本来来像叫“实战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 <you.mailbox@gmail.com>
    [paths]
    
    default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1
    username = You Name <you.mailbox@gmail.com>
    [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 <you.mailbox@gmail.com>
    [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)