Differences between revisions 24 and 88 (spanning 64 versions)
⇤ ← Revision 24 as of 2011-03-27 17:32:34 →
Size: 10755
Editor: huangxun
Comment:
← Revision 88 as of 2011-05-21 01:36:31 → ⇥
Size: 9815
Editor: huangxun
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
<<TableOfContents>>

##startInc
Line 4: Line 7:

----
<<TableOfContents>>

##startInc
QidongSu 创意

ream D 总负责

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

<<TableOfContents>>

##startInc		  * 一个转机:[[http://groups.google.com/group/python-cn/browse_thread/thread/ea785465ff4a66ad#|清华大学出版社Python征稿 ]]
 
Line 25: Line 14:
= 章节认领 =
== 计划 ==
就当 [[ObpLovelyPython|可爱的python]] 的进阶版吧，介绍介绍大牛们认为比较好的东西

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

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

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

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

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

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

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

----

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

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

== 新手想要的书 ==
Line 57: Line 30:
Line 65: Line 37:
 * 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有好的实例故事或文章都可以在此增补，直接在线阅览。实现本书的无限增值。


 * 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同志构思，构思好后直接把目录发给我就

是了		 * 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打包

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

   * 使用obp工程的默认规约：
{{{

    - 只要有真实的贡献检入仓库,就算中途 退出,也承认贡献的

    - 如果的确没有任何理由就不参加进展了,算自动退出

    - 想回来,只要说明原因,也就自然回来了

    - 唯贡献和团队协同为先不管面子的
}}}
   * 增加一些权益条例：
{{{

    1.常规状态下，不回复obp列表30次算自愿退出

    2.常规状态下，不执行计划的任务5次算自动退出

    3.常规状态下，拖延承诺的时间10次算自动退出

    4.如有特殊情况需要延期或暂停任务时，要在obp列表中说明

    4.破坏仓库3次，自动退出

    5.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次退出。

}}}
== 使用 BitBucket 进行过程协同 ==
选择: '''[[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 成为可写成员
  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 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
[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"，再src下增加test文件夹则为"hg add src\test"

   推介使用hg add 单个文件

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

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

    }}}

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

  * (更多Hg用法: http://code.google.com/p/kcpycamp/wiki/HgUsage)
 
== 推送时应注意什么？ ==
{{{
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文命名.

}}}

== 写作团队 ==
同志们先建立自己的维基页面？——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 '''||
||~ || 完成主体部分，进入修改 || ？ || ？ || ？ || ？ ||

== 如何对已有章节提出修改意见？ ==

任何人对任何章节持有意见，应：


1.克隆仓库


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


3.撰写审阅报告：


报告应包含：


1.前后故事是否连贯


2.是否背离宏观剧情


3.有无知识点错误？


4.自个儿对本章的建议

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

=== 章节认领 ===

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

{{{
如：第一章:
 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"># || 认领者 || 章节范畴 || 进度 || 附件 || 备注 ||
Line 183: Line 279:

::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z)>>]		 ::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z

Contents

  1. 大蟒本色
    1. 新手想要的书
    2. 大纲设计
    3. 周报
    4. 临时在线图书
    5. 写作计划
    6. 团队规约
    7. 使用 BitBucket 进行过程协同
    8. 推送时应注意什么？
    9. 仓库规范
    10. 写作团队
    11. 时间表（最新进展）
    12. 如何对已有章节提出修改意见？
      1. 章节认领

一个计划

大蟒本色

本来来像叫“实战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编程》写一个通讯录，然后一直扩展，变成一个数据库

* ream D

  • 进入第六个工作周，大家激情都不错，继续保持啊
    • 团队本星期计划： 完成主体部分~doing 完善已经写过的章节~doing 统一各章节的格式与文件储存方式~doing

大纲设计

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

周报

RealWorldPyLivin 周报

临时在线图书

感谢华华提供vps援助

写作计划

ream D
  • 继续往前冲！感觉自个儿发布途径的章节和第五章的内容太少了，这周增补，并完成截图。
QiDongSU
  • 将自己所写的章节每章达到150～ 300linux行，完成截图
fxiao
  • 长期不关注本书进程，默认退出
hejibo1984
  • 我上周完成了qt.rst，基本上完成了gui一章的写作。 我下周四考完继续写py2exe打包

    • 团队规约

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

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

        - 只要有真实的贡献检入仓库,就算中途 退出,也承认贡献的 

    - 如果的确没有任何理由就不参加进展了,算自动退出

    - 想回来,只要说明原因,也就自然回来了

    - 唯贡献和团队协同为先不管面子的
    • 增加一些权益条例： 

        1.常规状态下，不回复obp列表30次算自愿退出

    2.常规状态下，不执行计划的任务5次算自动退出

    3.常规状态下，拖延承诺的时间10次算自动退出

    4.如有特殊情况需要延期或暂停任务时，要在obp列表中说明

    4.破坏仓库3次，自动退出

    5.未经主持人或章节撰写者同意，随意修改该章的，一次警告，二次退出。

    使用 BitBucket 进行过程协同

    选择: 基于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
[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"，再src下增加test文件夹则为"hg add src\test"

   推介使用hg add 单个文件

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

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

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

    推送时应注意什么？

    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文命名.

    写作团队

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

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

    时间表（最新进展）

    #

    时间

    干了什么

    状态

    说明

    备注

    2011.3.17

    ~

    大蟒本色项目建立

    ？

    ？

    ？

    ？

    2011.4.10

    ~

    完成第一部分

    ？

    ？

    ？

    ？

    2011.5

    ~

    完成主体部分，进入修改

    ？

    ？

    ？

    ？

    如何对已有章节提出修改意见？

    任何人对任何章节持有意见，应：

    1.克隆仓库

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

    3.撰写审阅报告：

    报告应包含：

    1.前后故事是否连贯

    2.是否背离宏观剧情

    3.有无知识点错误？

    4.自个儿对本章的建议

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

    章节认领

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

    如：第一章:
 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%

    附件?

    ~

    #

    认领者

    章节范畴

    进度

    附件

    备注

    ::-- QidongSu [<<DateTime(2011-03-07T12:30:26Z

    RealPython (last edited 2012-04-16 10:07:09 by huangxun)