当前位置：首页 > 范文大全 > 实用文>在Eclipse中构建DocBook XML

在Eclipse中构建DocBook XML

2022-05-29 05:44:49 收藏本文下载本文

“粗去玩”通过精心收集，向本站投稿了10篇在Eclipse中构建DocBook XML，以下是小编整理后的在Eclipse中构建DocBook XML，希望你喜欢，也可以帮助到您，欢迎分享！

篇1：在Eclipse中构建DocBook XML

入门

本文将演示如何结合使用 DocBook XML 和 Eclipse 集成开发环境 (IDE)，创建以多种格式轻松分发的可重用技术文档，DocBook XML 是标准 XML 标记库，使用它可以编写用于生成几乎所有输出的样式表。但是，由于 DocBook 已经存在近10 年，因此已经编写了许多样式表来生成许多类型的文档，包括 HTML、文本、PDF 和手册。

读完本文后，您应当能够使用 DocBook XML 创建可生成为 HTML 格式的文档，并可用于 Eclipse 帮助插件及来自单个 XML 源文件的 PDF。您应当具备一定的 XML 使用知识，还应当能够使用 Eclipse 和 Apache Ant，包括从 Eclipse IDE 运行 Ant 构建文件。您需要使用 Eclipse V3.2 或更高版本、DocBook XML V4.x 文档类型定义（Document Type Definition，DTD）、DocBook XSL 样式表、Apache Xalan-Java™ 和（可选）Apache FOP（要获得下载，请参阅参考资料）。

DocBook XML 概览

DocBook XML 是适于编写文档的 XML 标记库。DocBook 中的众多可用标记使它成为构建技术文档的最佳选择。由于 DocBook 是 XML，因此可以使用样式表将其转换为多种不同的输出格式，而样式表使 DocBook XML 成为一次性编写技术文档并以各种格式生成技术文档的最佳选择。

注：本文中的这些代码都是使用 DocBook XML V4.5 开发的；在撰写本文时，V5.0 正处于预发布状态。

高级元素

表 1 显示的元素常用作 DocBook XML 文件的高级元素。

表 1. 顶级 DocBook XML 元素

元素说明 book包含许多其他元素；惟一的高级元素是 chapter书的一部分 article一篇文章，也可包含在书中

内容元素

在较高级元素内，可能需要添加实际内容 —— 段落、表、列表、代码样例等。表 2 列出了向书、章节或文章中添加内容时所使用的一些常见元素。

表 2. 元素

元素说明 caution包含敬告读者操作可能导致数据丢失、硬件损坏或软件问题的文本 code包含内联代码，例如 this example包含带有标题的代码示例 important包含可能对读者十分重要的文本 itemizedlist具有可选的要点句（bullet point）的条目列表 note包含提请读者特别注意的文本 orderedlist编号条目列表；您不必在构建时为列表编号 —— 样式表将为您执行该操作 para文本段落或文本块 table文本表或数据表 tip包含用于为读者提供建议的文本 title与元素相关的标题

下面显示的示例文档中，其中的书至少包含了表 2 中列出的每个元素的其中一个。

清单 1. 基本 DocBook XML 示例

“www.oasis-open.org/docbook/xml/4.5/docbookx.dtd”>

My Example Book

Example

Nathan

Good

Required Preface

You will like my book (I think).

Your First Chapter

You must include at least one chapter in your book.

Here is another paragraph.

This is some really important text.

Look both ways before crossing the street!

Liberal use of new in loops can cause performance issues!

Example 1

String something = “Something”;

当文件生成为 HTML 并呈现到浏览器中后，它将类似图 1：

图 1. 转换成 HTML 并在浏览器中呈现后的清单 1 代码

完全介绍每个可用的 DocBook XML 标记最好留给参考手册来完成；指向这些参考手册的 HTML 版本的链接可在参考资料中获得。同样可以找到有关 DocBook XML 的书籍。表 2 中列出的标记将给您提供一个良好的开端，但是更多标记可用于屏幕快照、命令提示符、用户输入、商标和引号等。

设置环境

您必须使用工具来执行可扩展样式表转换语言（Extensible Stylesheet Transformation Language，XSLT）转换，以及使用 XSL 样式表把 DocBook XML 转换为 HTML 或 PDF 等您认为更有用的格式。如果您构建了自己私有的 XML，则还必须编写您自己的样式表。但是，使用 DocBook XML 等已建立的格式将允许您使用其他人已经编写的样式表。要使用预编写的样式表，请下载这些样式表（请参阅参考资料）。在撰写本文时，适用于 DocBook XML V4.5 的一组样式表是 DocBook XSL V1.72.0。

获得样式表

包含 DocBook XSL（例如，docbook-xsl-1.72.0.zip）的已下载的归档文件包括按照生成的输出类型组织到不同目录中的样式表。html 目录包括输出 HTML 的样式表；fo 目录包括生成格式化对象（Formatting Object，FO）格式文件的样式表，等等。

下载归档文件并将其保存到便于记忆的位置。不需要把文件从归档文件中解压缩出来 —— 您可以直接把它们导入 Eclipse。

使用 Xalan

在本文中，我使用 Xalan 作为 XSLT 处理器。在将 Xalan 与 Eclipse 附带的 Ant 版本结合使用时会有一个问题：版本太低并且在尝试处理 XSL 时会遇到问题。

Xalan 是可用作两个子项目 Xalan C++ 和 Xalan-Java 的 Apache 项目。下载 Xalan-Java（如果计算机上还没有）。下载完文件后，请将其保存到便于记忆的位置。像包含样式表的归档文件一样，仍然不要解压缩文件的内容。

创建 Eclipse 项目

