代码清单与预格式化文本-IBM.doc

使用 IBM developerWorks Word 模板 欢迎使用 Word 模板进行 developerWorks 文章创作。您可以使用这个模板去创建一篇新的文章，或者把您已经写好的文章做一个整理发送给 developerWorks。 文章和教程在 developerWorks 上是以 HTML 格式发布的，但其生成的格式是 XML (Extensible Markup Language)。developerWorks 的编辑具有将 Microsoft Word 和 OpenO Writer 文件转换为 XML 源格式的工具。转换成 XML 成功与否取决于所提交的 Word 或 Writer 文档是否严格遵从所使用模板的指导原则。在发布之前，XML 源文件将会依照 developerWorks schema 进行验证，并使用 XSLT (Extensible Stylesheet Language for Transformations) 样式表被转换成为 HTML 格式。这个过程可以将文章的内容与表现形式分开处理，加快网站管理的效率。 您的 Word 文档在发布之前将会被转换为 XML 格式。本模板提供了您可能会遇到的各种情况的示例。如果您仔细阅读并遵循本文档的示例，将会极大的帮助这个转换过程。请注意下面几个要点： 保持文章布局的简单。固然在字处理软件中可以实现复杂的布局，但复杂的布局可能会导致转换有问题； 应该使用样式（标题 1、标题 2 等）去标明文章的章节标题，而不是简单的改变标题的字体大小和加粗； 使用软件的工具栏去创建项目列表和数字列表，不要自己输入列表中的数字。 使用本模板最好的办法是下面几个简单的步骤： 打开模板时，按照提示输入被问到的内容。完成后把模板保存为一个普通的文档（.doc）。您不用担心按提示输入的文字的正确性，因为在后面您还可以去修改它们； 按照说明添加自己的内容； 准备提交之前，移除本文中的说明性文字。 这样就可以了。 如果您已经熟悉样式的使用，请直接阅读 “样式 (styles) 使用小结“。否则请阅读下面的说明。 使用样式 (styles) 样式 (Styles) 是组织文档结构的有力工具。段落样式 (paragraph style) 可以被应用到整个段落，在设置了字符样式 (character style) 的地方，段落样式将被覆盖掉。大多数文本都将是正文 (Normal) 样式。如果您使用的是 OpenO Writer，那么将有可能是默认 (Default) 样式。如果要显示 Word 中的“样式和格式”侧栏，请点击格式 (Format)，接着选择样式和格式 (Styles and Formatting)。光标所处的位置是何样式可以从工具栏中的窗口看到。在这个窗口中，您可以通过点击样式的名称为文本指定新的样式，如图 1 所示。 图 1. 应用标题 1 样式  如果您在进行上述操作之前已经选定了一部分文本，那么您所选择的样式将应用到这部分文本上。如果您没有选中文本，那么新的样式将应用到您即将输入的文本上。现在您已经了解了如何设置样式，接下来我们看一看在 developerWorks 投稿中将会用到哪些样式。 章标题 (major headings) 和节标题 (minor headings) 章标题 (major headings) 从逻辑上将您的文章分为一个一个部分，我们在这里把这些段落称为章 (major sections)。章标题使用的样式是标题 1 (Heading 1)，就像本段文字上方的“章标题 (major headings) 和节标题 (minor headings)”所使用的样式一样（在中文版的 Word 中，标题 1 和标题 1 + (中文) 宋体等样式是等价的）。您可以点击上面的标题，看一看它的样式。如果您打开 Word 的文档结构图，那么您可以在左边看到每一个标题，这样可以帮助您在文章中快速导航。在使用标题的时候，最好使用短小精悍的标题，不要使用冗长的文字作为章节标题。 本模板会利用到章标题，在最终转换出来的 HTML 文章中起到导航的作用。您也没有必要刻意使用很短的文字作为章节标题，请放心选用您认为最切合内容的文字作为章节标题。 在每章当中，您可能会把内容分成若干个段落，在段落中会包含插图、表格和代码清单。段落正文的样式应该设置为正文（在 Word 中）或默认（在 OpenO Writer 中）。有一些其它的样式和正文/默认是等价的，如 Word 中的正文文本样式。通常，当您新建一个空文档时的样式就是我们可接受的样式，除非您对您的编辑器作了复杂的定制。 节标题 (minor headings) 如果某些章很长，那么您可以把