[RwpyL]大蟒本色:发布冲刺TODO
Zoom.Quiet
http://readthedocs.org/docs/rwpy4l/en/latest/index.html
注意!
- 因为原先仓库太多撕裂点,估计 RTFD.org 的服务无法处理,所以,重整到了
https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.v1
- 权限不变
- 大家統一 clone 一下,使用新仓库吧
- HeJibo 认真配置一下 Hg ,不要进行錯誤的并库了吧...
那么,接下来,面向发行前的 TODO,俺先列一下俺知道的,相关的大家自行增补/认领,完成吼:
+ 明确法人代表,选定出版社开始定责任编辑,进入,沟通
+ 人肉 Qidong Su <suqidong001 AT gmail.com> 获得授权
+ 实例代码全面升级到 v2.7.*
- ZQ认领 Bottle 相关的代码测试
- 其它请各自认领
- 注意 https://bitbucket.org/ZoomQuiet/obp.rwpy4learner.myaddr 只能算是实例代码的原型仓库
- 正式发行时,统一使用/src 目录中的代码
+ 方便大段代码的直接包含
问题:
- 严正提醒大家通过版本仓库进行协作的原则:
+ 每次开始前,先 hg pull -u 一下,同步最新进展
+ 完成当日增补时,及时 hg ci
+ 并立即再次 hg pull -u 一下,以便解决可能的冲突
+ 然后及时 hg push 上来,令其它人可以获取
- 每日 push 前,一定要在本地先进行 make html 观察输出效果,解决所有 ERROR
- 当前已经的严重 ERROR:
- ch01/howtobuildpython_start.rst 中的
.. image:: ../_static/snap/jianmingpicture.PNG
截屏不存在!
- ch06/django_pagerank.rst 中的
.. literalinclude:: ../../src/6_others/django/ueseo/templates/pagerank.html
试图包含的模板文件不存在!
请当事人及时解决...
在 2012年4月12日 下午9:30，He Jibo <hej...@gmail.com> 写道：
> 何吉波前来报道。 太好了
> ---------------------------
> He Jibo
> Department of Psychology,
> Beckman Institute for Advanced Science and Technology
> University of Illinois, Urbana Champaign,
> 603 East Daniel St.,
> Champaign, IL 61820
> website: www.hejibo.info
>
>
>
> 2012/4/12 ream D <dream.py...@gmail.com>
>>
>> 从《大蟒本色》图书立项到今年3.17
>>
>> ，《大蟒本色》图书团队已经经历了一年多的奋斗，取得了不错的成绩，图书大楼骨架已经搭好，并进行了数次的浇灌水泥的工作，图书的情节发展顺序已经有了一个明确的过程。
>> 接下来,就是要对情节做进一步的补充，润色，使其变得更加生动，为图书大楼贴装饰瓷砖。。。并且重新讨论更为科学的图书写作模式。
>> 团队成员请跟帖报到，一起来商讨下下一步的大楼贴砖美化工程。。
>> --
>> -dreampython.orgs.hk
>>
>> --
>> '''邮件来自::"OpenBookProject"-开放图书计划 讨论列表
>> 详情: http://groups-beta.google.com/group/OpenBookProject
>> 发言: openboo...@googlegroups.com
>> 退订: openbookproje...@googlegroups.com
>> 维基: http://wiki.woodpecker.org.cn/moin/OpenBookProject
>> 工程环境: http://code.google.com/p/openbookproject
>> 技术列表: http://groups-beta.google.com/group/python-cn
>> '''
>
>
> --
> '''邮件来自::"OpenBookProject"-开放图书计划 讨论列表
> 详情: http://groups-beta.google.com/group/OpenBookProject
> 发言: openboo...@googlegroups.com
> 退订: openbookproje...@googlegroups.com
> 维基: http://wiki.woodpecker.org.cn/moin/OpenBookProject
> 工程环境: http://code.google.com/p/openbookproject
> 技术列表: http://groups-beta.google.com/group/python-cn
> '''
--
人生苦短, Pythonic! 冗余不做,日子甭过!备份不做,十恶不赦!
俺: http://about.me/zoom.quiet
文字协议: http://creativecommons.org/licenses/by-sa/2.5/cn/
ream D
当前，我们先完成代码的迁移到 2.7.1 接着再开始写作吧。目前由于第三章 gui 经jibo 判断在 2.7
下同样能用，第三章暂且不作测试。第四章是说手机的，代码不用迁移，也不用测试，需要测试的章节只有：
第一章
第二章
第五章
其中第五章 bottle 已被大妈认领。我认领第一章，剩下只有第二章了:-)， jibo 第二章吧？
关于出版
当前是 jibo 负责与出版社联系，请 jibo 即时公布最新进展。法人代表经过 哲思 ，稿酬初定公益希望小学。大家看如何？
在 12-4-14，Zoom.Quiet<zoom....@gmail.com> 写道：
--
从我的移动设备发送
Zoom.Quiet
> 谢谢大妈的帮忙，大妈的精神让我们钦佩。
> 当前，我们先完成代码的迁移到 2.7.1 接着再开始写作吧。目前由于第三章 gui 经jibo 判断在 2.7
> 下同样能用，第三章暂且不作测试。第四章是说手机的，代码不用迁移，也不用测试，需要测试的章节只有：
> 第一章
> 第二章
> 第五章
> 其中第五章 bottle 已被大妈认领。我认领第一章，剩下只有第二章了:-)， jibo 第二章吧？
>
> 关于出版
> 当前是 jibo 负责与出版社联系，请 jibo 即时公布最新进展。法人代表经过 哲思 ，稿酬初定公益希望小学。大家看如何？
>
- 最后一点,应该找信任渠道,不能走希望渠道,
- 个人建议可以赞助 1Kg盒子项目
- 其它同意
ps:
再次强调 Hg 真心易用的, bitbucket.org 真心好用的
- 真正合理使用起来吧
- https://bitbucket.org/ZoomQuiet/obp.rwpy4learner/changesets 可以看到历史上有多少意外撕裂....
He Jibo
---------------------------
He Jibo
Department of Psychology,
Beckman Institute for Advanced Science and Technology
University of Illinois, Urbana Champaign,
603 East Daniel St.,
Champaign, IL 61820
website: www.hejibo.info
ream D
在 12-4-14，He Jibo<hej...@gmail.com> 写道：
ream D
"一公斤盒子"是什么？
"一公斤盒子"是传统"多背一公斤"的扩展包，使分享不再局限于书籍和文具。
"一公斤盒子"是一个完整的"工具包"，包括教学或经验分享所需的物品和必要的使用指南。
内容可以涉及美术、音乐、阅读、科普、医疗、互联网等任何主题，it's up to you!
如果大家有什么别的捐助目标也可以发上来，最好带有详细资料，方便大家参考，最后投票选出最终捐助方案吧。
Ps:另外，弱弱地问一句，大妈说的人肉是？...?
在 12-4-14，ream D<dream.py...@gmail.com> 写道：
Zoom.Quiet
另外发布,包括代码,各种文件的编码是混乱的:
- utf-8/cp1805/gbk/gb....
- 引发很多问题
+ 建议大家各自使用不同平台中对 utf-8 支持好的编辑器
+ M$ 中推荐 notepad++/EMEdit
+ Linux 中基本都很好
+ Mac 中 Ticta/Sublime Text ,,,都不错...
将所有文件统一为 UTF-8 UNIX 回车格式!
....
Zoom.Quiet
> 今天看了 一公斤盒子 的简介，做得很不错，很有创意，现在把简介发上来供大家参考：
>
>
>
> "一公斤盒子"是什么？
>
> "一公斤盒子"是传统"多背一公斤"的扩展包，使分享不再局限于书籍和文具。
>
> "一公斤盒子"是一个完整的"工具包"，包括教学或经验分享所需的物品和必要的使用指南。
>
> 内容可以涉及美术、音乐、阅读、科普、医疗、互联网等任何主题，it's up to you!
>
>
> 网站：http://www.1kg.org/
>
>
> 如果大家有什么别的捐助目标也可以发上来，最好带有详细资料，方便大家参考，最后投票选出最终捐助方案吧。
>
>
>
> Ps:另外，弱弱地问一句，大妈说的人肉是？...?
>
- 发动人肉搜索
ream D
ps: cpug 竟然批准人肉…一会就去 cpug 发个人肉贴…
He Jibo
---------------------------
He Jibo
Department of Psychology,
Beckman Institute for Advanced Science and Technology
University of Illinois, Urbana Champaign,
603 East Daniel St.,
Champaign, IL 61820
website: www.hejibo.info
Zoom.Quiet
> 大家好， 我正在修订我们的第二章节的代码。有没有办法把一个章节单独做成pdf呀？想打印出来校对。
>
参考:关于本书的编写 — 用Python做科学计算
http://hyry.dip.jp:8000/pydoc/pydoc_write_tools.html
Sphinx 本身支持 pdf 输出的
不过,你本地的环境要配置好,
Zoom.Quiet
- 多数是不当的代码引用/插图,以及非法缩进引发的,,,
- 请大家詳細参考:
http://readthedocs.org/docs/rwpy4l/en/latest/README.html
- 注意統一:
+ 插图,应该使用 .. figure:: 标记,并配合明确的引用标记
+ 而且,插图的标识,应该統一編號
+ 俺建议使用 插图X-XX 名称 的形式,以便各个章节内部自行调整
+ 当前的 图X 名称 ,完全无法进行整体唯一的,,,
再次强調, push 前,请 make html 观察 Sphinx 的汇报,先将自个儿章节的编译问题解决了!
- 俺修訂了几十处问题,实在没有力气了,,
- 目前章节,依然保存几十处,外部代码引用,非法缩进,,,问题!
- 至少解决所有 ERROR, 警告先可以不管的,,,
ream D
在 12-4-20，Zoom.Quiet<zoom....@gmail.com> 写道：
> 今天想集中精力将 Bottle 相关的内容,进行技术校对,但是,发觉如附件截屏的大批量錯誤
> - 多数是不当的代码引用/插图,以及非法缩进引发的,,,
> - 请大家詳細参考:
> http://readthedocs.org/docs/rwpy4l/en/latest/README.html
>
> - 注意統一:
> + 插图,应该使用 .. figure:: 标记,并配合明确的引用标记
> + 而且,插图的标识,应该統一編號
> + 俺建议使用 插图X-XX 名称 的形式,以便各个章节内部自行调整
> + 当前的 图X 名称 ,完全无法进行整体唯一的,,,
>
> 再次强調, push 前,请 make html 观察 Sphinx 的汇报,先将自个儿章节的编译问题解决了!
> - 俺修訂了几十处问题,实在没有力气了,,
> - 目前章节,依然保存几十处,外部代码引用,非法缩进,,,问题!
> - 至少解决所有 ERROR, 警告先可以不管的,,,
>
> 在 2012年4月18日 下午1:04，Zoom.Quiet <zoom....@gmail.com> 写道：
>> 在 2012年4月18日 上午11:38，He Jibo <hej...@gmail.com> 写道：
>>> 大家好， 我正在修订我们的第二章节的代码。有没有办法把一个章节单独做成pdf呀？想打印出来校对。
>>>
>> 参考:关于本书的编写 -- 用Python做科学计算
ream D
我觉得可以展开下一步工作了：
完善探索过程
目前我们的章节里面有很多探索过程仍然很笼统，就截取我章节中的某部分来说：
- 迷茫中的小白再次到列表发问：如何用一个变量就能储存所有联系人信息呢？
- 行者给出实例：
list=['1','2','b']
print list[0]
print list[1]
print list[2]
小白复制>运行
1
2
b
小白以下就明白了：python是从0开始计算的，list[0]代表调用列表中的值1。那么list[1]，
假定读者是一个之前没有接触过程序的小白，那么读者连list是什么都不知道，这里突然就蹦出 list，而且没有小白探索 list
的详细过程，那么，读者会感觉很困惑。
我觉得比较好的过程应该是这样：
1.小白问行者有什么能实现一个变量储存多个数据
2.行者答 list
3.小白在简明中找到 list 通过学习和实践后掌握其特性
4.完成 list 的学习，结合到通信录程序中
我觉得我们这本书最精华的就是探索过程，但是目前书中仍有很多这样的不足，不如大家下一步就完善一下探索过程怎么样？
在 12-4-20，ream D<dream.py...@gmail.com> 写道：
Zoom.Quiet
> 现在大家都已经基本把代码迁移到 Python 2.7.1 了。
- 是也乎,是也乎,刚刚完成 bottle 部分代码的测试,没有问题!
> 我觉得可以展开下一步工作了：
> 完善探索过程
> 目前我们的章节里面有很多探索过程仍然很笼统，就截取我章节中的某部分来说：
>
> - 迷茫中的小白再次到列表发问：如何用一个变量就能储存所有联系人信息呢？
>
> - 行者给出实例：
>
> list=['1','2','b']
>
> print list[0]
>
> print list[1]
>
> print list[2]
>
> 小白复制>运行
>
> 1
>
> 2
>
> b
>
> 小白以下就明白了：python是从0开始计算的，list[0]代表调用列表中的值1。那么list[1]，
>
>
> 假定读者是一个之前没有接触过程序的小白，那么读者连list是什么都不知道，这里突然就蹦出 list，而且没有小白探索 list
> 的详细过程，那么，读者会感觉很困惑。
>
> 我觉得比较好的过程应该是这样：
> 1.小白问行者有什么能实现一个变量储存多个数据
> 2.行者答 list
> 3.小白在简明中找到 list 通过学习和实践后掌握其特性
> 4.完成 list 的学习，结合到通信录程序中
>
> 我觉得我们这本书最精华的就是探索过程，但是目前书中仍有很多这样的不足，不如大家下一步就完善一下探索过程怎么样？
>
是也乎,是也乎,严正同意,俺一直在跟着进度看图书的内容
- 其实,真心不能算是书
- 只能説是种笔记提纲
- 读者,真心完全难以转换成实际的行动
- 各种突然引入的概念/工具/操作/过程...只是几个字就过去了,,,
俺想,应该統一个读者的对象描述:
+ 中专以上
+ E文基本可以看
+ 有基础的编程体验,至少是 VB/Pascal/PHP ...
+ 有基础的互联网概念
否则,描述无底线的,,,
但是,又得考虑到图书行文的完备,不能因为技术知识点的需要,插入大段的描述/代码/实验...
- 那真心无法阅读了
- 所以,可愛的 Python 設計了作弊条结构:
http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/BeginBook
- 是否大家也可以这么来?
- 正文,以小白的探索开发过程为线索
- 描述主要的思考/交流/尝试/顿悟过程
- 而相关的技术细节,以及代码/分析/扩展说明,以独立的小节,收集在书后
- 在关键段落中,以旁注的形式指引过去就好?
PS:
- web 部分,代码已经没有问题,非常简单
- 请主创,自学一下,将其体验过程,融合到正文中吧
- 俺来的話,难以把握什么应该說,什么不应该說,,,
已经,过了小白的阶段了,,,
...
ream D
我看过一些《可爱的python》书评就是这样认为。
毕竟我们刚开始设计写本书就是为了想入门python，没有编程经验，懂基础英语，熟练操纵计算机的读者写的。我觉得在前面的章节中，可以没有某一个知识点的全部内容，但探索过程一定要详细，具体内容在作弊条补上。比如讲list的时候不用讲其全部用法，但在作弊条那具体讲下，可能会好些吧。
ream D
Zoom.Quiet
> 不知道大家怎样认为呢？
>
> 在 2012年4月20日星期五，ream D <dream.py...@gmail.com> 写道：
>
>> 不过，这样会不会导致一种情况：没有编程经验的看不懂，有点编程经验的又认为不够详细。
- 所以,要精确把握目标读者的心理需求吼
- 俺同意,尽可能的还原探索过程,将初学过程中,所有可能的门槛都表述清楚,,,,
He Jibo
---------------------------
He Jibo
Department of Psychology,
Beckman Institute for Advanced Science and Technology
603 East Daniel St.,
Champaign, IL 61820
website: www.hejibo.info
ream D
读者：
熟练使用 window
懂基本英语
无编程经验
主角设定：
小白
熟练使用 windows xp
无编程经验
熟知高中英语必会单词3000
使用 python 2.7.1
我在第一章中，为了起到小白的知识引导作用，设多了一个人物：小白的舅舅。具体作用可以看看我改好的第一章一、二节，以下是小白舅舅的设定：
有 python 编程经验
职业程序员
这个人物暂时是拟定，个人觉得应该有用，具体定不定请大家讨论。
那么，大家认领章节吧？
我负责一、四章过程补充。
在 12-4-20，He Jibo<hej...@gmail.com> 写道：
> --
> '''邮件来自::"OpenBookProject"-开放图书计划 讨论列表
> 详情: http://groups-beta.google.com/group/OpenBookProject
> 发言: openboo...@googlegroups.com
> 退订: openbookproje...@googlegroups.com
> 维基: http://wiki.woodpecker.org.cn/moin/OpenBookProject
> 工程环境: http://code.google.com/p/openbookproject
> 技术列表: http://groups-beta.google.com/group/python-cn
> '''
>
ream D
在 12-4-21，ream D<dream.py...@gmail.com> 写道：
He Jibo
---------------------------
He Jibo
Department of Psychology,
Beckman Institute for Advanced Science and Technology
University of Illinois, Urbana Champaign,
603 East Daniel St.,
Champaign, IL 61820
website: www.hejibo.info
ream D
He Jibo
ream D
ream D
另外，我发现在章节中用
::
示例代码
这种形式显示示例代码时总是会出现有些段落的代码显示不正常的情况，最新的这两节都有这个问题：
http://readthedocs.org/docs/rwpy4l/en/latest/ch01/variable_object_mala.html
http://readthedocs.org/docs/rwpy4l/en/latest/ch01/useif.html
以前从来没有出现过这种问题，试了一下好像不能解决，大家有什么好办法吗？谢谢
在 12-4-22，ream D<dream.py...@gmail.com> 写道：
Zoom.Quiet
> 今天已经完成 第三节 的过程增补，大家看看有些什么问题没有？有的话请拍砖以便及时修改。
>
> 另外，我发现在章节中用
> ::
> 示例代码
> 这种形式显示示例代码时总是会出现有些段落的代码显示不正常的情况，最新的这两节都有这个问题：
> http://readthedocs.org/docs/rwpy4l/en/latest/ch01/variable_object_mala.html
> http://readthedocs.org/docs/rwpy4l/en/latest/ch01/useif.html
>
> 以前从来没有出现过这种问题，试了一下好像不能解决，大家有什么好办法吗？谢谢
>
- 嗯嗯嗯,在本地进行 make html 过嘛?
- 如附件截屏,有非常非常非常明确的提示的
- 俺随手修訂几处,立即安定的,,,
全部是非常非常 基础的 rST 格式问题,,,
:: 导出的代码块,是要有个空行,然后統一缩进 4空格先的,,,
而且,不是所有代码説明都必须使用 代码引用块的
- 有的明确是概念的阐述,使用名词解释格式也可以的,,,
大家,真心,先看一下 rST 的简明格式手册什么的吧,,,
--
ream D
在 12-4-23，Zoom.Quiet<zoom....@gmail.com> 写道：
ream D
He Jibo
---------------------------
He Jibo
Department of Psychology,
Beckman Institute for Advanced Science and Technology
University of Illinois, Urbana Champaign,
603 East Daniel St.,
Champaign, IL 61820
website: www.hejibo.info
ream D
在 12-4-23，He Jibo<hej...@gmail.com> 写道：