到目前为止，您已经看到了一些样例文件，并且应当已经下载了最新版本的 DocBook XSL 样式表，以及最新版本的 Xalan（如果以前没有的话）。您还应当已经下载了 DocBook XML 模式文件。归档文件（例如，docbook-xsl-1.72.0.zip、xalan-j_2_7_0_bin-2jars.zip 和 docbook-xml-4.5.zip）应当被保存到便于查找的位置。

下载并保存了所有归档文件后，您已经准备好启动 Eclipse 以创建新项目，并编辑把 DocBook XML 转换为不同格式的 DocBook XML 和 Ant 脚本。

在 Eclipse 启动后，通过选择 File > New > Project 创建新项目。在 General 下，单击常见的 Project，然后单击 Next。在键入项目的名称之后，单击 Finish，在工作区中创建新项目。

从归档中导入文件

既然已经在 Eclipse 中创建了新项目，那么接下来导入构建 DocBook XML 要使用的文件。

导入 DTD 文件

首先，导入 DocBook XML DTD 文件。选择 File > Import，如下所示，然后，在 General 类别中，选择 Archive File。当 Import Wizard 显示时，单击 Browse 以打开可用于定位 DocBook XML DTD 归档文件（例如 docbook-xml-4.5.zip）的文件浏览器。

图 2. 从归档文件导入

在 Into folder 框中的项目名称后键入 /docbook-xml。确保选中 / 文件夹，如下所示。单击 Select All（如果尚未选中或者如果已灰显），则在完成时单击 Finish。归档内的文件将入到项目中。

图 3. 选择要导入的文件

导入 XSL 样式表

导入完 DocBook XML DTD 文件后，请遵循相同的过程导入 docbook-xsl-1.72.0.zip 文件的内容。但是，这一次您无需在 Into folder 框中的项目名称后指定文件夹名称，因为归档的内容将已经被放入项目内名为 docbook-xsl-1.72.0 的文件夹中。

既然已经导入了 XSL 样式表，接下来从在 Xalan Web 站点中下载的归档中导入所需的 Java Archive (JAR) 文件。导入其他归档文件时遵循同样的过程，但是这一次，请确保清空 docs、licenses 和 samples 目录，以便这些目录不被导入到项目中。在您清空了那些目录后，在 Into folder 框中添加 /lib，修改项目名称。

在导入需要的所有文件后，请在项目内创建另一个文件夹并将其命名为 src。这将是所有 DocBook XML 文件的基本文件夹。

到目前为止，应当在 Eclipse 中有一个包括以下文件夹的项目：

docbook-xml，包含 DocBook XML DTD

docbook-xsl-1.72.0，包含 DocBook XSL 样式表

lib，包含 Xalan JAR 文件

src，现在为空

如果项目中有了所有这些文件夹，那么您已经准备好添加 Ant build.xml 文件以运行转换过程。

编写 Ant 脚本

Ant 是基于 Java 的构建工具，它将读取 XML 脚本并且可以执行脚本中定义的很多任务。如果您不熟悉 Ant，请参阅参考资料。在本文中，您将使用 Eclipse 来启动 Ant，因此无需熟悉如何从命令行运行 Ant。此外，您也无需担心自己如何下载和安装 Ant，因为 Eclipse IDE V3.2.x 附带了 Ant。它是比当前可获得的版本低的版本 —— V1.65，相对于 V1.7 —— 但是出于本文的目的，该版本不会造成问题。

不过，Ant V1.6.5 附带的 Xalan 版本在尝试使用最新的 DocBook XSL 时看上去运行得不太好。但是如果下载和使用最新版本的 Xalan（及附带的 Xerces 版本），它应当可以正常运行。

结合使用 Xalan 与 Ant

有很多种方法可以告诉 Ant 使用特定版本的 Xalan —— 或任何其他 XSLT 处理器 —— 而不使用 Ant 附带的默认版本。其中一种方法是修改 Ant 的类路径。当您在 Eclipse IDE 内使用 Ant 时，这是十分简单的。选择 Window > Preferences 以更改 Ant/CLASSPATH 下的设置。您可以在 CLASSPATH 选项卡中删除对 Xalan 或 Xerces 的任何引用，并将其替换为已经下载的版本。

如果您是惟一要执行转换的人，则这个方法很好，因为只有您必须更改 Ant 设置才能正确进行转换。但是，如果要与团队协作，更好的方法是在目录（例如，lib）中包含 Xalan 和 Xerces JAR 文件以及项目，并修改 build.xml 文件以使用 xslt 任务的库。使用这种方法，您可以简单地将文件从源文件控件中签出或者分发并运行项目，而不更改 Eclipse IDE 设置。

下面的 Ant 构建脚本中提供了为 xslt 任务提供 JAR 文件的示例。

清单 2. 样例 Ant 脚本

This Ant build.xml file is used to transform. DocBook XML to various

description=“Generates HTML files from DocBook XML”>

basedir=“src” destdir=“${doc.dir}”>

粗体显示的

标记使您可以指定 Xalan JAR 文件的位置。

元素用于定义在整个 Ant 脚本中可以重用的路径。您还可以使用 classpath 属性或在 classpath 元素内指定路径而不是使用 refid 属性来引用路径，把 Xalan XSLT 处理器的路径指定给 xslt 目标。

xslt 目标是与 basedir、extension 和 destdir 属性结合设计，用于递归浏览文件夹并为在目录中找到的每个 XML 文件生成 HTML 文件。输出将被存储到一个文件夹中，稍后将用作后面演示的 Eclipse 插件附带的帮助文件的 HTML 源文件。

创建 build.xml 文件

通过选择 File > New >File 创建 build.xml 文件。键入 build.xml 作为文件名，然后选择项目作为文件的位置。单击 Finish 创建 Ant 文件。

