一种产品文档的生成方法和装置与流程

本发明涉及通信领域，具体涉及一种产品文档的生成方法和装置。

背景技术：

目前，大多数企业的产品说明文档采用可扩展标记语言XML技术，产品宣讲内容大部分使用Microsoft PowerPoint，这种情况，导致不少弊端：XML的产品文档内容，不能直接用于PowerPoint，导致PowerPoint需要单独开发，增加工作量及工作成本；两者内容及架构相差甚远，没有一致性，导致宣讲内容与参考书籍相去甚远；内容有更新时，不能同步更新导致很容易导致内容滞后甚至错误；以及增加管理成本等问题。

技术实现要素：

本发明要解决的主要技术问题是，提供一种产品文档的生成方法和装置，解决现有产品宣讲文档与产品说明文档需要单独开发导致增加工作量、内容不同步一致以及增加管理成本的问题。

为解决上述问题，本发明提供一种产品文档的生成方法，包括：

在文档类型定义中设置产品文档的各元素，所述产品文档包括产品说明文档和产品宣讲文档；

根据当前待生成的产品文档的需求从各元素中挑选出目标元素，设置各目标元素的分类标识；

将各目标元素采用可扩展标记语言进行文档编辑得到可扩展标记语言文档；

根据所述分类标识和预设产品文档生成规则将所述可扩展标记语言文档生成对应的产品文档。

在本发明的一种实施例中，所述设置各目标元素的分类标识包括：

对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记；

对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记；

对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记。

在本发明的一种实施例中，在在文档类型定义中设置产品文档的各元素时，还包括：设置各元素的属性值为初始属性值；

所述对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记包括：将对属于产品宣讲文档中且不属于产品说明文档的目标元素的初始属性值设置为第一属性值；

所述对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记包括：将对属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值设置为第二属性值；

所述对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记包括：将对不属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值保持不变。

在本发明的一种实施例中，所述预设产品文档生成规则包括：

生成产品宣讲文档时，显示宣讲标记和共享标记的目标元素；

生成产品说明文档时，显示说明标记和共享标记的目标元素。

在本发明的一种实施例中，所述显示宣讲标记和共享标记的目标元素包括：对说明标记的目标元素进行隐藏处理；

所述显示说明标记和共享标记的目标元素包括：对宣讲标记的目标元素进 行隐藏处理。

在本发明的一种实施例中，所述对说明标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，不等于第一属性值和第二属性值的目标元素进行隐藏处理；

所述对宣讲标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，等于第一属性值的目标元素进行隐藏处理。

为解决上述问题，本发明还提供一种产品文档的生成装置，包括元素设置模块、分类标识模块、文档编辑模块和文档生成模块：

所述元素设置模块用于在文档类型定义中设置产品文档的各元素，所述产品文档包括产品说明文档和产品宣讲文档；

所述分类标识模块用于根据当前待生成的产品文档的需求从各元素中挑选出目标元素，设置各目标元素的分类标识；

所述文档编辑模块用于将各目标元素采用可扩展标记语言进行文档编辑得到可扩展标记语言文档；

所述文档生成模块用于根据所述分类标识和预设产品文档生成规则将所述可扩展标记语言文档生成对应的产品文档。

在本发明的一种实施例中，所述分类标识模块还用于：

对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记；

对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记；

对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记。

在本发明的一种实施例中，所述元素设置模块还用于在在文档类型定义中设置产品文档的各元素时，设置各元素的属性值为初始属性值；

所述分类标识模块还用于：将对属于产品宣讲文档中且不属于产品说明文 档的目标元素的初始属性值设置为第一属性值；

将对属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值设置为第二属性值；

将对不属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值保持不变。

在本发明的一种实施例中，所述预设产品文档生成规则包括：

生成产品宣讲文档时，显示宣讲标记和共享标记的目标元素；

生成产品说明文档时，显示说明标记和共享标记的目标元素。

在本发明的一种实施例中，所述显示宣讲标记和共享标记的目标元素包括：对说明标记的目标元素进行隐藏处理；

所述显示说明标记和共享标记的目标元素包括：对宣讲标记的目标元素进行隐藏处理。

在本发明的一种实施例中，所述对说明标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，不等于第一属性值和第二属性值的目标元素进行隐藏处理；

所述对宣讲标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，等于第一属性值的目标元素进行隐藏处理。

本发明的有益效果是：

本发明提供的产品文档的生成方法和装置，在文档类型定义中设置产品文档的各元素，产品文档包括产品说明文档和产品宣讲文档；根据当前待生成的产品文档的需求从各元素中挑选出目标元素，设置各目标元素的分类标识；将各目标元素采用可扩展标记语言进行文档编辑得到可扩展标记语言文档；根据分类标识和预设产品文档生成规则将可扩展标记语言文档生成对应的产品文 档。与现有技术相比，将产品说明文档与产品宣讲文档都采用可扩展语言开发，即采用同源开发，这样可以让两者的文档内容进行同步一致，并且能够避免更新错误或者滞后的问题，进一步，可以减少工作量及工作成本以及降低管理成本。

