##language:zh #pragma section-numbers off <> ##startInc 一个计划 * 一个转机:[[http://groups.google.com/group/python-cn/browse_thread/thread/ea785465ff4a66ad#|清华大学出版社Python征稿 ]] = 大蟒本色 = 本来来像叫“实战python”的，翻译成英文就叫RealPython了…… * ~ ZoomQuiet ,肯定需要! 只是E文应该吼 `Real World Python for freshener` 正式在线图书预览:: * [[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的时候有大不爽！ * 新手就是刚进门的小学生，大牛的任务就是手把手教会他写字，不光如此，还要教会他如何使用这些文字 * 新手需要的就是实例！ * ~ ZoomQuiet: * 新手的状态很难保持,在 Python 世界,所以,施主的及时记录,非常非常可贵! * 只是,实例,最好有一个核心线索^作品的演化^,可以将所有常用领域的关键知识都串起来,否则,分散成一个个零散的独立功能,无法帮助小白建立大局观的... * QidongSu 回应 . 本身做这么大一个实例已经很牛x了…… * jeffjie说 . 这让我想起当时构思现场讲Scala的事，故事的确是最容易引人入胜的，但讲一个好的故事需要花点心思去构想啊。 * QidongSu . 可不可以模仿《python编程》写一个通讯录，然后一直扩展，变成一个数据库 大纲设计:: ( 详见:'''[[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 [paths] default = https://帐号名:口令@bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1 username = You Name [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 [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打包 ##endInc ---- ::-- QidongSu [<