##language:zh #pragma section-numbers off ##含有章节索引导航的 ZPyUG 文章通用模板 <> ## 默许导航,请保留 <> 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 网上论坛^ 可以顺利完成 `终成正果！` * 2009-09-13 在互动网9周年庆生会进行发售宣传！ == 排版调整页数 == {{{ 文前内容~ 哲思社区总序 2页 推荐序 1页+背白 序 2页 前言 4页 ~~~~~~~~~~~~~~~~~~~~~ 合计 8页 ~~~~~~~~~~~~~~~~~~~~~ 正文内容~ CDays内容 78页（包括一个背白） KDays内容 72页 PCS内容 261页（其中PCS304应该是34页） ~~~~~~~~~~~~~~~~~~~~~ 合计 411页 ~~~~~~~~~~~~~~~~~~~~~ 文后内容~ 附录总言 1页 术语索引 15页+背白 行者箴言 17页+背白 跋 z序(4页)+15页(包含谢序和后记故事) = 19页+背白 最多15页 ~~~~~~~~~~~~~~~~~~~~~ 合计 55页 ~~~~~~~~~~~~~~~~~~~~~ 总计 474页 }}} ##startInc == 编辑分析 == 感谢新摧生婆的认真: * [[http://docs.google.com/Doc?id=ah9sz7kfxfhz_272b9rvdk|图书体例分析报告]] * [[http://docs.google.com/Doc?id=ah9sz7kfxfhz_30cv8mt6hm|回复080222 ZoomQuiet编辑意见]] * [[http://docs.google.com/Doc?id=ah9sz7kfxfhz_34gqzhwcgt|-5 PyDay 初体验和原始需求修改版]] 排版意见:: 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]] == 改进对策 == 根据过往的修订,和几届编辑的沟通,基本清楚了 技术入门图书的要点:: 1. 中心内容明确 1. 整体内容足够 1. 各章内容完备 可爱的Python成书要求:: 1. 以实例故事为核心,展示社区体验,传达 Pythonic 思想 1. 选择和统一体例后半的 作弊条 形成呼应 1. 使用边条和书眉,将前后内容统一起来 ==== 故事图谱 ==== '''[[/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*` 请编辑设计明确的图标来引导 }}} {{{脚注:: 表示以下内容出现在脚注中 包含题外的信息，笔者心路，等等和正文有关， 但是不直接的信息 请编辑设计明确的图标来引导 }}} === 附图约定 === <> === 行文效果 === 所有代码已经执行的命令行效果将使用文本方式罗列! 字体建议:: * 文字使用圆体 比如说:`Vera Sans YuanTi Mono` * 数字字母使用: Monaco * 保证数字和字母，以及中文标点和代码标点有巨大的差异 * 特别是 `0` vs `Oo`; `I` vs `l` * 参考资料: * [[http://www.2maomao.com/blog/best-programmer-fonts/|程序员最喜欢用的编程字体]] * [[http://www.osxcn.com/ubuntu/heiti-contrast.html|常见黑体显示效果对比 - Nicky's blog]] 颜色建议:: {{{#!python # coding : utf-8 import os export = [] for root, dirs, files in os.walk('/media/cdrom0'): export.append("\n %s;%s;%s" % (root,dirs,files)) open('mycd2.cdc', 'w').write(''.join(export)) }}} * {{attachment:ipy-effect0.png}} * {{attachment:ipy-effect1.png}} 图标建议:: * 所有图书中涉及到的`语言/软件/社区/团队 有标准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 serif Monaco Vera Sans YuanTi Mono WenQuanYi Zen Hei ... sans-serif Monaco Vera Sans YuanTi Mono WenQuanYi Zen Hei ... monospace Monaco Vera Sans YuanTi Mono WenQuanYi Zen Hei ... }}} ==== 链接注意 ==== `为了读者输入网址的方便，建议`: * 所有外部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/ == 目录调整 == <> ##endInc ---- '''反馈''' 创建 by -- ZoomQuiet [<>]