附图说明

图1为本发明实施例一提供的产品文档的生成方法流程图；

图2-1为本发明实施例二提供的产品文档的生成方法流程图；

图2-2为本发明实施例二提供的产品文档的生成方法中的产品说明文档示意图；

图2-3为本发明实施例二提供的产品文档的生成方法中的产品宣讲文档示意图；

图3为本发明实施例三提供的产品文档的生成装置结构示意图。

具体实施方式

为使本发明实施例的目的、技术方案和优点更加清楚，下面将结合附图对本发明实施例中的技术方案进行清楚、完整地描述，显然，所描述的实施例是本发明一部分实施例，而不是全部的实施例。基于本发明中的实施例，本领域普通技术人员在没有作出创造性劳动前提下所获得的所有其他实施例，都属于本发明保护的范围。

实施例一：

本实施例提供的产品文档的生成方法，如图1所示，该方法包括：

步骤S101：在文档类型定义中设置产品文档的各元素，产品文档包括产品 说明文档和产品宣讲文档；

在该步骤中，在文档类型定义(Document Type Definition，DTD)中设置满足设计要求的各元素时需要考虑产品文档的特性，即需要考虑产品说明文档、产品宣讲文档的不同特性、相同特性、及相互关联特性，使新修改的DTD能覆盖到设计要求。

步骤S102：根据当前待生成的产品文档的需求从各元素中挑选出目标元素，设置各目标元素的分类标识；

在该步骤中，从文档类型定义中的各元素中选取当前待生成的产品文档的需要的元素作为目标元素。这里的待生成的产品文档是指当前需要生成的产品文档，可以是第一次进行的产品文档，也可以是进行产品文档的更新的产品文档。这里的目标元素是只当前产品文档需要的各元素。这里的分类标识是为了区分具体产品文档对应有哪些目标元素，即具体的产品说明文档用到哪些目标元素，产品宣讲文档用到哪些目标元素，值得注意的是，这里还包括产品说明文档和产品宣讲文档都用到哪些目标元素。

步骤S103：将各目标元素采用可扩展标记语言进行文档编辑得到可扩展标记语言文档；

在该步骤中，在将各目标元素编写完整的可扩展标记语言文档，这里的可扩展标记语言文档是指可以得到产品说明文档，也可以得到产品宣讲文档，即两个产品文档是同源开发的。

步骤S104：根据所述分类标识和预设产品文档生成规则将所述可扩展标记语言文档生成对应的产品文档。

在该步骤中，这里的预设产品文档生成规则是指用户需要什么产品文档，即需要生成产品说明文档还是宣讲文档。具体的，可以将预设产品文档生成规 则设计为对应的XSLT样式表，例如产品说明文档设计为产品说明manual样式表、产品宣讲文档slides样式表。

在上述步骤S102中，设置各目标元素的分类标识包括：对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记；对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记；对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记。这里的进行各目标元素的标记为其中的一种方式，应该理解为只要能够区分各目标元素属于那种文档类型的目标元素的方式都可以实现。

进一步，为你减少处理，可以利用可扩展语音自身的属性特性进行标记区分，具体的，在在文档类型定义中设置产品文档的各元素时，还包括：设置各元素的属性值为初始属性值；对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记包括：将对属于产品宣讲文档中且不属于产品说明文档的目标元素的初始属性值设置为第一属性值；对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记包括：将对属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值设置为第二属性值；对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记包括：将对不属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值保持不变。这里的保持不变即指空标记。

在上述步骤S104中，预设产品文档生成规则包括：生成产品宣讲文档时，显示宣讲标记和共享标记的目标元素；生成产品说明文档时，显示说明标记和共享标记的目标元素。具体的，显示宣讲标记和共享标记的目标元素包括：对说明标记的目标元素进行隐藏处理；显示说明标记和共享标记的目标元素包括：对宣讲标记的目标元素进行隐藏处理。

进一步，可以直接对元素的属性值进行判断，对说明显示标记的目标元素进行隐藏处理包括：对说明标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，不等于第一属性值和第二属性值的目标元素进行隐藏处理；对宣讲标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，等于第一属性值的目标元素进行隐藏处理。

实施例二：

本实施例提供的产品文档的生成方法，如图2-1所示，该方法包括：

步骤S201：在DTD中定义可满足设计要求的元素及属性。

在该步骤中，在进行DTD定义时，需要考虑产品说明文档、产品宣讲文档的不同特性、相同特性、及相互关联特性，使新修改的DTD能覆盖到设计要求。本例中我们为所有元素设计一个产品宣传幻灯片slidesprops属性，这里的slidesprops属性是初始属性值的一种示例。具体实现可以是，

<！ENTITY％base-attribute-extensions'

courseprops CDATA#IMPLIED