您可以把清单 2 中所示的内容放入到新的构建文件中。如果选用的任何目录名称与在这里使用的目录名称不同，则可能需要调整 property 元素中的一些值以确保正常运行。

您可以直接从 Eclipse 执行 build.xml 文件，因为 Eclipse 配有内置挂钩 (hook)，可以运行 Ant 构建脚本。使用 Ant 有很多其他优点：首先，它是跨平台的，这意味着您可以在运行 Java 代码的任何操作系统上执行相同的构建脚本。另一个优点是可以不依赖于 IDE 运行这个构建脚本。因而，您可以轻松地将其整合到自动执行的构建过程中，也可以从命令行执行它。最初，我打算研究如何设定 Eclipse 属性以将 XSLT 处理器作为外部工具运行（参见 Run > External Tools），但是我为了获得这些优点而放弃了那个想法。

运行 build-html 目标

在编写了 build.xml 文件之后，您可以运行 build-html 目标。您没有任何 DocBook XML 文件，因此目标将不会做任何有用的操作。但是，运行脚本时不应当会得到任何错误。

运行 Ant 目标的最简单方法之一是在编辑器中打开构建文件的情况下从 Outline 视图运行 Ant 目标。在 Outline 视图内，右击 build-html 目标的名称，然后选择 Run As > Ant Build。来自 Ant 构建脚本的消息（如果有）将显示在 Console 视图中。

编写 DocBook XML 文件

在 Eclipse 项目中，应当有 DocBook XML DTD 文件、DocBook XSL 文件、Xalan 库，而且现在还有 build.xml 文件。此时，您拥有了开始构建 DocBook XML 文件所需的一切内容。

创建第一个 DocBook XML 文件

要在 Eclipse 中创建第一个 DocBook XML 文件，请执行以下步骤：

选择 File > New > Other，

从 XML 类别中，选择 XML，然后单击 Next。

在 Create XML File 窗口中，选择 Create XML file from a DTD file，然后单击 Next。

在 File name 框中键入 chapter1.xml，然后确保项目内的 src 文件夹已被选中，然后单击 Next。

在 Select DTD File 中，浏览到项目的 docbook-xml 文件夹中的 docbookx.dtd 文件，然后单击 Next。

当 Select Root Element 窗口显示时，请从 Root element 中选择 chapter，然后取消选中 Create first choice of required choice 复选框。

键入 -//OASIS//DTD DocBook XML V4.5//EN，然后单击 Finish。

在 XML 编辑器中使用 chapter1.xml

Eclipse 将在 XML 编辑器中打开 chapter1.xml。Eclipse 中的 XML 编辑器有两个文件视图：Design 和 Source。XML 文件的 Design 视图将以网格的形式显示文件的元素，其中，元素名称显示在左侧列中，元素的内容显示在右侧列中。您可以通过右键单击文件并选择 Add Child、Add After 或 Add Before 把新元素添加到文件中。

如果使用的是 DTD，则上下文菜单中的菜单项将限定您只能添加有效的元素。此功能使您可以确保在稍后执行转换时 XML 文件中不会有大量验证错误。

构建模块化文档

创建许多文档时，文档之间一定会有类似之处，尤其是在它们全都面向相同读者的情况下，例如大型企业或一群人。例如，如果您读过很多技术书籍，您就可能已经注意到几乎每本技术书籍都有 “本书中使用的约定” 部分或用于演示书中如何设定线索、提示、内嵌代码和代码清单格式的章节。

分割 DocBook XML 文件

使用 DocBook XML 使您能够将文档分割为多个文件，这些文件可以编译成一个单元并能够重用。例如，您可以将书中的每一个章节放入单独的 XML 文档中。然后可以在其他书中使用这些章节，或者简单地将章节分割为独立的文件以实现更轻松地维护。您还可以将这些章节包括到书并使用样式表处理它们。

清单 3 提供了构建动态包含其他 DocBook XML 文件的 DocBook XML 文档的示例。在转换过程中处理此文件时，该文件看上去 —— 这里是指 chapter1.xml —— 就是 &chap1; 所在的位置。

清单 3. 包含 chapter1.xml 的样例 book.xml 文件

“../docbook-xml/docbookx.dtd” [

]>

&chap1;

采取这种方法时有几点注意事项。首先，必须修改 chapter1.xml 文件以删除 XML 预处理指令和 DOCTYPE 元素。由于 chapter1.xml 的内容将被放到 &chap1 实体所在的位置，因此 book.xml 文件的中间将包含 XML 处理指令和 DOCTYPE 元素，会使该文件无效。

其次，如果不再需要将单独的章节文件处理成单独的 HTML 文件，则应当更新 Ant 构建脚本以避免对章节文件进行处理。幸运的是，使用 Ant 中的 xslt 任务，这项更改非常简单。xslt 任务可以包含与 Ant 中的 fileset 元素相同的元素，这意味着您可以构建一系列可以非常轻松地包含和清除文件。清单 4 显示了如何使用元素包括必要的添加内容以在处理时跳过某些文件。

清单 4. 使用 XSLT 任务包含和清除文件

description=“Generates HTML files from DocBook XML”>

basedir=“${source.dir}” destdir=“${doc.dir}”>

如果仍需要构建全部文档，可以删除上面所示的 exclude 元素。

不仅限于分割章节和书。只要是对您有意义，就可以以任何方法物理分割 DocBook XML 文件，例如将各部分单独保存在文件中。您甚至可以把书包含在 set 元素中，该元素是最高级别的 DocBook 元素。

构建帮助插件

Eclipse 框架功能强大的特性之一是可扩展性。当我看到企业使用特殊的 “企业允许的” 方法连接至数据库、事务处理或错误处理时，我总是想知道企业为什么让开发人员到工作环境外部去查找并获取文档。为什么不构建可在公司内部网中获得的相同 HTML 文档并以能够通过 IDE、索引和搜索轻松地访问到的帮助形式将其分发给开发人员？

