Differences between revisions 89 and 90
Revision 89 as of 2011-05-21 02:25:30
Size: 9677
Editor: ZoomQuiet
Comment:
Revision 90 as of 2011-05-21 03:11:08
Size: 9785
Editor: huangxun
Comment:
Deletions are marked like this. Additions are marked like this.
Line 78: Line 78:
    5.未经主持人或章节撰写者同意,随意修改该章的,一次警告,二次退出。     5.未经主持人或章节撰写者同意,随意修改该章的,一次警告,二次关闭仓库写权限,自己另开仓库进行推送练习,再向主持人发邮件申请合并。再犯退出。

一个计划

大蟒本色

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

  • ~ ZoomQuiet ,肯定需要! 只是E文应该吼 Real World Python for freshener

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

    写作范围
    • 顺手的工作环境的搭建 包括Leo,MoinMoin,Trac,SVN等(我现在还没学会SVN……)

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

緣起

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

  • 新手就是刚进门的小学生,大牛的任务就是手把手教会他写字,不光如此,还要教会他如何使用这些文字
  • 新手需要的就是实例!
  • ~ ZoomQuiet:

    • 新手的状态很难保持,在 Python 世界,所以,施主的及时记录,非常非常可贵!
    • 只是,实例,最好有一个核心线索作品的演化,可以将所有常用领域的关键知识都串起来,否则,分散成一个个零散的独立功能,无法帮助小白建立大局观的...

  • QidongSu 回应

    • 本身做这么大一个实例已经很牛x了……
  • jeffjie说
    • 这让我想起当时构思现场讲Scala的事,故事的确是最容易引人入胜的,但讲一个好的故事需要花点心思去构想啊。
  • QidongSu

    • 可不可以模仿《python编程》写一个通讯录,然后一直扩展,变成一个数据库
  • 大纲设计

写作团队

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

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

时间表(最新进展)

#

时间

干了什么

状态

说明

备注

2011.3.17

~

大蟒本色项目建立

2011.4.10

~

完成第一部分

2011.5

~

完成主体部分,进入修改

团队规约

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

  • 使用obp工程的默认规约:

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

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

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
    [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)