写作IT书时的一些注意事项及参考

1137389296

写作注意事项（第一版）
说明：作为第一次写作的新手，在目录调整和写作的前期过程中，请您尽量抽空与策划编辑保持沟通和联络，这是一个双向的过程，有助于编辑了解您的技术特长、写作风格，从而进行“量体裁衣”，同时也有助于您了解出版的流程和操作，有效写作。在这个阶段的充分沟通，将为下一阶段的工作打下重要基础。沟通，沟通，永远都不够！
（一）目录撰写注意事项
  1、 请以明显的分级目录来撰写，即篇、章、节
2、请为各级目录顺次编号，如1.1节、1.2节等
3、目录格式请提交两份，一份是EXCEL版的（分别是章名和章节介绍），模版请参考附件1，一份是WORD版的，请见附件2的模版，它是一个简单的排版
（二）WORD文内格式方面的注意事项
1.  项目符号使用默认风格且全书统一。例如
  FLEX开发1
  FLEX开发2
2、所有的代码和英文尽量避免使用宋体和其它英文字体，建议使用Times New Roman字体。如果使用了宋体，建议使用Word的字体替换功能进行统一替换
3、每一段落开头要空两个格（可通过简单的按一下TAB键来产生两个空格）
4、代码不要用颜色，一般采用黑白印刷
5、表、图的编号统一为1.1或1-1，但不能两种风格混用
6、例子的标题和编号要统一，风格保持与表、图的式样一致
7、图在正文中使用“如图X.X所示”或者在图的下面使用“图X.X”。
  图的编号不再下放到节和小节，只下到章。比如，第一章的第30个图（不管这个图出现在第一章的第几节中），全部可用“如图1.30所示”来表示。
（三）内容方面的注意事项
1.  在写作的二级目录和三级目录之间（包括三级目录和四级目录之间），最好有些承上启下的言语，例如，简单总结一下前面的内容，为下面的阅读进行提示等。这会使读者的阅读更自然和流畅
2、对于实例的内容，应尽可能的给出解释，说明它的功能、应用范围、实现的思路等
3、复杂的代码需要给出详细的注释，所谓复杂，是初学者无法一言看出意思的。同时，策划编辑会在田间管理过程与您商议，但您在写作时，应该尽可能把自己认为较复杂的代码作出注释（当然，这个“复杂”也因人而异）
4、对于很重要的项目开发案例，除了代码注释外，还应该把拿出来点评和剖析。这样做，可以把本书的使用价值和光辉，尽可能的挖掘出来
5、我们的书虽然是讲技术的，但您可以把它当成一部小说，要有情节，有起伏，有高潮，有各种铺垫，所以每一部分的写作，所以在各部分之间，像如引子和发展阶段，要给予读者适当的引导，尽量使学习曲线更加平滑（这一写作理念，策划编辑将会在田间管理阶段，与您反复的沟通）
（四）关于抓图和图片处理的一些技巧
1、不要缩图-----图抓下来时多大，就原封不动的放入Word中，千万不要用图像处理软件把图缩小后再放入Word，那样会严重导致图片的分辨率下降，印刷的时候，也极有可能会模糊不清（我们的美编后期将为您提供一些建议）
2、图要抓得精心，尽量显得整齐，干净，别给人乱糟糟的感觉。
3、对于需要在图片上作图解的，包括在图片上添加标注、箭头和文字等的，可采用下面方法，把原始图片插入到Word中后，用Word的作图工具来自行添加标注、箭头和文字
4、图片建议最好使用GIF格式
（五）写作内容的多和少把握
1、在第一次写作时，强烈建议您将所知的全部呈现出来，这样策划编辑可以理解你能写多少，写到什么程度，从而根据读者的需求和对市场的把握，来调整您的书稿。这会为书稿的调整留下很好的弹性空间
2、对于技术细节的展开，建议在一开始写一个自己最熟悉、最擅长写的实例，交给策划编辑，策划编辑在与您共同讨论后，将会把它发展成一个模版，指导您的其它技术细节实例
3、在目录调整完毕后，根据市场上同类书的情况的技术发展的情况，可能会动态的对原有内容进行增加或者删除，因此，你在写作时，对于内容要有“模块化”的概念。让本书的内容成为一个可以自由组合的机体

（以上为第一版，随着田间管理和目录调整的展开，本说明将会不断补充）