您可以使用 Eclipse IDE 附带的模板快速创建包含 HTML 文件格式的帮助的插件项目。下几个部分将演示如何构建这个插件项目。构建插件项目后，您可以包括在 DocBook XML 项目中构建的 HTML 文件。

创建帮助插件

要创建帮助插件，请执行以下步骤：

选择 File > New > Project 以启动 New Project Wizard。

从可用向导列表的 Plug-in Development 类别中，选择 Plug-in Project，然后单击 Next。

在 Project name 框中，键入 MyHelpPlugin，然后单击 Next。

在如图 4 所示的窗口中单击 Next。

图 4. New Plug-in Project

从 Available Templates 列表中，选择 Plug-in with sample help content，然后单击 Next。

在下一个窗口中，单击 Finish。系统可能提示您切换到 Plug-in Development 透视图。如果提示，建议单击 Yes，因为透视图将自动包括在构建帮助时对您有用的视图。

新项目包含名为 html 的文件夹，并且在该文件夹中包含一些样例 HTML 文件。将用 DocBook 项目中生成的 HTML 文件替换这些文件。

查看进度

在尚未进行任何更改的情况下，选择 Run > Run As > Eclipse Application，将插件与 Eclipse 的实例结合运行以查看到目前为止帮助的内容。使用您的插件，Eclipse 的新实例将启动。在 Eclipse 启动后，选择 Help > Help Contents 以查看运行中的插件。如果没有做任何更改，则将看到 Test TOC 列于内容之中，如图 5 所示：

图 5. 内容样例表

整合 DocBook XML 项目中的 HTML

现在您已经看到了新帮助插件的默认内容，接下来该整合先前构建的 DocBook XML 项目中的 HTML 了。因此需要复制新帮助插件项目的 HTML 输出，但是您不希望每次都手动执行该操作。如果进行手动操作，则在构建插件的过程中很可能犯下错误或忘记执行该操作。

添加 Ant 文件

自动复制 HTML 文件的第一步是构建一个简单的 Ant 文件。这个 Ant 文件只将来自 DocBook XML 项目的 HTML 文件复制到插件项目的 html 文件夹中。然后，只要 Eclipse 构建项目，就会执行该 Ant 文件。

Ant 文件的内容如下所示。文件只有一个目标 —— prepare —— 它也是构建文件的默认目标。由于此构建文件实际上只适于被 Eclipse 调用，因此我把默认目标保留为 prepare。

清单 5. 插件项目中的 Ant 构建文件

Prepares the Help plug-in project by copying the HTML help files

from the DocBook XML project into this one.

定义构建器

在 Eclipse 中，您可以定义在 Eclipse 构建项目时运行的程序。这些程序被称为构建器。您可以通过单击项目名称，然后选择 Project > Properties 来修改构建器。在 Builders 下方，您将看到已经为项目设置的构建器：Java Builder、Plug-in Manifest Builder 和 Extension Point Schema Builder。要让 Eclipse 运行 Ant 脚本把 HTML 文件复制到插件项目中，请执行以下步骤：

在 Builders 属性页面中单击 New。

从列表中选择 Ant Build，然后单击 OK。

键入新构建器的名称，例如 Ant Builder。

在 Buildfile 下，单击 Browser Workspace 定位工作区内的 Ant 文件。

单击 Targets 选项卡，并确保 After a “Clean” 和 Manual Build 目标显示。

单击 OK 保存构建器。

在 Builders 页面中，选择刚创建的新 Ant 构建器，然后单击 Up，直至您的构建器在列表中位于第一位。您必须这样做，因为需要把文件复制到插件项目中，然后才能执行其他操作。

设置了新构建器后，您可以选择 Project > Clean 或 Project > Build 清除或构建项目。Ant 构建器将运行并自动从 DocBook XML 项目中拖出 HTML 文件。

添加构建器也适于 DocBook XML 项目。您可以将 Ant 构建器添加到 DocBook XML 项目中，把任意一个目标设为清除或构建项目时执行的目标（记住，对于这些目标，usage 目标是默认值）。

帮助 TOC 文件

HTML 帮助文件的目录 (TOC) 表位于插件项目包括的两个 XML 文件中。文件如下所示：

清单 6. TestTOC.xml

清单 6 中所示的 testTOC.xml 文件包含显示在帮助窗口的 Contents 窗格中的标题名称。它只是用于链接到 toc.xml 文件。

清单 7. Toc.xml

toc.xml 文件包含显示在主标题下方的主要标题。这些主要标题都是用 href 属性链接到 HTML 页面，在清单 7 中用粗体显示：

您可以将帮助作为一个整体文件来构建，像书一样，并且只有一个指向该文件的主要标题。但是，请考虑把文档分割为可以在 toc.xml 文件中通过索引找到的独立章节，而且根据需要构建为单独的书。有关如何把文档分割为可以组织的各种物理文件的提示，请参阅 “Building modular documentation”。

自定义 DocBook 输出

到目前为止，DocBook XML 已经转换为在 Eclipse 插件内用作帮助的常规 HTML。但是如果需要整理转换后输出的 HTML 的外观该怎么办？

幸运的是，您不必只为了向 HTML 添加一点个性化或自定义格式而编写自己的 XSL 样式表。相反，您可以将变量传递给 XSLT 转换步骤以指定使您可以优化 HTML 格式的层叠样式表（Cascading Style. Sheet，CSS）。

指定 CSS 样式表

把 DocBook XML 转换为 HTML 的 XSL 样式表将检查名为 html.stylesheet 的变量。如果变量包含值，则将在 HTML 的 link 元素中使用该值链接到您指定的样式表。

