Differences between revisions 65 and 96 (spanning 31 versions)
⇤ ← Revision 65 as of 2011-04-06 08:36:46 →
Size: 6342
Editor: huangxun
Comment:
← Revision 96 as of 2012-04-16 10:07:09 → ⇥
Size: 10498
Editor: huangxun
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
 
Line 11: Line 11:
Line 13: Line 12:

 正式在线图书预览::
  * [[http://readthedocs.org/docs/rwpy4l/en/latest/index.html|正式在线图书预览(readthedocs)]]


 临时在线图书预览::
  * [[http://shellexy.info/books/obp.rwpy4learner/html/|感谢华华提供vps援助(点一)]] ^每四小时编译^

[[http://zoomquiet.org/obp/RWPy4learner/build/html/index.html| 感谢zoom.quiet提供vps援助(点2)]] ^每四小时编译^
Line 22: Line 30:
== 新手想要的书 ==
我本身就是一个新手，在使用python的时候有大不爽！
 == 緣起 ==
*新手想要的书* ~ 我本身就是一个新手，在使用python的时候有大不爽！
Line 37: Line 44:
* ream D
  . 写作主要是要有毅力和凝聚力，大家要坚持下去啊

== 大纲设计 ==
详见:'''[[http://code.google.com/p/openbookproject/wiki/RealWorldPyLivin|RealWorldPyLivin 大蟒本色 - O.B.P ~ Open Book Proj. 4 Chinese Pythonic 中文蟒样开放技术图书计划！ - Google Project Hosting]]'''
== 写作计划 ==
 ream D::
  * 4月5日前完成第二节(通信录变量版)--已完成

  * 4月6日前完成第三节(判断用if)--已完成

  * 4月8日前完成第四节(函式化)

  * 4月10日前完成第五节(中文！中文！)
 QiDongSU::
  
  * 5月前完成第2部分的代码与文章

 fxiao::
（待添加）
 hejibo1984::
 * 最近准备博士资格考试，进展会比较慢。5月10日开始全职投入。6月前完成


== 使用 BitBucket 进行过程协同 ==
 大纲设计::
    ( 详见:'''[[http://code.google.com/p/openbookproject/wiki/RealWorldPyLivin|RealWorldPyLivin 大蟒本色 - O.B.P ~ Open Book Proj. 4 Chinese Pythonic 中文蟒样开放技术图书计划！ - Google Project Hosting]]'''


== 写作团队 ==
同志们先建立自己的维基页面？——QidongSu
 目前已有成员::

    1. Qidong Su - 神秘失踪
    2. ream D
    3. He Jibo
    4. fxiao~默认退出

    * 行者们:[[http://code.google.com/p/openbookproject/wiki/RwPyLpeoples|参与项目的行者列表 ]]

== 时间表（最新进展） ==

||<:rowbgcolor="#effffe"># || 时间 || 干了什么 || 状态 || 说明 || 备注 ||
||<-6:>''' 2011.3.17 '''||
||~ || 大蟒本色项目建立 || ？ || ？ || ？ || ？ ||
||<-6:>''' 2011.4.10 '''||
||~ || 完成第一部分 || ？ || ？ || ？ || ？ ||
||<-6:>''' 2011.5 '''||
||~ || 完成主体部分，进入修改，重构阶段 || ？ || ？ || ？ || ？ ||
||<-6:>''' 2012年4.14 '''||
||~ || 联系编辑，发布前冲刺ing... || ？ || ？ || ？ || ？ ||


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

   * 使用obp工程的默认规约：
{{{
    - 只要有真实的贡献检入仓库,就算中途 退出,也承认贡献的
    - 如果的确没有任何理由就不参加进展了,算自动退出
    - 想回来,只要说明原因,也就自然回来了
    - 唯贡献和团队协同为先不管面子的
}}}
   * 增加一些权益条例：
{{{
    1.常规状态下，不回复obp列表30次算自愿退出
    2.常规状态下，不执行计划的任务5次算自动退出
    3.常规状态下，拖延承诺的时间10次算自动退出
    4.如有特殊情况需要延期或暂停任务时，要在obp列表中说明
    4.破坏仓库3次，自动退出
    5.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次关闭仓库写权限，自己另开仓库进行hg练习，再向主持人发邮件申请合并。再犯退出。

}}}
=== Hg协同 ===
Line 67: Line 99:
  1. 首先到 http://bitbucket.org 注册帐号
  1. 把账号名以邮件方式吼给我(dream.python.org AT gmail.com) 
   * 我将把账号追加到 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner 成为可写成员
  1. 在 http://mercurial.selenic.com/downloads/ 下载Hg，安装
  1. 在http://sphinx.pocoo.org/下载sphinx，安装		   1. 首先到 http://bitbucket.org 注册帐号，并向列表申请加入obp
  2. 把账号名以邮件方式吼给主持人(dream.python.org AT gmail.com)
   * 主持人将把账号追加到 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1 成为可写成员
  3. 在 http://mercurial.selenic.com/downloads/ 下载Hg，安装
  4. 在http://sphinx.pocoo.org/下载sphinx，安装
Line 74: Line 106:
 日常撰写/推送::   日常撰写/推送::
Line 76: Line 108:
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner RWPy4learner`
  1. 在仓库目录中,配置身份: `.hg/hgrc ` {{{		    * 首先克隆章节仓库：
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1 RWPy4learner
   * 再克隆实例仓库：
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.myaddr RWPy4learner.myaddr - 已废,实例融合在章节仓库中
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner RWPy4learner

  1. 在各仓库目录中,配置身份: `打开章节仓库中的.hg/hgrc文件，编辑： {{{
Line 81: Line 118:
default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner
default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1
username = You Name <[email protected]>
Line 84: Line 123:
}}}
  1. 再接着尝试使用 rST 展开自个儿章节撰写
   * (参见: http://wiki.woodpecker.org.cn/moin/DocumentUsageSphinx)
  1. 撰写...
  1. 每天至少检入本地一次修订版本
   * `hg ci -m "修订日志" `
   * 每周必须至少同步一次团队仓库:
    1. 先同步: `hg pull -u `
    1. 撰写后检查没问题，可以编译成html 网站{{{
RWPy4learner> make html
    }}}
    1. 推送到团队远程中央仓库:{{{
hg add 自个儿增加的文件 #如在src下增加hello.py 则为"hg add src\hello.py"
hg ci -m "检入日志"
hg push https://bitbucket.org/ZoomQuiet/obp.rwpy4learner
    }}}

非常简明的教程，大家有不懂可以问我。


# 打开实例仓库(已废)中的.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` 单个文件 不易造成仓库混乱或冲突。
    * 完成实例或章节时，可以推送，参照：推送时应注意什么？

非常简明的教程，大家有不懂可以问我，千万不要在不清楚团队规约的状态下往主仓库推送，否则后果自负。
Line 103: Line 145:
   == 写作团队(3-5人) ==
同志们先建立自己的维基页面？——QidongSu
 目前已有成员::
    1. Qidong Su
    1. ream D
    1. He Jibo
    1. fxiao


=== 章节认领 ===
==== 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. 克隆仓库
 1. 查阅有意见的章节，找出并记录其中的错误和不足
 1. 撰写审阅报告：
  * 报告应包含：
    1. 前后故事是否连贯
    1. 是否背离宏观剧情
    1. 有无知识点错误？
    1. 自个儿对本章的建议
  * 报告完成后，发到obp列表中，和大家讨论，斟酌后进行修改。
  * 也可以直接在 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner/issues 创建提案来追踪!

== 章节任务 ==
Line 118: Line 196:
   * （在attachment中上传文件，再用attachment:“文件名”指定到该文件。作品文档必须是纯文本格式）
Line 127: Line 205:
||~ || ream D || 1.1-1.5 || 50% || 附件? || 认领本章所有故事情节和实例 || ||~ || ream D || 1.1-1.5 || 100% || 附件? || 认领本章所有故事情节和实例 ||
Line 129: Line 207:
||~ || QidongSu || 前言/介绍 || 100% || 附件? || 认领本章 || ||~ || QidongSu || 前言,第二章 || 100% || 附件? || 认领本章 ||
Line 131: Line 209:
||~ || hejibo1984 || 通信录gui化 || 10% || 附件? || 所有故事和代码实例 || ||~ || hejibo1984 || 通信录gui化 || 100% || 附件? || 所有故事和代码实例 ||
Line 133: Line 211:
||~ || fxiao || 4.1-4.5 || 0% || 附件? || 认领本章所有故事情节和实例 || ||~ || QidongSu,ream D,HeJiBo || setup.py,发布途径 || 100% || 附件? || 故事与实例 ||
Line 135: Line 213:
||~ || ?? || ?? || 0% || 附件? || ~ || ||~ || ream D || 通信录移植 || 100% || 附件? || ~ ||
Line 137: Line 215:
||~ || ?? || ?? || 0% || 附件? || ~ || ||~ || QidongSu || web bottle部分和apache 第六章全部 || 100% || 附件? || 认领本章部分故事情节和实例 ||
Line 144: Line 222:
=== 周报 ===
[[http://code.google.com/p/openbookproject/wiki/RwPyLWeeklyreports|RealWorldPyLivin 周报]]

=== 写作计划 ===
 ream D::
  * 继续往前冲！感觉自个儿发布途径的章节和第五章的内容太少了，这周增补，并完成截图。
  * 进入第六个工作周，大家激情都不错，继续保持啊
  * 团队本星期计划：
    1. 完成主体部分~doing
    1. 完善已经写过的章节~doing
    1. 统一各章节的格式与文件储存方式~doing



 QiDongSU::
  * 将自己所写的章节每章达到150～ 300linux行，完成截图

 fxiao::
  * 长期不关注本书进程，默认退出

 hejibo1984::
  * 我上周完成了qt.rst，基本上完成了gui一章的写作。 我下周四考完继续写py2exe打包

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的时候有大不爽！

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

  • ~ ZoomQuiet:

    • 新手的状态很难保持,在 Python 世界,所以,施主的及时记录,非常非常可贵!

    • 只是,实例,最好有一个核心线索作品的演化,可以将所有常用领域的关键知识都串起来,否则,分散成一个个零散的独立功能,无法帮助小白建立大局观的...

  • QidongSu 回应

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

  • QidongSu

    • 可不可以模仿《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...

？

？

？

？

团队规约

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

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

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

    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)