Differences between revisions 88 and 90 (spanning 2 versions)

Contents

大蟒本色

一个计划

一个转机:清华大学出版社Python征稿

大蟒本色

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

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

临时在线图书

感谢华华提供vps援助 ^每日编译

计划

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

写作范围

顺手的工作环境的搭建包括Leo,MoinMoin,Trac,SVN等（我现在还没学会SVN……）
在实例故事中介绍各个模块
真正教会新手如何使用python解决实际问题

緣起

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

新手就是刚进门的小学生，大牛的任务就是手把手教会他写字，不光如此，还要教会他如何使用这些文字
新手需要的就是实例！
~ ZoomQuiet:
- 新手的状态很难保持,在 Python 世界,所以,施主的及时记录,非常非常可贵!
- 只是,实例,最好有一个核心线索^{作品的演化},可以将所有常用领域的关键知识都串起来,否则,分散成一个个零散的独立功能,无法帮助小白建立大局观的...
QidongSu 回应
- 本身做这么大一个实例已经很牛x了……
jeffjie说
- 这让我想起当时构思现场讲Scala的事，故事的确是最容易引人入胜的，但讲一个好的故事需要花点心思去构想啊。
QidongSu
- 可不可以模仿《python编程》写一个通讯录，然后一直扩展，变成一个数据库

大纲设计