清单 8 显示了具有 important 和 caution 类的简单 CSS。该 CSS 修改了这些类中文本的颜色。您将看到在显示页面时，这些类分别对应和标记中的内容。

清单 8. 简单的 CSS 文件

body { font-family : arial,sans-serif; font-size : small; }

.important { color : blue; }

.caution { color : red; }

修改 Ant 构建文件

将清单 8 中所示的 CSS 保存到 DocBook XML 项目的 lib 目录中名为 style.css 的文件中。保存完文件后，必须修改 Ant 构建文件把 CSS 文件的名称传递到 xslt 目标中，然后将 CSS 文件从 lib 文件夹复制到与其余 HTML 输出相同的文件夹中。清单 9 用粗体显示了这些更改。

清单 9. 经过修改后的 Ant 脚本

description=“Generates HTML files from DocBook XML”>

basedir=“${source.dir}” destdir=“${doc.dir}”>

在做出更改后，您可以重新运行 DocBook XML 项目中的 Ant 构建脚本。这一次，当您查看输出的 HTML 文件时，您将看到更改后的字体和 “Important” 和 “Caution” 部分的新字体颜色。

创建 PDF

至此，您已经使用了各种工具从 DocBook XML 生成可以分布到内部网站和包含在 Eclipse 帮助插件中的 HTML。但是，我在前面提到过，使用相同的 DocBook XML 源文件，还可以生成 PDF。从 DocBook XML 生成 PDF 要求使用一个额外的工具：来自 Apache XML Graphics Project 的 FOP 库（请参阅参考资料）。

FOP 库中有一个可以直接放入 DocBook XML 项目现有 Ant 构建文件中的 Ant 任务。该 Ant 任务 fop 将转换 FO 文件，这些 FO 文件都是使用 DocBook XSL 附带的 FO 样式表构建的。

使用 FOP 库生成 PDF

要使用 FOP 库，请从 Web 站点中下载包含二进制版本的 ZIP 文件（例如，fop-0.93-bin-jdk1.4.zip）。虽然该 ZIP 文件的名称好像指示它是专门为 Java 2 Platform, Standard Edition (J2SE), Development Kit (JDK) V1.4 构建的，但是它可以与 Java V5 很好地结合使用。像已下载的其他归档文件一样，您仍无需解压缩此文件。

在 Eclipse 中，选择 File > Import，然后执行在 “从归档导入文件” 中使用的相同过程。但是，这一次，只选择 build 和 lib 文件夹执行导入。

导入完文件后，修改 Ant 构建脚本以设置 fop 目标并在新的 build-pdf 目标中调用它，如下所示：

清单 10. build-pdf 目标

>

description=“Generates PDF files from DocBook XML”>>

basedir=“${source.dir}” destdir=“${fo.dir}”>>

utfile=“${dist.dir}/book.pdf” />>

设置了此目标之后，从 Eclipse IDE 运行 build-pdf 目标。这一次，在 dist 目录中，将出现名为 book.pdf 的文件。

结束语

DocBook XML 是一种功能强大的格式，可用于构建可以生成各种不同输出格式（例如 HTML 和 PDF）的技术文档。该格式使您可以专注于文档的内容，将样式问题分离。由于它十分成熟，因此很多工具可用于编辑和构建 DocBook XML 格式的文档。

Eclipse IDE 附带了用于编写和验证 XML 文档的编辑器。Eclipse 还集成了 Ant，使您可以创建能够作为 Eclipse 中的常规构建器来执行的强大构建文件。此外，Eclipse 附带的模板使您可以快速构建插件项目，其中一些插件项目包含可在 Eclipse 中用作帮助的 HTML 文件。

所有这些工具结合使用可以让您在一个地点编写技术文档，然后将该技术文档以不同格式分发给各种读者。

篇2：Eclipse中的文件格式

Eclipse中的文件格式

1、Eclipse中断层的文件格式：

文件名为：*.FLT

内容为： X坐标 Y坐标断层号

59.3125 5949569.000 1

592351.8750 5949687.500 1

………

……….

592272.0000 5954705.000 2

592355.2500 5954484.500 2

……….

591287.2500 5950308.500 4

591562.5625 5950291.000 4

……….

2、Eclipse中射孔数据的文件格式：