column CDATA#IMPLIED

'>

步骤S202：根据业务特点及各种文档的不同特性，设计一套元素分类识别。

在该步骤中，对于仅在产品宣讲文档中显示的内容，设置slidesprops＝onlyslides；对于可同时在产品文档和宣讲文中显示的内容，设置slidesprops＝slides；对于在产品文档中显示，在宣讲文档中不显示的内容，不对slidesprops进行任何处理，这里的onlyslides是第一属性值的一种示例，slides是第二属性值的一种示例。这里的仅在产品宣讲文档中显示的内容是指对属于产品宣讲 文档中且不属于产品说明文档的目标元素。可同时在产品文档和宣讲文中显示的内容是指属于产品宣讲文档中且属于产品说明文档的目标元素；在产品文档中显示，在宣讲文档中不显示的内容是指不属于产品宣讲文档中且属于产品说明文档的目标元素。

步骤S203：根据业务特点及各种文档的不同特性，分别针对manual、slides设计不同的XSLT样式表。

在该步骤中，具体的设计slides样式表时，对于各元素的slidesprops属性值进行判断，不等于slides或onlyslides的元素内容进行hidden处理。例如：

<xsl:if test＝"slidesprops＝”">

<xsl:attribute

name＝"hidden">yes</xsl:attribute>

</xsl:if>

具体的，设计manual样式表时，对于各元素的slidesprops属性值进行判断，等于onlyslides的元素内容进行hidden处理。例如：

<xsl:if test＝"slidesprops＝'onlyslides'">

<xsl:attribute

name＝"hidden">yes</xsl:attribute>

</xsl:if>

步骤S204：编写XML文档，在进行XML文档编辑的时候，应用上述步骤S202中的元素识别规则。

该步骤中，例如：<image slidesprops＝"slides"href＝"x-wc://file＝img-0002117877.wmf"></image>。

步骤S205：进行文档的编写和生成。

在该步骤中，结合上述步骤S204中的文档例子，以及分别应用步骤S203中的样式表，生成出如图2-2所示的产品说明文档，如图2-3所示的产品宣讲文档。

实施例三：

本实施例提供的产品文档的生成装置300，如图3所示，包括元素设置模块301、分类标识模块302、文档编辑模块303和文档生成模块304：其中，元素设置模块301用于在文档类型定义中设置产品文档的各元素，产品文档包括产品说明文档和产品宣讲文档；分类标识模块302用于根据当前待生成的产品文档的需求从各元素中挑选出目标元素，设置各目标元素的分类标识；文档编辑模块303用于将各目标元素采用可扩展标记语言进行文档编辑得到可扩展标记语言文档；文档生成模块304用于根据分类标识和预设产品文档生成规则将可扩展标记语言文档生成对应的产品文档。

具体的，分类标识模块302还用于：

对属于产品宣讲文档中且不属于产品说明文档的目标元素进行宣讲标记；

对属于产品宣讲文档中且属于产品说明文档的目标元素进行共享标记；

对不属于产品宣讲文档中且属于产品说明文档的目标元素进行说明标记。

进一步，元素设置模块301还用于在在文档类型定义中设置产品文档的各元素时，设置各元素的属性值为初始属性值；

分类标识模块302还用于：将对属于产品宣讲文档中且不属于产品说明文档的目标元素的初始属性值设置为第一属性值；

将对属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值设置为第二属性值；

将对不属于产品宣讲文档中且属于产品说明文档的目标元素的初始属性值保持不变。

进一步，预设产品文档生成规则包括：生成产品宣讲文档时，显示宣讲标记和共享标记的目标元素；生成产品说明文档时，显示说明标记和共享标记的目标元素。

进一步，显示宣讲标记和共享标记的目标元素包括：对说明标记的目标元素进行隐藏处理；显示说明标记和共享标记的目标元素包括：对宣讲标记的目标元素进行隐藏处理。

进一步，对说明标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，不等于第一属性值和第二属性值的目标元素进行隐藏处理；对宣讲标记的目标元素进行隐藏处理包括：对各目标元素的属性值进行判断，等于第一属性值的目标元素进行隐藏处理。

本领域普通技术人员可以理解上述方法中的全部或部分步骤可通过程序来指令相关硬件完成，上述程序可以存储于计算机可读存储介质中，如只读存储器、磁盘或光盘等。可选地，上述实施例的全部或部分步骤也可以使用一个或多个集成电路来实现。相应地，上述实施例中的各模块/单元可以采用硬件的形式实现，也可以采用软件功能模块的形式实现。本发明不限制于任何特定形式的硬件和软件的结合。

以上实施例仅用以说明本发明的技术方案而非限制，仅仅参照较佳实施例对本发明进行了详细说明。本领域的普通技术人员应当理解，可以对本发明的技术方案进行修改或者等同替换，而不脱离本发明技术方案的精神和范围，均应涵盖在本发明的权利要求范围当中。