Differences between revisions 23 and 94 (spanning 71 versions)

Contents

大蟒本色

一个计划

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

大蟒本色

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

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

正式在线图书预览

正式在线图书预览(readthedocs)

临时在线图书预览

感谢华华提供vps援助(点一) ^{每四小时编译}

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

计划

就当可爱的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练习，再向主持人发邮件申请合并。再犯退出。

Hg协同

选择: 基于Sphinx的图书协同

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

环境搭建

首先到 http://bitbucket.org 注册帐号，并向列表申请加入obp
把账号名以邮件方式吼给主持人(dream.python.org AT gmail.com)
- 主持人将把账号追加到 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1 成为可写成员
在 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.v1 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.v1
[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 23 as of 2011-03-27 17:28:37 → 
  Size: 11368
  Editor: huangxun
  Comment:
+   ← Revision 94 as of 2012-04-16 09:55:31 → ⇥
  Size: 10248
  Editor: huangxun
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 3:
+<<TableOfContents>>

##startInc
-Line 4:
+Line 7:
-----

/!\ '''Edit conflict - other version:''' 1
----

<<TableOfContents>>

##startInc
= 报名地点 =
写上自己想写的部分

QidongSu 创意

ream D 总负责

= 日程计划 =
= 大蟒本色 =
本来像叫“实战python”的，翻译成英文就叫RealPython了……

----

/!\ '''Edit conflict - your version:''' 2
----

<<TableOfContents>>

##startInc
+ * 一个转机:[[http://groups.google.com/group/python-cn/browse_thread/thread/ea785465ff4a66ad#|清华大学出版社Python征稿 ]]
-Line 34:
+Line 11:
-----

/!\ '''End of edit conflict'''
----
-Line 42:
+Line 13:
-= 章节认领 =
== 计划 ==
就当 [[ObpLovelyPython|可爱的python]] 的进阶版吧，介绍介绍大牛们认为比较好的东西

比如各个模块、工作环境，使新手能够获取最爽的体验。

大妈觉得比较好用的Leo啥的详细介绍一下吧。

要解决一下新手在使用Python时会遇到的实际问题

=== 计划写作范围 ===
----

/!\ '''Edit conflict - other version:'''
----

----

/!\ '''Edit conflict - your version:'''
----

----

/!\ '''End of edit conflict'''
----

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

=== 新手想要的书 ===
----

/!\ '''Edit conflict - other version:'''
----

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

----

/!\ '''Edit conflict - your version:'''
----

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

----

/!\ '''End of edit conflict'''
----
+ 正式在线图书预览::
  * [[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)]] ^每四小时编译^

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

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

== 緣起 ==
*新手想要的书* ~ 我本身就是一个新手，在使用python的时候有大不爽！
-Line 97:
+Line 37:
-----

/!\ '''Edit conflict - other version:'''
----
-Line 110:
+Line 44:
- * ream D
  . 我要报名，希望能帮帮忙
 * He, Jibo (hejibo1984)
  . 想参与或者负责gui与py2exe两章节。

== 计划目录 ==
前言 介绍 介绍 （故事在这里起头。向读者介绍python，环境搭建，并给出第一个程序 print 'hello world'） 第一章 我要做通信录

 . 1.1 通信录之变量版（本节教会读者用变量保存信息，并通过pythonshell下调用相对应的变量以获得相关数据） 1.2 判断用if (本节教会读者用if语句判断用户输入的信息，并返回对应的结果) 1.3 函式化 （把通信录核心函式化，通过函式调用相关功能，并教会读者使用while） 1.4 中文！中文！ （讲解python中文问题并给出解决办法，使通信录中文化）

第二章 模块

 . 2.1 让程序有退出功能 （介绍什么是模块，模块的创建与应用） 2.2 添加修改联系人信息 （自个儿编写基于文件的数据库模块，并实现存取信息[这里将讲到class，字典和列表]） 2.3 带有筛选功能的通信录 (将在此介绍for) 2.4 输出联系人资料为文本文件 (此处介绍文件操作)

[用两章结束对python基础知识的讲解] 第三章 通信录gui化

 . 3.1 简单易用的tkinter (意在介绍tk，给出第一个tk程序) 3.2 牛刀小试 （介绍entry、text、button控件，使得从entry输入的联系人的详情能在下方text中返回） 3.3 拥有菜单的通信录 3.4 图形化筛选功能 （介绍单选框复选框） 3.5 联系人条目listbox化 3.6 创建滚动条 3.7 界面绚丽化 （图片的插入，画几何图形，字体设置）

第四章 向世人展示自己——发布

 . 4.1 什么是py2exe (介绍py2exe和其基本用法） 4.2 py2exe高级用法（设置exe图标，版本号等高级用法） 4.3 发布途径（介绍各种发布方式）

第五章 简易的wiki系统

 * 还没想好该用什么框架，此处暂略

第六章 把通信录移植到手机上

 . 6.1 PPC python环境搭建 6.2 移植到PPC

第七章 wx化.qt化（故事情节：小白不仅仅满足于tk简陋的界面，积极向更高级的wx,qt探索）

 . 7.1 通信录wx化 （用一个大实例涉及wx 90％操作，并介绍wxglad） 7.2 通信录之qt化 (介绍qt并用一个大实例涉及qt 70％操作，并介绍qt工具)

(He，Jibo: 其实gui也可能用通讯录做为故事啦，只是我得用wxpython和pyqt分别写一个通讯录。 我对gui这一章节是这样设想的。 现在主要有两种方式写gui，手动写代码和用可视化界面写代码。 我打算以wxpython示例，怎么手动写代码；以pyqt为示例，教怎么用qt designer写代码。

故事承前面，可以这样开头。 虽然已经用tkinter 完成了通讯录gui,但是主人公尚未满足，因为他的mm说界面不好看之类的，因此主人公打算改进。于是发现了wxpython。讲述wxpython时，我打算教用户搜索一个hello world的gui示例，然后在纸上画一个通讯录界面蓝图。然后在搜索的帮助下，逐步在hello world的基础上增加通讯录的元素。

（过度到pyqt），主人公想，如果做界面能够像画图板那样画出界面元素就好了。于是他到CPyUG发贴，咨询解决方案，得知了qt designer。接着我就讲用qt designer作界面。

不知道大伙意下如何？)

第八章 后补章节及py工具介绍

 . 8.1 tk之另类用法（增补前面实例故事没法讲到的某些用法） 8.2 游戏人生（简要介绍pygame，用实例说明问题（射击游戏）） 8.3 用google翻译api实现国际化 8.4 其他python gui
  . pyqt wxpython pyside pygtk
 8.5 py框架介绍
  . karrigell cherrypy web.py web2py django
 8.6 py工具介绍
  . ipython leo pywin
 8.7 python在各个移动平台的环境搭建
  . ipad psp(sony) ipod touch s60

=========================== 第九章 发挥自个儿的想象（不写入成书）

 . ＃想在realpython的Wiki中专门添加个第九章的专区，任何pythoner有好的实例故事或文章都可以在此增补，直接在线阅览。实现本书的无限增值。

[[attachment:测试]]

----

/!\ '''Edit conflict - your version:'''
----

 * QidongSu 回应
  . 本身做这么大一个实例已经很牛x了……
 * jeffjie说
  . 这让我想起当时构思现场讲Scala的事，故事的确是最容易引人入胜的，但讲一个好的故事需要花点心思去构想啊。
 * QidongSu
  . 可不可以模仿《python编程》写一个通讯录，然后一直扩展，变成一个数据库

 * ream D
  . 我要报名，希望能帮帮忙

== 计划目录 ==
前言 介绍 介绍<<BR>>（故事在这里起头。向读者介绍python，环境搭建，并给出第一个程序 print

'hello world'）

第一章 我要做通信录<<BR>> 1.1 通信录之变量版（本节教会读者用变量保存信息，并通过pythonshell下

调用相对应的变量以获得相关数据）<<BR>> 1.2 判断用if (本节教会读者用if语句判断用户输入的信息，并返回对应的结

果)<<BR>> 1.3 函式化 （把通信录核心函式化，通过函式调用相关功能，并教会读者使

用while）<<BR>> 1.4 中文！中文！ （讲解python中文问题并给出解决办法，使通信录中文化

）

第二章 模块<<BR>> 2.1 让程序有退出功能 （介绍什么是模块，模块的创建与应用）<<BR>> 2.2 添加修改联系人信息 （自个儿编写基于文件的数据库模块，并实现存取

信息[这里将讲到class，字典和列表]）<<BR>> 2.3 带有筛选功能的通信录 (将在此介绍for)<<BR>> 2.4 输出联系人资料为文本文件 (此处介绍文件操作)<<BR>>[用两章结束对python基础知识的讲解]

第三章 通信录gui化<<BR>> 3.1 简单易用的tkinter (意在介绍tk，给出第一个tk程序)<<BR>> 3.2 牛刀小试 （介绍entry、text、button控件，使得从entry输入的联系人

的详情能在下方text中返回）<<BR>> 3.3 拥有菜单的通信录<<BR>> 3.4 图形化筛选功能 （介绍单选框复选框）<<BR>> 3.5 联系人条目listbox化<<BR>> 3.6 创建滚动条<<BR>> 3.7 界面绚丽化 （图片的插入，画几何图形，字体设置）<<BR>>
----------

<<BR>> 3.8 用wxpython优化gui （采用he同志的建议：小白已经用tkinter 完成了通

讯录gui,但是主人公尚未满足，因为他的mm说界面不好看之类的，因此主人公打

算改进，于是发现了wxpython）<<BR>> ps:这一部分是he的思路，目录交给he写，个人感觉可以介绍下zoombar等特技

----

/!\ '''End of edit conflict'''
----

效果<<BR>> 3.8.1,3.8.2.......<<BR>> 3.9 qt实现gui<<BR>> ps:也是he的思路，目录交由he写<<BR>> 3.9.1,3.9.2.......<<BR>>
----------

<<BR>>第四章 用gae框架写的同学录<<BR>> 4.1 用我自己的模块<<BR>> 4.2 用户权限控制<<BR>> 4.3 美工设计<<BR>> 4.4 发布<<BR>> 4.5 本地同学录与在线同学录的同步<<BR>>第五章 向世人展示自己——发布<<BR>> 5.1 什么是py2exe (介绍py2exe和其基本用法）<<BR>> 5.2 py2exe高级用法（设置exe图标，版本号等高级用法）<<BR>> 5.4 什么是setup.py<<BR>> 5.5 setup.py 用法<<BR>> 5.6 发布途径（介绍各种发布方式）<<BR>>第六章 把通信录移植到手机上<<BR>> 6.1 PPC python环境搭建<<BR>> 6.2 移植到PPC<<BR>>第七章 后补章节及py工具介绍<<BR>> 7.1 tk之另类用法（增补前面实例故事没法讲到的某些用法）<<BR>> 7.2 游戏人生（简要介绍pygame，用实例说明问题（射击游戏））<<BR>> 7.3 用google翻译api实现国际化<<BR>> 7.4 其他python gui<<BR>> pyqt<<BR>> wxpython<<BR>> pyside<<BR>> pygtk<<BR>> 7.5 py框架介绍<<BR>> karrigell<<BR>> cherrypy<<BR>> web.py<<BR>> web2py<<BR>> django<<BR>> pylons<<BR>> 7.6 py工具介绍<<BR>> ipython<<BR>> leo<<BR>> pywin<<BR>> 7.7 python在各个移动平台的环境搭建<<BR>> ipad<<BR>> psp(sony)<<BR>> ipod touch<<BR>> s60<<BR>> 7.8 python 2x 与 3x 的区别（介绍语法上的差异和 2 to 3 工具，实现2到3

的过度）<<BR>>===========================<<BR>>第八章 发挥自个儿的想象（不写入成书）<<BR>> ＃想在realpython的Wiki中专门添加个第八章的专区，任何pythoner有好的实

例故事或文章都可以在此增补，直接在线阅览。实现本书的无限增值。

ps:wxpython和pyqt两部分的目录交由he同志构思，构思好后直接把目录发给我就

是了
+ 大纲设计::
    ( 详见:'''[[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 '''||
||~ || 完成主体部分，进入修改 || ？ || ？ || ？ || ？ ||

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

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

}}}
=== Hg协同 ===
选择: '''[[http://code.google.com/p/openbookproject/wiki/FlowSphinx|基于Sphinx的图书协同]]'''

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

 环境搭建::
  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，安装
   * (参见 http://code.google.com/p/openbookproject/wiki/FlowSphinx)

 日常撰写/推送:: 
  1. 首先，cmd输入以下指令建立本地仓库：
   * 首先克隆章节仓库：
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1 RWPy4learner
   * 再克隆实例仓库：
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.myaddr RWPy4learner.myaddr - 已废,实例融合在章节仓库中
  1. 在各仓库目录中,配置身份: `打开章节仓库中的.hg/hgrc文件，编辑： {{{
[ui]
username = You Name <[email protected]>
[paths]
default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1
[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. 克隆仓库
 1. 查阅有意见的章节，找出并记录其中的错误和不足
 1. 撰写审阅报告：
  * 报告应包含：
    1. 前后故事是否连贯
    1. 是否背离宏观剧情
    1. 有无知识点错误？
    1. 自个儿对本章的建议
  * 报告完成后，发到obp列表中，和大家讨论，斟酌后进行修改。
  * 也可以直接在 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner/issues 创建提案来追踪!

== 章节任务 ==

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

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

||<:rowbgcolor="#effffe"># || 认领者 || 章节范畴 || 进度 || 附件 || 备注 ||
||<-6:>''' 第一章 '''||
||~ || ream D || 1.1-1.5 || 100% || 附件? || 认领本章所有故事情节和实例 ||
||<-6:>''' 第二章 '''||
||~ || QidongSu || 前言,第二章 || 100% || 附件? || 认领本章  ||
||<-6:>''' 第三章 '''||
||~ || hejibo1984 || 通信录gui化 || 100% || 附件? || 所有故事和代码实例 ||
||<-6:>''' 第四章 '''||
||~ || QidongSu,ream D,HeJiBo || setup.py,发布途径 || 100% || 附件? || 故事与实例 ||
||<-6:>''' 第五章 '''||
||~ || ream D || 通信录移植 || 100% || 附件? || ~ ||
||<-6:>''' 第六章 '''||
||~ || QidongSu || web bottle部分和apache 第六章全部 || 100% || 附件? || 认领本章部分故事情节和实例 ||
||<-6:>''' 第七章 '''||
||~ || ?? || ?? || 0% || 附件? || ~ ||
||<-6:>''' 第八章 '''||
||~ || ?? || ?? || 0% || 附件? || ~ ||
||<:rowbgcolor="#effffe"># || 认领者 || 章节范畴 || 进度 || 附件 || 备注 ||

=== 周报 ===
[[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打包
-Line 234:
+Line 238:
-::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z)>>]
+::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z

Diff for "RealPython"