Differences between revisions 30 and 96 (spanning 66 versions)
Revision 30 as of 2011-03-27 18:46:06
Size: 7381
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 7: Line 7:
 * 一个转机:[[http://groups.google.com/group/python-cn/browse_thread/thread/ea785465ff4a66ad#|清华大学出版社Python征稿 ]]
Line 10: Line 11:
Line 13: Line 13:
== 计划 ==
就当 [[ObpLovelyPython|可爱的python]] 的进阶版吧,介绍介绍大牛们认为比较好的东西

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

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

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

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

=== 新手想要的书 ===
我本身就是一个新手,在使用python的时候有大不爽!
 正式在线图书预览::
  * [[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 42: Line 44:
 * ream D
  . 写作主要是要有毅力和凝聚力,大家要坚持下去啊

== 计划目录 ==
大蟒本色

大概故事情节:
临近高考的小白要与同窗好友分别,于是就想到要做一个同学录,但发现没有称心的软件。于是,他打算自己写一个。

前言 介绍 介绍
(故事在这里起头。向读者介绍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 界面绚丽化 (图片的插入,画几何图形,字体设置)
--------------------------------------------------------------
   3.8 用wxpython优化gui (采用he同志的建议:小白已经用tkinter 完成了通讯录gui,但是主人公尚未满足,因为他的mm说界面不好看之类的,因此主人公打算改进,于是发现了wxpython)
   ps:这一部分是he的思路,目录交给he写,个人感觉可以介绍下zoombar等特技效果
   3.8.1,3.8.2.......
   3.9 qt实现gui
   ps:也是he的思路,目录交由he写
   3.9.1,3.9.2.......
---------------------------------------------------------------
第四章 用gae框架写的同学录
   4.1 用我自己的模块
   4.2 用户权限控制
   4.3 美工设计
   4.4 发布
   4.5 本地同学录与在线同学录的同步
第五章 向世人展示自己——发布
   5.1 什么是py2exe (介绍py2exe和其基本用法)
   5.2 py2exe高级用法(设置exe图标,版本号等高级用法)
   5.4 什么是setup.py
   5.5 setup.py 用法
   5.6 发布途径(介绍各种发布方式)
第六章 把通信录移植到手机上
   6.1 PPC python环境搭建
   6.2 移植到PPC
第七章 后补章节及py工具介绍
   7.1 tk之另类用法(增补前面实例故事没法讲到的某些用法)
   7.2 游戏人生(简要介绍pygame,用实例说明问题(射击游戏))
   7.3 用google翻译api实现国际化
   7.4 其他python gui
              pyqt
              wxpython
              pyside
              pygtk
   7.5 py框架介绍
              karrigell
              cherrypy
              web.py
              web2py
              django
              pylons
   7.6 py工具介绍
              ipython
              leo
              pywin
   7.7 python在各个移动平台的环境搭建
              ipad
              psp(sony)
              ipod touch
              s60
   7.8 python 2x 与 3x 的区别(介绍语法上的差异和 2 to 3 工具,实现2到3的过度)

===========================

第八章 发挥自个儿的想象(不写入成书)
   #想在realpython的Wiki中专门添加个第八章的专区,任何pythoner有好的实例故事或文章都可以在此增补,直接在线阅览。实现本书的无限增值。

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

= 章节认领 =

---------------------------------------------------------------------------------

认领规则:

在相应的章节后写上自个儿姓名,认领节数,具体认领内容,进度,作品的文档(在attachment中上传文件,再用attachment:“文件名”指定到该文件。作品文档必须是纯文本格式)


 大纲设计::
    ( 详见:'''[[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协同 ===
选择: '''[[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 - 已废,实例融合在章节仓库中
   * `hg clone https://bitbucket.org/ZoomQuiet/obp.rwpy4learner RWPy4learner

  1. 在各仓库目录中,配置身份: `打开章节仓库中的.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` 单个文件 不易造成仓库混乱或冲突。
    * 完成实例或章节时,可以推送,参照:推送时应注意什么?

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

  * (更多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 创建提案来追踪!

== 章节任务 ==

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

{{{
Line 142: Line 199:
Line 144: Line 200:


Line 148: Line 201:
----------------------------------------------------------------------------------

== 认领者名单: ==
=== 第一章: ===

ream D 1.1-1.4 认领本章所有故事情节和实例 0% 文件暂无

ps:先带头认领一章,我一个星期更新一次进度






=== 第二章: ===








=== 第三章: ===








=== 第四章: ===












=== 第五章: ===












=== 第六章: ===











=== 第七章: ===








=== 第七章:(不列入成书) ===






=== 固定的写作团队(3-5人) ===
==== 目前已有成员 ====

Qidong Su ,ream D,He Jibo , fxiao
}}}

||<: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打包

一个计划

大蟒本色

本来来像叫“实战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)