O’Reilly Cookbook系列图书体例分析

O’Reilly Cookbook系列图书体例分析

.

相关文章推荐：<o:p></o:p>

1.       O’Reilly In a Nutshell系列图书体例分析<o:p></o:p>

2.       O’Reilly 08年1月计算机新书点评<o:p></o:p>

3.       Pragmatic 08年1月计算机新书点评<o:p></o:p>

4.       为什么翻译类计算机图书的质量这样差<o:p></o:p>

一、摘  要

本文旨在分析O’REILLY Cookbook系列图书的体例特征，力图找出Cookbook系图书的体例特征和内容组织特点，从而为国内同体例类图书的写作（组织内容的形式和方法）提供参考依据。
 二、Cookbook系列图书概述

1. 读者定位

Cookbook系列图书面向的主要读者具有如下特征：
（1）对书中所涉及的技术有一定了解的初级读者这类读者对书中的技术略有了解，但是不够系统和深入。Cookbook系列图书虽然是以知识点贯穿在一起的，但是还是比较系统的。
（2） 缺乏实践经验或实践经验还不足的中初级读者由于缺乏实践经验，所以在解决某些实际问题（尤其是那些略带一点技巧的问题）时往往会遇到困难，Cookbook系列图书针对一些具体问题给出了解决方案，并对其中所用到的技术或技巧进行了总结。
（3）有一定实践经验的中高级读者这类读者有一定的实践经验，但是他们在该领域的知识还不够系统化，Cookbook系列图书有比较完整的知识点结构，能帮助这类读者梳理知识点。当遇到尚不熟悉的知识点时，本书还可以作为手册查阅。
 

2.主要特征
Cookbook图书的主要特征包括：
1. 定位清晰
1) 内容方面有取有舍：不全面覆盖、不曲高和寡、不针对没有基础的入门者。
2) 针对时间利用率要求较高的实践者，条目式，即查即用。

2. 结构清晰
1)单位结构上采用条目式结构，严格限制内容要素（条款的元素）。
2)总体安排上采用字典式结构，严格划分内容组织（目录按功能划分）。

3.功能清晰
1)方便搜索、查询（交叉引用、目录）。
2)速查即用，同时兼具可选读的深入分析，举一反三；

4.描述清晰
1)不罗嗦，讲求实用。
2)对所涉要点进行详尽阐述，不留虫洞。

5.划分清晰
通过严格的单位要素划分，将“可以立刻使用的部分（Best Practices的具体实现）”与“可选的扩展信息（讨论、相关信息等）”显式区别开来，免去读者“根据内容自行归纳”的负荷。

三、图书结构与内容
1.  篇章的组织
Cookbook系列图书在篇/章层次组织上具有如下特点：
1）按所涉技术在功能/机能上的分类进行严格划分比如，CSS Cookbook按照CSS机能分为Web Typography、Images、Page Elements、Lists等诸多章，Python Cookbook按照技术功能分为String、Files、Database、System Administration等诸多章。
2）优点：便于搜索查询。
3）疑似缺点：缺乏全局连贯性，知识点在全书范围内趋于离散化。

2.章内小节的组织
Cookbook系列图书在篇章内的小节组织上具有如下特点：
严格按照内容单位和单位要素进行组织（显式离散化）以条目（item/recipe）形式为内容单位（Recipe），严密围绕篇章主题阐述知识点。
内容单位内部，严格划分单位要素（Problem/Solution/Discussion/See Also），将知识点各个阐述逻辑分支明确划分。
各个离散化的内容单位之间，以及书内外形成知识关联（交叉引用）对于内容单位中的知识点，作者从内容的相似性、连贯性、可比性等方面给出了交叉引用。
a.内容相似性：知识点的知识来源，方法上类似或者是派生的知识点。
b.内容连贯性：某些Best Practices/实践流程中经常会同时施用的知识点。
c.内容可比性：从某些侧面或部分具有一定比较意义的知识点。
内容单位内部各个离散化的单位要素之间形成简单、清晰的关系。4个单位要素Problem、Solution、Discussion、See Also形成因果关系、接续关系。典型的“案例（case）”模式（罗列要点，逐个阐述），而非“情节（drama）”模式（分隔相对模糊，连贯性、整体性强）

3. 内容安排
内容单位：Recipe（即关于知识点的条目）
要素单位：每个Recipe包括4个要素单位
（1）Problem
用尽量简洁的语言，清晰地描述问题，一般非常短小。
（2） Solution
直接给出问题的解法，并进行精辟地解释或分析。
（3）Discussion
围绕问题的解法作进一步的讨论，讨论内容可能包括：
1)替代方案；
2)与替代方案的比较和对替代方案的分析；
3)澄清常见的不妥或错误解法和观念；
4) 常见的相关疑惑；
5)特定解法的优缺点；
6) 相关的经验性注意事项；
7) 相同问题域或技术范围中，在纵向或横向上有关联的知识点。
（4）See Also
一般是按内容关联性进行交叉引用，包括：
1) 参考资料；
2) 类似问题的资源；
3)同问题域或技术范围中，在纵向或横向上有关联的知识点。

四、 细部结构分析
 1.组织结构
Cookbook系列在组织结构上保持高度的条理性和一致性，严格按照内容单位进行规划，这样做便于读者进行快速搜索和快速查询。

2. 描述粒度
Cookbook系列对知识点的描述粒度具有如下特征：
（1）通常限制在相对比较小的技术技巧的规模上；
（2）每个内容单位只描述一个相对独立的知识点，只涵盖最直接相关的变体，不直接覆盖间接相关的知识点；
（3）具有间接的内容关联性的知识点被分隔到不同的内容单位中，以便使内容单位的知识承载负荷保持在相对比较轻量级的规模。
比如，Python Cookbook 2/e 中，“Reading from a File”与“Writing to a File”被作为两个知识点放在不同的内容单位中（Recipe 2.1和Recipe 2.2），“字符转数值代码”与“数值代码转字符”被作为一个知识点“Recipe 1.2 Converting Between Characters and Numeric Codes”。）
 

五、总结
Cookbook系列图书是经过深入调研，通过严格的体例设计和精细的内容安排，充分挖掘了市场定位和目标读者的根本需求，在图书体例上具有创新性和突破性。对实用性功能的精良实现使其获得了极高的认可度。