文件名为：*.EV （见scheduletutorials目录中的`例子）

内容为：

-- DATE EVENT LAYER TOP BOTTOM WELLDIA SKIN kh BHP

WELLNAME P2 ………..井号01.01.1970 perforation (Sand_1) 8110.7 8250.36 0.656001 12

01.05.1972 perforation (Sand_2) 8250.36 8288.12 0.656001 12

05.10.1973 perforation (Sand_3) 8288.12 8300 0.656001 12

25.12.1974 squeeze 8239.99 8300

其中：perforation――射孔 squeeze――挤堵

Welltest――试井 acidise――酸化

Stimulation――对于油井是“增产措施”，对于水井是“增注措施”

Plug――桥塞

3、Eclipse中单井生产数据的文件格式：

文件名为：*.VOL (见scheduletutorials目录中的例子)

内容为：

*FIELD

*DAILY

*IGNORE_MISSING

*HRS_IN_DAYS

*DAY Eclipse中的文件格式*MONTH *YEAR *OIL *WATER *GAS *WINJ *GINJ *DAYS

*NAME P2 TABLE_NO

01 01 1970 544.012 0.766874 811.373 0 0 24

篇3：win10中Eclipse字体大小如何更改

具体如下：

1、点击菜单栏的Window按钮;

2、点击Preference;

3、点击General按钮旁边的三角形;

4、单击 Colors and Fonts 再双击 JAVA ;

5、双击 Java Editor Text Font ;

6、选择自己的喜好即可;

7、在刚才选择Debug，然后选项第一个 Console font ;

8、调整输出输出字体。

以上便是系统城小编为大家介绍的Eclipse字体大小设置的一些步骤，在Debug中可以调整输入字体设置。感兴趣的用户们，不妨也动手操作看看吧!

[win10中Eclipse字体大小如何更改]

篇4：在平等中构建和谐社会

在平等中构建和谐社会

放在历史的视野中来看，从鸦片战争后到改革开放前，中国一直都在追求建立“大同社会”。《礼记》中把“大同”作为理想来追求。“人不独亲其亲，不独子其子。使老有所终，壮有所用，幼有所长，矜寡独孤废疾者，皆有所养”。康有为写了《大同书》。孙中山追求“平均地权、节制资本”的大同社会，倡导“天下为公”。毛泽东1958年的大跃进和人民公社也是“大同”理想的尝试。这种理念坚持了100多年，到邓小平时代发生了变化。1979年邓小平在会见日本客人大平正芳时，第一次提出要建立一个“小康”的社会。“小康”这个词也出现在《礼记》里，“大道既隐，天下为家，各亲其亲，各子其子，货力为己”。小康不仅仅意味着温饱，已经隐含着分化，但是人们提建设小康社会时往往忽略了这一点。邓小平当然没有把“小康”当做最终目标，那时他的“小康”指标很单纯，就是看人均收入。人均收入达到1000美元就算是达标了。后来，1983年他去了趟苏州，当时苏州人均收入已达到800美元，他继而认为人均800美元就足够了，可以实现六个目标，即解决人们的吃穿用问题、解决住房问题（人均20平方米）、解决城乡就业问题、解决农村人口外流问题、普及中小学教育和基本公共福利、改变人们精神面貌使犯罪率大大减少。在整个八十年代和九十年代前期，“小康社会”的提法用得并不多，那时强调的是“发展是硬道理”，“一心一意谋发展”。到1990年代末，当我们回头盘点时，不免有一喜一忧。喜的是，改革20多年来，中国经济飞速发展，年增长率达到9%，创造了人类历史上最大的经济奇迹。但在欣喜的同时，也产生了忧虑。现在，中国人均收入已经超过1000美元，但上述六个问题中除了前两个问题解决得比较好之外，其他几个问题不仅没有解决，反而变得更严重了。这个社会变得越来越不和谐。口袋里面的钱可能多了，但是空气脏了，要花更多的钱清洁空气，清洁水源，还有其它一大堆恼人的问题。于是在20世纪末，中国政府提出了“全面”建设小康社会的任务。之所以强调“全面”是因为以前对“小康”的理解太片面。新一代领导人现在又提出建立“和谐”社会的目标。和谐社会这个词在中国人听来并不特别，但译为英文“harmonious society”则极具中国特色。中国传统很讲“和”字，钱穆先生将中国的文化精髓总结为四个字：天人合一。和为贵、和平、和善、和解、和蔼、和缓、和谐，从大同社会到小康社会，再到和谐社会，都是中国传统的延续。现在之所以强调建立“和谐”社会，是因为中国经济虽然发展了，但社会中有太多怨气、戾气，缺乏和气。建设和谐社会的三个基础什么是和谐社会？和谐社会显然不仅仅是经济的高速发展。在经济发展速度非常快的时候，很可能整个饼做得非常大，但是这个饼的大部分被非常少的人拿走了，而大部分的代价被大多数人承担了。这个社会虽然发展了，但未必是一个和谐的社会。和谐社会也并不仅仅是一个稳定的社会。政治高压或其它因素的存在，可以使一个社会保持很稳定，但是这个社会未必很和谐，人们的气不是很顺。所以，建立一个和谐社会，简单地说就是要让这个社会里的人气都比较顺，没有太多的怨气，心态平和，彼此交往谦让有礼、互敬互助。和谐社会的建立有赖于三个重要基础：社会基础、政治基础、思想基础。所谓和谐社会的社会基础，就是社会分化不太严重。如果一个社会严重分化，两极尖锐对立，人的气就非常难理顺。人是有嫉妒心的，如果社会差别太大，人的嫉妒心难免非常强。他想要和你平等的愿望没能实现，他也会有强烈的受挫感。建立一个和谐社会还必须有一个政治基础，即有一套调节利益冲突的正式的机制。不是让人成天进京或到省城上访，然后被遣送回乡，又回来再上访，又被遣送回乡。而是他要表达自己的利益和诉求时，有正当的渠道可以说话，他的诉求可以被整合成一定的意见，这个意见在整个社会的决策过程中可以被听到。所以，一个和谐的社会必须有一套政治协调机制。这个机制是什么样的，各个国家可能不一样，但是必须要有这么一套机制。和谐社会的建立还要有一个思想基础。如果这个社会仅仅是靠从第三方，或者从外部进行调节的话，这种成本太高，而且未必能把各方面的事情都调节清楚。在一个和谐社会里，人们都接受同一个看法：我们生活在一个共同体里，我们不是一个狼的群体，不是每个人相互为敌的群体。我们是一个人的群体，所有的人在这个社会中都是平等的，都应该受到尊重。这个社会如果不好，对所有人都没有好处，如果不和谐，大家的利益都会受损。今天的世界，要找一个标准的和谐社会很难，但是有些社会比另外一些社会更为和谐。比如说北欧，是比较发达的，也比较和谐。有些不发达的地方也比较和谐，比如不丹。调查显示，在亚洲，不丹人民感觉最幸福。尽管他们的国家不太发达，但是很和谐。不丹有传统的协调机制，社会不那么分化。在寻求平等中构建和谐社会就中国而言，我们追求和谐社会，是因为我们的社会不够和谐。中国的社会基础、政治基础和思想基础现在都还不尽完善，在有些地方根本不存在。比如社会分化，也许在从计划经济向市场经济转化的过程中，社会结构难免变得更加复杂化、多元化（据中国社会科学院《中国社会阶层报告》，从1952年到，社会阶层由简单到复杂，目前分十个阶层，可能还有更多），但是职业上的不同，并非必然导致收入和生活方式的严重不平等。联合国开发署《中国人类发展报告》的核心，是讨论中国的各种不平等。我们一般关注的不平等仅仅是收入方面的，但是实际上有太多其它的不平等，比如教育、医疗方面的不平等，社保方面的.不平等，包括失业保障、医疗保障、退休保障等方面，然后才是财富方面的不平等，等等。把方方面面的不平等汇到一块，这个图是很难看的。就是说，中国社会是很不平等的，不光和中国过去比很不平等，而且和世界其他很多国家比也不平等。我在写了一篇文章《中国公共卫生的危机和转机》，引用了世界卫生组织的数据。全世界191个国家评卫生公平指数，中国排在第188位，倒数第4名。这对一个自称社会主义的国家是很难看的排名。常听到一个说法，一个社会发展到人均GDP1000-3000美元时，阶层分化是不可避免的。实际上没有什么事情是不可避免的。很多国家和地区在发展过程中都避免了这种情况，比如韩国、日本，还有中国的台湾。除了收入差别，还有基本的安全方面的差别。最近国际劳工组织公布了一个报告《一个公平的全球化：为所有人创造机会》，专讲安全感。我们以前讲的安全都是公安部门打击各种犯罪，实际上安全有各种各样的表现。比如说你有没有安全感，怕不怕突然因为生病失去收入，怕不怕失业，或者是大学毕业后就业无门。还有，中国存款率为什么这么高，就是对未来感到不安全。国际劳工组织的报告把世界上所有国家分为四类，将中国排在最不安全的国家那一类。报告呼吁：以人为本、可持续发展、公平的规则、具有团结精神的全球化、对人民更加负责和从本国治理做起。目前的利益调节机制也很有问题。以前社会比较简单，没有明显分化，有一个党愿意代表大多数人的利益，社会和谐并不是不可能。而在社会结构越来越复杂，社会分化越来越严重的情况下，仍希望有一个组织代表所有人的利益，就非常难了。这个时候就要建立一整套的表达机制和整合机制，使不同的利益得以充分表达并得到协调。这方面中国还有很多的事情要做。中国的社会分化之所以变得如此严重，跟我们政治体制里没有一整套利益协调机制是有关系的。如果有那么一套机制，普通民众、工人、农民、下岗工人、贫困人口的意愿都能够得到充分表达，能够被整合到公共政策决策过程中的话，中国社会可能不会变得如此分化。所以，社会基础和政治基础是相互关联的，二者同样重要。思想基础固然也很重要，但是如果我们所面对的社会如此不公平，却还要把气理顺，假装认为这是一个共同体，则是非常困难的。这种认同到了一定的阶段会非常重要，在一个比较和谐的社会，民众是有这种感觉的。和谐社会需要共同体意识中国传统社会的和谐建立在三纲五常的基础上，讲的是纲常伦理：君要贤，父要慈，子要孝，等等。每个人强调自己的责任而不是权利，这是旧时保持和谐的思想基础。但是这个时代已经过去了。到了毛泽东时代，官方推行的思想基础也被大多数人实践。开始是“人人为我，我为人人”，后来讲大公无私，以国家、集体的利益为最大利益，提倡这些来建立一个和谐社会的思想基础。但这个时代也过去了。现在我们的社会是“人人为自己，上帝为大家”，但我们又不信上帝，所以就没有人为大家了，这样就难以建立一个和谐的社会。我在香港中文大学任教经常有这样的经历，学生中有大陆人、香港人、美国人、欧洲人，其中欧洲学生共同体的感觉非常强。比如我讲需要有公众税收，增加一点个人所得税，中国学生总是很为富人担忧，说这个会不会影响投资呢？欧洲学生认为这不是问题，说40－50%的税收是应该的，用于再分配，使这个社会可以和谐，成为一个共同体。讲到东西德合并以后，彼此发展差距很大，西德拿出几千亿马克援助东德，若是在中国，上海市民可能会说，我们凭什么拿钱援助贵州？他们效率那么低下，还不如把钱花在我这儿，效率要高得多。这说明，中国人的共同体意识非常弱。这种意识，大陆比香港弱，香港比美国弱，美国比欧洲弱，大陆比欧洲就更弱。

篇5：在语言选择中构建社会身份

在语言选择中构建社会身份

'同一性'和'持续性'是身份两个主要特征,它是在社会实践过程中构建形成并随社会的变迁发生变化.语言与身份构建是辩证的关系,并具动态、双向的特征;语言的社会本质特征和构建功能是实现这种关系的基础.在当今'多元化'的.社会交往中,语言选择与身份的构建之间的关系更趋复杂化.

作者：李茹 LI Ru 作者单位：贵州省黔南民族师范学院,外语系,贵州,都匀,558000 刊名：山西农业大学学报（社会科学版）英文刊名：JOURNAL OF SHANXI AGRICUL TURAL UNIVERSITY(SOCIAL SCIENCE EDITION) 年，卷(期)： 7(1) 分类号：H030 关键词：语言身份构建

篇6：简述Eclipse中的CSS编辑器使用

这篇文章主要介绍了Eclipse中的CSS编辑器使用,Eclipse特别在Linux工作环境下作为高人气的IDE,集成的CSS相关编辑功能也趋于简洁,需要的朋友可以参考下

CSS in Eclipse 4.2

在 Eclipse 4.2 的设置中，一些关于颜色和字体的设置改用了 CSS 进行设置，例如 General > Appearance > Colors and Fonts 设置界面。

Eclipse SDK 使用主题对 CSS 样式单进行分组，用于对工作区进行风格设定，你可以在INSTALL/plugins/org.eclipse.platform_4.2.0.qualifier/css 文件中查看这些 CSS 设定。

在 Eclipse 中编辑 CSS

现在可以使用 Eclipse 提供的轻量级 CSS 编辑器来修改外观，首先进入 E4 安装网站并安装 E4 CSS editor (Incubation). 重启后进入 General > Appearance 选项页来修改 CSS。

修改你自已的风格样式单

你可以通过在General>Appearance Perference页面编辑风格样式单自定义一些新的外观。

移除自定义样式

使用Restore Defaults按钮可以移除所有你已经添加到样式单的自定义的样式，并且重置为plugins/org.eclipse.platform所定义的一般的状态，

切换到单编辑器标签模式

你可以通过添加以下的CSS从而切换到单编辑器标签模式

CSS Code复制内容到剪贴板

#org-eclipse-ui-editorss CTabFolder.MPartStack {

swt-single: true;

}

切换 tab 样式

经典的主题支持 2.1 和 3.x 风格的 tab，你可编辑 .MPartStack 中的 swt-simple 属性进行修改，前提是 swt-tab-renderer 设置为 null.

CSS Code复制内容到剪贴板

.MPartStack {

swt-tab-renderer: null;

swt-selected-tabs-background:#FFFFFF#ECE9D8100%;

swt-simple: true;

swt-mru-visible: true;

}

减小 tab 的字体大小

CSS Code复制内容到剪贴板

.MPartStack {

font-size: 9;

swt-simple: false;

swt-mru-visible: false;

}

篇7：在诚信服务中构建和谐演讲稿

在诚信服务中构建和谐演讲稿

文/苹果脸儿

何谓“和谐”？

大自然的魅力在和谐，音乐的神韵在和谐。社会的发展离不开和谐，企业的发展更需要和谐。

在构建和谐企业的过程中，机械制造公司以诚信为基，通过打造“诚信机械”品牌，构建和谐企业，走出了一条以诚信谋和谐，以和谐促发展的企业发展之路，打造了自己的品牌，促进了企业的发展。回首我们的“诚信”之路，“诚信”的歌声一路飞扬！

3月份的一天下午，下班的铃声已经敲响，金工车间调度室突然接到一个紧急求助电话，氧化铝二厂配料车间某设备中的轴承盖破碎，造成整体系统停车。这个表面坑坑洼洼、结构复杂的轴承盖，按常规从制做毛坯到完成成品，至少需要一个星期的时间，较长的加工周期将给氧化铝的生产带来多大的损失！（本文出自范.文.先.生.网 www.fwsIr.com）氧化铝生产就是大局，为生产赢得时间就是效益。金工车间技术人员经过认真查看和周密分析，果断决定超常规组织加工，答复对方的话掷地有声：“4小时内交货！”他们一边和铆焊车间联系，紧急组织下料，一边组织技术人员测量、绘图，并安排各工种全力以赴做好应战的准备。加工、划线、钻孔，每一道工序有条不紊，紧张有序。轴承盖终于以最快的速度顺利加工完毕！考虑到轴承盖的个体独特性，他们主动派人亲临现场实施安装。经安装调试，新加工的轴承盖完全合乎技术要求。从接到任务到安装完毕仅用了3个小时！当氧化铝生产的列车在我们手中顺利通行，参加检修的'员工们脸上露出了幸福的微笑。事后，该车间技术员来到金工车间，握着金工车间主任王玉骁的手说：“检修任务交给你们，我们一百个放心！”

小小的一个备件，小小的一件事，却折射出机械制造公司人诚实守信、优质服务的整体风貌，反映了机械制造公司人以诚信服务构建和谐企业的实际行动，让机械制造公司人赢得了用户的信任，赢得了良好的口碑。

机械制造公司员工不仅用良好的服务意识、过硬的技术实力赢得掌声，更用顽强的工作作风和善打硬仗的精神风貌博得喝彩。

4月3日，氧化铝二厂4#球磨机告急。刚刚停产的4#球磨机热汽蒸腾，难以靠近。氧化铝的生产要求必须要在凌晨4点之前恢复磨机运转。虽然已采取了措施强行降温，但没有7、8个小时，温度是降不下来的。接到抢修任务后，在氧化铝一厂四管道化现场忙活了一天的机装车间检修人员来不及休息，便匆匆赶到抢修现场。一位员工试探着要钻进磨体，身子刚进去一半，热浪便扑面而来，防护眼镜上立刻被高温蒸气罩上了一层白雾。

怎么办？继续等待，势必要影响到氧化铝生产。

“上，两人一组，互相照应，十分钟轮换。受不了赶紧出来！”班长命令完便和另外一位员工率先钻进了磨体。

由于磨体内温度高，不通风，再加上气割电焊作业，大家身上的衣服很快就被汗水浸透了，但他们心中只有一个信念，那就是：尽快完成抢修任务，为氧化铝生产赢得宝贵的时间……

凌晨2点50分，4#球磨机终于又轰轰隆隆地唱起了欢歌……

诚信赢得用户，和谐促进发展。截止8月份，机械制造公司全面完成了公司下达的二挡经营指标，员工收入稳中有升。实践使我们深深体会到：诚信是和谐的基石，和谐是发展的源泉。一个企业缺失了诚信，永远不可能成为和谐的企业；企业之间只有拥有了诚信，才会实现共赢和发展！

朋友们，让我们立足本职，诚实守信，积极投身于公司和谐企业的创建活动中，一起绘就绚丽多彩的中铝郑州企业长卷，共同奏响中铝郑州企业和谐发展的华美乐章！