( 详见:RealWorldPyLivin 大蟒本色 - O.B.P ~ Open Book Proj. 4 Chinese Pythonic 中文蟒样开放技术图书计划！ - Google Project Hosting

写作团队

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

目前已有成员

Qidong Su
ream D
He Jibo
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的仓库进行协同编写，以下是加入步骤，请团队成员注意：

环境搭建

首先到 http://bitbucket.org 注册帐号，并向列表申请加入obp
把账号名以邮件方式吼给主持人(dream.python.org AT gmail.com)
- 主持人将把账号追加到 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner 成为可写成员
在 http://mercurial.selenic.com/downloads/ 下载Hg，安装
在http://sphinx.pocoo.org/下载sphinx，安装
- (参见 http://code.google.com/p/openbookproject/wiki/FlowSphinx)

日常撰写/推送

首先，cmd输入以下指令建立本地仓库：
- 首先克隆章节仓库：
- `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner RWPy4learner
- 再克隆实例仓库：
- `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.myaddr RWPy4learner.myaddr

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

[ui]
username = You Name <[email protected]>
[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 <[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 单个文件不易造成仓库混乱或冲突。
完成实例或章节时，可以推送，参照：推送时应注意什么？

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

(更多Hg用法: http://code.google.com/p/kcpycamp/wiki/HgUsage)

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. 有无知识点错误？
  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

-  ⇤ ← Revision 88 as of 2011-05-21 01:36:31 → 
  Size: 9815
  Editor: huangxun
  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 11:
-Line 13:
+Line 12:
+ 临时在线图书::
  * [[http://shellexy.info/books/obp.rwpy4learner/html/|感谢华华提供vps援助]] ^每日编译^
-Line 22:
+Line 24:
-== 新手想要的书 ==
我本身就是一个新手，在使用python的时候有大不爽！
+== 緣起 ==
*新手想要的书* ~ 我本身就是一个新手，在使用python的时候有大不爽！
-Line 37:
+Line 38:
-* ream D
  . 进入第六个工作周，大家激情都不错，继续保持啊

    团队本星期计划：

    完成主体部分~doing
    
    完善已经写过的章节~doing


    统一各章节的格式与文件储存方式~doing


    

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

== 周报 ==
[[http://code.google.com/p/openbookproject/wiki/RwPyLWeeklyreports|RealWorldPyLivin 周报]]

== 临时在线图书 ==
[[http://shellexy.info/books/obp.rwpy4learner/html/|感谢华华提供vps援助]]
== 写作计划 ==
 ream D::
  * 继续往前冲！感觉自个儿发布途径的章节和第五章的内容太少了，这周增补，并完成截图。


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

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

 hejibo1984::
 * 我上周完成了qt.rst，基本上完成了gui一章的写作。 我下周四考完继续写py2exe打包
+ 大纲设计::
    ( 详见:'''[[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 
    1. ream D
    1. He Jibo 
    1. fxiao~默认退出

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

||<:rowbgcolor="#effffe"># || 时间 || 干了什么 || 状态 || 说明 || 备注 ||
||<-6:>''' 2011.3.17 '''||
||~ || 大蟒本色项目建立 || ？ || ？ || ？ || ？ ||
||<-6:>''' 2011.4.10 '''||
||~ || 完成第一部分 || ？ || ？ || ？ || ？  ||
||<-6:>''' 2011.5 '''||
||~ || 完成主体部分，进入修改 || ？ || ？ || ？ || ？ ||
-Line 80:
+Line 66:
-Line 82:
+Line 67:
-Line 84:
+Line 68:
-Line 86:
+Line 69:
-Line 91:
+Line 73:
-Line 93:
+Line 74:
-Line 95:
+Line 75:
-Line 97:
+Line 76:
-Line 99:
+Line 77:
-Line 101:
+Line 78:
-.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次退出。

}}}
== 使用 BitBucket 进行过程协同 ==
+.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次关闭仓库写权限，自己另开仓库进行推送练习，再向主持人发邮件申请合并。再犯退出。

}}}
=== Hg协同 ===
-Line 124:
+Line 100:
-. 在各仓库目录中,配置身份: `打开章节仓库中的.hg/hgrc文件，编辑： ` {{{
+. 在各仓库目录中,配置身份: `打开章节仓库中的.hg/hgrc文件，编辑： {{{
-Line 131:
+Line 107:
-----------------------------------------------------------------------------------
打开实例仓库中的.hg/hgrc文件，编辑：
+# 打开实例仓库中的.hg/hgrc文件，编辑：
-Line 139:
+Line 115:
-然后，在大蟒本色的obp维基中明确
宏观剧情和目录，选定认领章节。

在列表中发帖，申请认领相关章节。 

最后，展开撰写

}}}

    1.完成撰写后， 推送到团队远程中央仓库:{{{
hg add 自个儿增加的文件或文件夹   #如在src下增加hello.rst 则为"hg add src\hello.rst"，再src下增加test文件夹则为"hg add src\test"

   推介使用hg add 单个文件

   不易造成仓库混乱或冲突。
   
   增加到自个儿负责的章节文件夹就好了。

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

    }}}
+}}}
    * 然后，在大蟒本色的obp维基中明确宏观剧情和目录，选定认领章节。
    * 在列表中发帖，申请认领相关章节。 最后，展开撰写
  1.完成撰写后， 推送到团队远程中央仓库:{{{
$ hg add 自个儿增加的文件或文件夹   # 如在src下增加hello.rst 则为"hg add src\hello.rst"
}}}
    * 建议使用`hg add` 单个文件   不易造成仓库混乱或冲突。
    * 完成实例或章节时，可以推送，参照：推送时应注意什么？
-Line 167:
+Line 128:
-== 推送时应注意什么？ ==
+==== push 得注意什么? ====
-Line 180:
+Line 141:
-== 仓库规范 ==
+=== 仓库规范 ===
-Line 198:
+Line 159:
-== 写作团队 ==
同志们先建立自己的维基页面？——QidongSu
 目前已有成员::
    1. Qidong Su 
    1. ream D
    1. He Jibo 
    1. fxiao~默认退出

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

||<:rowbgcolor="#effffe"># || 时间 || 干了什么 || 状态 || 说明 || 备注 ||
||<-6:>''' 2011.3.17 '''||
||~ || 大蟒本色项目建立 || ？ || ？ || ？ || ？ ||
||<-6:>''' 2011.4.10 '''||
||~ || 完成第一部分 || ？ || ？ || ？ || ？  ||
||<-6:>''' 2011.5 '''||
||~ || 完成主体部分，进入修改 || ？ || ？ || ？ || ？ ||

== 如何对已有章节提出修改意见？ ==
+=== 如何对已有章节提出修改意见？ ===
-Line 219:
+Line 163:
-.克隆仓库


2.查阅有意见的章节，找出并记录其中的错误和不足


3.撰写审阅报告：


报告应包含：


1.前后故事是否连贯


2.是否背离宏观剧情


3.有无知识点错误？


4.自个儿对本章的建议

报告完成后，发到obp列表中，和大家讨论，斟酌后进行修改。

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

== 章节任务 ==
-Line 276:
+Line 204:
+=== 周报 ===
[[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打包

Diff for "RealPython"