Differences between revisions 20 and 55 (spanning 35 versions)
⇤ ← Revision 20 as of 2008-06-02 14:40:37 →
Size: 7990
Editor: ZoomQuiet
Comment:
← Revision 55 as of 2009-03-18 09:41:17 → ⇥
Size: 8902
Editor: ZoomQuiet
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
 ACL::
 `#acl LovPyBookGroup:read,write,delete,revert All:`
  * 交付后,所有章节的正文将使用以上ACL进行封闭,6个月后恢复,以便支持图书的销售,,,
Line 10: Line 13:
愿:
Line 12: Line 16:
再愿:
`2008-06-15 前必须完成所有撰写工作!`

再期愿:
`2008-09-01 前必须完成所有内容撰写工作!`

不得不愿:
`2008-11-11 光棍节 前可以见到全部排版小样!`

终于可以愿:
`2008-12-31 元旦节 前可以见到全部排版小样!`

`终于再次发愿:`
[http://groups.google.com/group/openbookproject/browse_thread/thread/8eb3c13c646546d3# Fwd: 与两位老师协商《可爱的Python》页码压缩事宜] ^ - OpenBookProject | Google 网上论坛^ 可以顺利完成


== 排版调整页数 ==
{{{
文前内容~
 哲思社区总序 2页
 推荐序 1页+背白
 序 2页
 前言 4页
~~~~~~~~~~~~~~~~~~~~~
合计 8页
~~~~~~~~~~~~~~~~~~~~~
正文内容~
CDays内容 78页（包括一个背白）
KDays内容 72页
PCS内容 261页（其中PCS304应该是34页）
~~~~~~~~~~~~~~~~~~~~~
合计 411页
~~~~~~~~~~~~~~~~~~~~~
文后内容~
 附录总言 1页
 术语索引 15页+背白
 行者箴言 17页+背白
 跋 z序(4页)+15页(包含谢序和后记故事) = 19页+背白 最多15页
~~~~~~~~~~~~~~~~~~~~~
合计 55页
~~~~~~~~~~~~~~~~~~~~~
总计 474页
}}}
Line 14: Line 61:
== 分析 == == 编辑分析 ==
Line 20: Line 67:
== 对策 ==  排版意见::
  1. '''[:/LayoutMointext:moin文本排版指南]'''
  1. ''[:/LayoutDiscuss:图书排版效果讨论一次]''
  1. '''[:/ContentDiscuss:图书修订讨论]'''^080723 14:00~^
 
 讨论和进展::
  * ^080925 11:00~^'''[:/NewInvite:特邀专家加入撰写WEB应用框架相关]'''
  * ^080828 15:00~^'''[:/NewEditorDicuss:老编Lisa 加入,MSN讨论进度]'''
  * [:/080613-irc:080613~IRC-讨论未果]
  * [:/080612-irc:080612~IRC-编辑讨论]
  * [:/080602-liz:080602~liz]


== 改进对策 ==
Line 31: Line 91:

==== 故事图谱 ====

'''[:/StoryMapping:故事图谱图例设计和约定]'''
Line 54: Line 119:
 attachment:CDay-3.png

==== 故事图谱 ====

'''[:/StoryMapping:故事图谱图例]'''		  CDay-5::
  attachment:LovPy-CDays-5.png
 CDay-4::
  attachment:LovPy-CDays-4.png
Line 83: Line 147:

 图片统一命名::
{{{
图 Charpt-No.png
| | | +-- 统一使用PNG格式提供
| | +-- 章节附图序号
| +-- 章节序号
+-- 统一标识字
}}}
  * e.g:
   * `图 CDay-4-2.png` 意为 CDay -4 章节 第2附图		 [[Include(/AttaPicName,,from="^##startInc$",to="^##endInc$")]]
Line 103: Line 157:
  * 参考资料:
   * [http://www.2maomao.com/blog/best-programmer-fonts/ 程序员最喜欢用的编程字体]
   * [http://www.osxcn.com/ubuntu/heiti-contrast.html 常见黑体显示效果对比 - Nicky's blog]
Line 117: Line 174:
  * 所有图书中涉及到的语言/软件/社区/团队 有标准logo的都应该尽量收集和正确的使用!   * 所有图书中涉及到的`语言/软件/社区/团队 有标准logo的都应该尽量收集和正确的使用!`

==== 截屏注意 ====
 提醒::
  1. 不要出现多余工具条,只有地址栏和页面标签就足够了
  1. 尽量截取小的面积,将关键信息点包含就成,可以调节窗口大小,甚至使用 Ctrl+- 来缩小字体,,,
  1. 所有命令行相关的截屏，要统一字体和颜色(同前建议),同时[http://code.google.com/p/openbookproject/issues/detail?id=843 Issue 843~Shell前导字串问题]:
    1. 演示要点时,都是 `~$ ls -lR ` 类似
    1. 演示故事代码运行时, 都在 `~/LovelyPython$ `之后
     * ''将SVN相关目录，链接过来就好''
    1. 注意,都应该有个空格前导

 Bash配置::
{{{
# Ubuntu 中 ~/.bashrc
case "$TERM" in
xterm-color)
    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
    ;;
*)
    PS1='${debian_chroot:+($debian_chroot)}\w\$ '
    ;;
esac
}}}

 字体配置::
  命令行中的:
attachment:cfg-font4shell.png
  浏览器中的:
attachment:cfg-font4firefox.png
  桌面中的:
attachment:cfg-font4desktop.png
  系统中的:
{{{
#Ubuntu 8.04 是 /etc/fonts/conf.avail/69-language-selector-zh-cn.conf
<fontconfig>
 <match target="pattern">
  <test qual="any" name="family">
   <string>serif</string>
  </test>
  <edit name="family" mode="prepend" binding="strong">
   <string>Monaco</string>
   <string>Vera Sans YuanTi Mono</string>
   <string>WenQuanYi Zen Hei</string>
...
 <match target="pattern">
  <test qual="any" name="family">
   <string>sans-serif</string>
  </test>
  <edit name="family" mode="prepend" binding="strong">
                        <string>Monaco</string>
                        <string>Vera Sans YuanTi Mono</string>
                        <string>WenQuanYi Zen Hei</string>
...

 <match target="pattern">
  <test qual="any" name="family">
   <string>monospace</string>
  </test>
  <edit name="family" mode="prepend" binding="strong">
                        <string>Monaco</string>
                        <string>Vera Sans YuanTi Mono</string>
                        <string>WenQuanYi Zen Hei</string>
...

}}}

==== 链接注意 ====
`为了读者输入网址的方便，建议`:
 * 所有外部URL 都配合提供 压缩后的短访问地址,
 * 例如:
{{{
Rockety 的Karrigell 使用体验,
访问地址:http://wiki.woodpecker.org.cn/moin/RocketyKarrigell
精巧地址:http://bit.ly/3wEwn3
or http://tinyurl.com/4qz4ab
,,,
}}}

 URL 压缩服务::
  * http://bit.ly/
  * http://tinyurl.com/
  * 都有快捷JS 工具,使用效果如下:
attachment:usage-bit.ly.png attachment:usage-tinyurl.png
   * 从使用速度看,推荐使用 http://bit.ly/
Line 122: Line 263:
== 排版意见 ==
 * '''[:/LayoutDiscuss:图书排版效果讨论]'''

= 进度 =
{{{
[email protected]>
to [email protected]
cc zeuux-press <[email protected]>
date Mon, Jun 2, 2008 at 10:31 PM
subject Re: [zeuux-press] [OBP:2367] Re: [LovelyPy]成书进度+TOC
}}}
关于LovelyPython的作者们，最近似乎都没什么动静么～

因为看到PCS中还有很多一部分没完成，前部分的PCS0～7及PCS100~199很多都有现成素材，所以想问下能否直接用这些素材，能的话就可以快速完成，LP的作者们感兴趣的话就一起编写吧，似乎时间不多了。我大概找了下wiki上的资源，如下：
{{{
+-- 环境篇 (运行Python 的最基础 PCS 0~10)
  | +-- PCS0 如何安装Python ok
  | +-- PCS1 交互环境之命令行 ok
  | +-- PCS2 交互环境之iPython ok
  | +-- PCS3 交互环境之winpy？
  | +-- PCS4 常用自省 http://www.woodpecker.org.cn:9081/doc/abyteofpython_cn/chinese/ch07s07.html
  | +-- PCS5 Python脚本文件
  | +-- PCS6 Python与中文 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/CDay-1
  | `-- PCS7 Python编码规范 http://wiki.woodpecker.org.cn/moin/PythonCodingRule
  +-- 语法篇 (Python 的基础实用语法 PCS 100~199)
  | +-- PCS100 import http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-6-model
  | +-- PCS101 内建数据类型 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-2-data
  | +-- PCS102 for 循环 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-3-process ／ http://wiki.woodpecker.org.cn/moin/PyAbsolutelyZipManual
  | +-- PCS103 缩进 http://www.woodpecker.org.cn:9081/doc/abyteofpython_cn/chinese/ch04s09.html
  | +-- PCS104 注释 http://wiki.woodpecker.org.cn/moin/CodeCommentingRule
  | +-- PCS105 对象 http://www.woodpecker.org.cn:9081/doc/abyteofpython_cn/chinese/ch04s07.html
  | +-- PCS106 文件对象
  | +-- PCS107 字串格式化 http://www.woodpecker.org.cn/diveintopython/native_data_types/formatting_strings.html
  | +-- PCS108 函式 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-4-func
  | +-- PCS109 系统参数
  | +-- PCS110 逻辑分支 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-3-process ／ http://wiki.woodpecker.org.cn/moin/PyAbsolutelyZipManual
  | +-- PCS111 类 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-5-object
  | +-- PCS112 判别式(动态)
  | +-- PCS113 异常 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython/LpyQLearn-3-process ／ http://wiki.woodpecker.org.cn/moin/PyAbsolutelyZipManual
  | +-- PCS114 交互参数
  | `-- PCS115 FP初体验

   +-- 模块篇 (Python 的常用模块介绍 PCS 200~299)
  | +-- PCS200 os(.stat;.path) ok
  | +-- PCS201 cmd 在.../openbookproject/PyStandardLib_zh/multiPages/moin
  | +-- PCS202 chardet
  | +-- PCS203 epydoc
  | +-- PCS204 ConfigParser ok
  | +-- PCS205 内建函式(enumerate) ok
  | +-- PCS206 thread
  | +-- PCS207 threading ok
  | +-- PCS208 dict4ini ok
  | +-- PCS209 fnmatch ok
  | +-- PCS210 pickle ok
  | +-- PCS211 base64 ok
  | +-- PCS212 shutil ok
  | +-- PCS213 time ok
  | `-- PCS214 ElementTree ok
  +-- 框架篇 (Python 的应用框架介绍 PCS 300~399)
  | +-- PCS300 CherryPy ok
  | +-- PCS301 Karrigell ok
  | +-- PCS302 Web.py ok
  | +-- PCS303 web2py ok
  | +-- PCS304 Django ok

  | +-- PCS305 TurboGears
  | +-- PCS306 PyLons
  | +-- PCS307 Quixote
  | +-- PCS308 Zope
  | `-- PCS310 LEO
}}}
未标注的是没找到的，其中模块篇似乎很多都在PyStandardLib_zh/multiPages/moin中有相应内容。
加油了，everybody！

TableOfContents

Include(ZPyUGnav)

ACL

#acl LovPyBookGroup:read,write,delete,revert All:

  • 交付后,所有章节的正文将使用以上ACL进行封闭,6个月后恢复,以便支持图书的销售,,,

可爱的Python编辑约定

愿: 2008-05-04 青年节前必须完成所有撰写工作!

再愿: 2008-06-15 前必须完成所有撰写工作!

再期愿: 2008-09-01 前必须完成所有内容撰写工作!

不得不愿: 2008-11-11 光棍节 前可以见到全部排版小样!

终于可以愿: 2008-12-31 元旦节 前可以见到全部排版小样!

终于再次发愿: [http://groups.google.com/group/openbookproject/browse_thread/thread/8eb3c13c646546d3# Fwd: 与两位老师协商《可爱的Python》页码压缩事宜] - OpenBookProject | Google 网上论坛 可以顺利完成

排版调整页数

文前内容~
 哲思社区总序 2页
 推荐序  1页+背白
 序     2页
 前言 4页
~~~~~~~~~~~~~~~~~~~~~
合计          8页
~~~~~~~~~~~~~~~~~~~~~
正文内容~
CDays内容     78页（包括一个背白）
KDays内容     72页
PCS内容       261页（其中PCS304应该是34页）
~~~~~~~~~~~~~~~~~~~~~
合计          411页
~~~~~~~~~~~~~~~~~~~~~
文后内容~
 附录总言         1页
 术语索引         15页+背白
 行者箴言         17页+背白
 跋             z序(4页)+15页(包含谢序和后记故事) = 19页+背白 最多15页
~~~~~~~~~~~~~~~~~~~~~
合计             55页
~~~~~~~~~~~~~~~~~~~~~
总计             474页

编辑分析

感谢新摧生婆的认真:

改进对策

根据过往的修订,和几届编辑的沟通,基本清楚了

技术入门图书的要点
  1. 中心内容明确
  2. 整体内容足够
  3. 各章内容完备
可爱的Python成书要求
  1. 以实例故事为核心,展示社区体验,传达 Pythonic 思想
  2. 选择和统一体例后半的 作弊条 形成呼应
  3. 使用边条和书眉,将前后内容统一起来

故事图谱

[:/StoryMapping:故事图谱图例设计和约定]

追加书眉

建议根据[http://www.douban.com/subject/1395497/ MIND HACKS] 的设计给图书的3大部分追加书眉

CDay*

  • 将原先的 PyDays 修订成 CDay ~ 光盘故事

  • 每天的进度故事 使用统一的 CDay* 来标定,以便其它章节统一使用

KSay*

  • 将原先的 KsDays 修订成 KDay ~ Karrigell故事

  • 每天的进度故事 使用统一的 KDay* 来标定,以便其它章节统一使用

PCS*

  • Python Cheat Sheet ~ Python 作弊条

  • 将Py初学者作弊条汇集;常见任务处理;Py2.5 绝对简明手册 合成为 Python 作弊条!

  • 根据前述两个实例故事 的内容,选择相关知识点,统一体例成 PCS* 来标定,以便其它章节统一使用

  • 建议由 清风和张沋鹏協同快速完成; 并特邀 现在 ZEUUX 成员的前博文编辑,方舟掺合!

  • 同时参考好书 [http://www.lightbird.net/py-by-example/ Python by Example]

图例追加

似在故事各个章节尾部追加 内容图谱 标定出读者在整个图书内容的阅读位置

CDay-5

  • attachment:LovPy-CDays-5.png

CDay-4

  • attachment:LovPy-CDays-4.png

体例追加

为将实例故事中涉及知识点在不打断叙述的前提下进行友好提示,约定以下行文体例:

{{{详细:: 表示以下内容出现在边条中 将涉及内容指向后面的 PCS* 请编辑设计明确的图标来引导 }}}

{{{注意:: 表示以下内容出现在边条中 包含警告事项,可能涉及内容会指向后面的 PCS* 请编辑设计明确的图标来引导 }}}

{{{脚注:: 表示以下内容出现在脚注中 包含题外的信息，笔者心路，等等和正文有关， 但是不直接的信息 请编辑设计明确的图标来引导 }}}

附图约定

Include(/AttaPicName,,from="^##startInc$",to="^##endInc$")

行文效果

所有代码已经执行的命令行效果将使用文本方式罗列!

字体建议
颜色建议

   1 # coding : utf-8
   2 import os
   3 export = []
   4 for root, dirs, files in os.walk('/media/cdrom0'):
   5     export.append("\n %s;%s;%s" % (root,dirs,files))
   6 open('mycd2.cdc', 'w').write(''.join(export))
  • attachment:ipy-effect0.png
  • attachment:ipy-effect1.png
图标建议

  • 所有图书中涉及到的语言/软件/社区/团队 有标准logo的都应该尽量收集和正确的使用!

截屏注意

提醒
  1. 不要出现多余工具条,只有地址栏和页面标签就足够了
  2. 尽量截取小的面积,将关键信息点包含就成,可以调节窗口大小,甚至使用 Ctrl+- 来缩小字体,,,

  3. 所有命令行相关的截屏，要统一字体和颜色(同前建议),同时[http://code.google.com/p/openbookproject/issues/detail?id=843 Issue 843~Shell前导字串问题]:

    1. 演示要点时,都是 ~$ ls -lR  类似

    2. 演示故事代码运行时, 都在 ~/LovelyPython$ 之后

      • 将SVN相关目录，链接过来就好

    3. 注意,都应该有个空格前导
Bash配置

# Ubuntu 中 ~/.bashrc
case "$TERM" in
xterm-color)
    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
    ;;
*)
    PS1='${debian_chroot:+($debian_chroot)}\w\$ '
    ;;
esac
字体配置
  • 命令行中的:

attachment:cfg-font4shell.png

  • 浏览器中的:

attachment:cfg-font4firefox.png

  • 桌面中的:

attachment:cfg-font4desktop.png

  • 系统中的: 

#Ubuntu 8.04 是 /etc/fonts/conf.avail/69-language-selector-zh-cn.conf
<fontconfig>
        <match target="pattern">
                <test qual="any" name="family">
                        <string>serif</string>
                </test>
                <edit name="family" mode="prepend" binding="strong">
                        <string>Monaco</string>
                        <string>Vera Sans YuanTi Mono</string>
                        <string>WenQuanYi Zen Hei</string>
...
        <match target="pattern">
                <test qual="any" name="family">
                        <string>sans-serif</string>
                </test>
                <edit name="family" mode="prepend" binding="strong">
                        <string>Monaco</string>
                        <string>Vera Sans YuanTi Mono</string>
                        <string>WenQuanYi Zen Hei</string>
...

        <match target="pattern">
                <test qual="any" name="family">
                        <string>monospace</string>
                </test>
                <edit name="family" mode="prepend" binding="strong">
                        <string>Monaco</string>
                        <string>Vera Sans YuanTi Mono</string>
                        <string>WenQuanYi Zen Hei</string>
...

链接注意

为了读者输入网址的方便，建议:

  • 所有外部URL 都配合提供 压缩后的短访问地址,
  • 例如: 

Rockety 的Karrigell 使用体验,
访问地址:http://wiki.woodpecker.org.cn/moin/RocketyKarrigell
精巧地址:http://bit.ly/3wEwn3 
or http://tinyurl.com/4qz4ab
,,,
URL 压缩服务

attachment:usage-bit.ly.png attachment:usage-tinyurl.png

目录调整

Include(/TreeOfBook,,from="^##startInc$",to="^##endInc$")

反馈

创建 by -- ZoomQuiet [DateTime(2008-03-30T14:01:36Z)]

PageComment2

[:/PageCommentData:PageCommentData]

ObpLovelyPyEditorRule (last edited 2009-12-25 07:15:19 by localhost)