CN101154160A - 项目文档和编辑的定制语言支持 - Google Patents

Abstract

提供了一种软件文档系统。这包括用于存储应用程序的文档数据的文档对象。用文档对象存储一种或多种定制语言组件以为应用程序提供语言显示选项。定制语言组件可用作标签以指示加标签的数据项要保持以诸如串名字等要以文档设计者的指定语言保持的指定形式。

Description

项目文档和编辑的定制语言支持

技术领域

本发明一般地涉及软件开发系统，尤其涉及作为补充或增强口语文档的替换文档形式创建和提供的定制语言。

背景技术

软件文档或源代码文档是伴随计算机软件的书面文本，往往是在计算机开发环境中创建的。通常，这类文档说明基础代码的运行方式和/或如何利用代码。“软件文档”一词可具有多个上下文，并因而以不同形式存在。文档的某些示例类型包括软件的体系结构或设计文档。另一种形式包括代码、算法、接口和API的技术文档。又一种形式的文档包括终端用户、系统管理员、支持人员的手册以及包括产品简介和推销信息在内的营销文献。

设计文档倾向于采取概括性的视角。这种类型的文档更关注于为什么要使用而不是如何使用。例如，在一个设计文档中，编程者会说明以特定方式组织数据结构背后的基本原理，或列出特定对象的元函数以及如何将新的对象添加到代码中。这可以包括说明以特定方式构造给定类别的原因、概述规范、讨论替换设计、概述改进的想法、或提供以后针对于未来项目如何改进设计的计划。然而，这种类型的文档通常被认为不适合于考虑到其它要求而设计的代码或技术文档。

关于技术文档，这是一种大多数编程者在使用软件文档一词时所想到的类型。在创建软件时，光有代码是不够的。应该有一些文本和代码一起来说明其预期的操作的各个方面。此文档通常嵌在源代码本身之中，因此，任何可能遍历它的人都可以容易地访问它。在一个实例中，可能非常技术性的、并且主要用于定义和解释API、数据结构和算法注释可以被添加至源代码。例如，可以使用此文档来解释一个变量指示工厂中的特定位置或机器。代码文档的全面性是重要的，但不可冗长到使其变得难以维护。除了源代码文档之外，其它技术文档要求可包括关于任务、例程、控制器、模块、数据类型、标签、阶段、附加指令等的说明。

通常，诸如Doxygen、javadoc、ROBODoc、POD或TwinText等工具可用于自动生成代码文档-即，它们从源代码中提取注释并以诸如文本或HTML文件的形式创建参考手册。代码文档常常被组织成允许编程者迅速查找任意功能或类别的一类参考指导。许多编程者由于各种原因喜欢自动生成文档。例如，因为它是从源代码本身(例如，通过注释)提取的，所以编程者能在写文档时参考它们的代码，并且因而能采用与用于创建源代码相同的工具来生成该文档。

除了标准文档任务之外，现在开发的系统是针对全球经济的市场的。因此，不仅需要代码或系统开发所采用的本国语言的文档，还需要在开发原始代码所用语言以外将文档本地化成一种或多种外语。随着软件项目的开发继续变得更加球化，用户需要在全世界部署软件或系统设计，在这些地方相应设计的消费者的语言可能不同于设计的创建者的语言。因此，开发工程师、维护工程师和查看设计的操作员可能说不同语言，这可能给可能需要更新、变更和/或操作给定设计的那些人造成困难。

当前文档方案的另一问题在于也许不能容易地将某个控制系统文档与指定“口语”例如机器名字或数字常数相关联。给定项目的不同用户类型还可能需要不同类型的文档。例如，设计者可能用相同的口语以长、短两种形式的项目文档来为他们的代码编制评注，维护者可能需要在工厂地板上查看缩编版本的项目文档，而检修员可能需要查看较长形式的项目文档以帮助找到潜在问题的根源。

发明内容

以下给出简化的概要以提供本说明书所述的某些方面的基本理解。此概要既不是广泛的综述也不旨在标识关键/重要元素或划出本文所述的各方面的范围。其唯一目的是以简化的形式提出某些概念作为稍后提出的更详细的说明的序言。

提供定制语言组件和选项是为了便于诸如能在软件开发环境中提供电子文档。定制语言允许设计者为了各种需求并根据与诸如方言等语言或为应用产生的文档类型相关联的特定细微差异来制做文档。因此，多个不同语言元素可作为一组生成，然后被分别选择以满足这类文档的终端用户的需求。通常，定制语言可应用于不同应用情形。在一种情形中，语言组件可以被加标签以指示在如此加了标签或标记了的文档不适用外文翻译。例如，对于未翻译或不易于与口语关联的串，用户能指定一种存储/显示项目文档的那些加了标签的组件所使用的定制语言。一个具体例子是一个创建用于“系统常量”的定制语言而不必将此文档设置成英语(美语)或任何其它指定语言的用户。因此，一种语言可用作保持被应用于组件的定制语言，无论可能已为项目或应用的总体文档开发了何种基本的语言翻译。

另一个示例应用涉及创建用于“扩展文档”的定制语言并将其与诸如英文等给定语言相关联的一类用户。项目可具有“英语(美语)”和“英语(扩展文档)”，其中扩展文档可包括诸如比标准英语形式更冗长的特征(或某些其它语言细微差别)。可以理解，可以为任何语言开发定制语言。这使得相同(或相似)语言的文档可以有多个版本，以系统特定用户为目标。当存在有不同文档需求的各种用户时，定制语言可以通过以监视进程的某个人为目标来节省计算机内存或界面屏幕资源，而仍可为例如系统的故障检修员提供足够的信息。因此，终端用户能从为给定文档组存储的一个或多个语言组件中选择他们需要的定制语言特征。

为了实现上述及相关目的，这里结合以下说明以及附图说明某些示例性方面。这些方面表示了本说明书旨在全部涵盖的可以实行的各种方法。当结合附图考虑以下详细说明时，其它优点和新颖特性可以变得很明显。

附图说明

图1是示出具有定制语言支持的软件开发系统的示意框图。

图2是示出文档系统的示例定制语言组件的图。

图3是示出开发系统的项目文档管理器组件的图。

图4是示出一个示例开发或文档系统的图。

图5-7示出用于开发的示例定制语言接口或文档工具。

图8是示出文档处理的流程图。

图9示出一示例开发系统计算环境。

图10示出用于执行编辑和文档处理的示例客户机和服务器系统。

具体实施方式

提供了便于软件文档编制的系统和方法。本发明的一个方面提供一种软件文档编制系统。这包括用于存储应用程序文档数据的文档对象。一种或多种定制语言组件与文档对象一起存储以为应用程序提供语言显示选项。定制语言组件可用作标签以指示加标签的数据项要保持指定形式不变，一如机器名要保持文档设计者的指定语言。定制语言组件还可指定成一种类似语言的不同形式。这包括存储不同版本的相似文档，其中其形式被制作成适合给定子集的用户，对相应用户具有不同的上下文。

注意到如在本申请中使用的诸如“组件”、“对象”、“接口”等词旨在指计算机相关实体，或是硬件、硬件与软件的组合、软件或是如同应用于工业控制用自动系统的执行中的软件。例如，组件可以是，但不限于是在处理器上运行的进程、处理器、对象、可执行、执行的线程、程序和计算机。例如，在服务器上运行的应用程序和服务器两者都可以是组件。一个或多个组件可以驻留在进程和/或执行的线程内并且组件可以被定位在一个计算机上和/或分布在两个或多个计算机、工业控制器和/或与其通信的模块之间。另外，注意到翻译的语言和本地化语言可具有类似的含义。因此，从一种语言翻译成另一种语言的文档可以称为已被本地化。

首先参见图1，软件开发或文档系统100为软件文档编制、查看和编辑提供平台和显示输出110。显示输出110与能提供基本上任何类型的软件、系统或组件开发的开发工具120相关联。例如，开发工具120可以用于通用计算机软件开发或用于诸如将在以下详述的可编程逻辑控制器软件等应用程序。开发工具120还可与诸如计算机或编辑器等原文语言工具相关联以编制组件的给定集或子集的文档。诸如光标或视觉传感器等选择组件130标识一个或多个文档对象140，可通过编辑器150对其进行编辑。

如图所示，编辑器150与为开发工具120选择的当前语言相关联，而显示组件110提供可用于一个或多个文档对象140的替换语言的显示。这类对象140可包括基本上任何类型的能使诸如注释等文档与其相关联的组件。这些对象140包括程序对象、程序指令、规范、设计准则、算法、视觉对象、声音对象、梯形逻辑元件、时序函数图表元件、功能块图或诸如与C++、Basic、Java等相关联的高级语言对象。

通常，与文档对象140相关联的文档可以存储在存储介质160(例如，数据库、数据文件)中，其中当前语言文档组件164和定制语言文档组件168可以被输入开发工具120和从开发工具120输出。文档组件164和168可以用基本上任何语言(例如，英语、德语、法语、俄语等)。语言开关170可以与开发工具120相关联以允许在显示元件110所采用的当前语言文档上下文与其中将当前文档语言组件164被切换至定制语言文档组件168所支持的一个或多个替换文档形式的编辑器150之间切换。

注意到存在几种用于生成定制语言组件168的方法。一种方法是将当前语言组件164送到外面的公司并从当前语言组件生成一种或多种语言形式。例如，可以送出一份冗长的注释，而得到一份简洁或缩编的注释集作为冗长注释的定制语言形式。在另一个例子中，给定语言可以有作为相应语言的定制语言168而创建的几种方言。另一种方法可允许开发者在150处编辑注释，保存编辑，采用语言开关170来切换至替换语言上下文，用该替换语言输入注释并根据替换语言上下文再次保存注释，从而用一组定制语言组件168来建立数据库。如可以理解的，可在编辑器150处并行地创建当前语言文档组件164以及定制语言组件168。

通常，定制语言组件168和通过语言开关170在诸语言组件之间选择的能力便于各种应用程序。在一种情形中，控制系统的项目文档的某些翻译可能不容易与例如现有口语相关联。因此，定制语言组件168由用户配置成存储不易于与所提供的语言相关联的翻译。例如，用户可能需要将未被翻译成替换语言的串命名/加标签为不可翻译的串。

另外，用户可能需要有一份长形式的文档用于开发，还要一份该文档的更简洁形式用于维护。定制语言组件168允许“语言(长形式)”和“语言(短形式)”作为另一个例子，其中“语言”指定诸如法语、英语、德语、印第安语等给定语言。如将在以下详述的，可以为其它应用程序开发诸如专门适合用户角色的语言等定制语言组件168。用户可以将定制语言组件168配置成存储给定用于翻译的语言列表中所提供的语言以外的项目文档的翻译。在配置过程中，可以对项目添加定制语言，在该项目中用户可以随后将翻译加至定制语言组件168。

在继续之前，注意到开发系统100可包括用于根据当前语言上下文显示文档对象140的装置(显示输出110)以及用于存储与该文档对象相关联的定制语言数据以生成项目文档的至少一个替换形式的装置(定制语言对象168)。系统100还可包括用于在当前语言上下文与替换语言上下文之间切换的装置(语言开关170)。

现在参见图2，更详细地说明文档系统的示例定制语言组件200。通常，定制语言组件200提供这些组件如何提供和处理所支持的多种外语以外的项目文档方面的附加级的语言定制。例如，设想有用户让工程技术人员开发项目，而他们引入了一个非常冗长的项目文档，不仅记录了代码的作用，还记录了开发者决定以这种方式进行设计的原因。类似地，当他们为产品以及他们的以相同语言工作的维护人员提供文档时，这类用户可能需要知道代码如何操作但不需要特别罗嗦。因此，定制语言组件200使用户能具有加入项目文档的非标准语言指定。使用上述例子，在任何其它标准语言之外，他们可采用开发(冗长版本的文档)和维护(简洁形式的文档)作为他们项目中的定制语言。

项目文档管理器可以在210处提供以支持定制语言组件200。以下将参照图3详述的文档管理器210提供对可在系统中出现的各种类型的语言的控制并管理相应诸类型之间的切换。这包括为文档系统选择的当前语言、可以作为当前选择的语言的替换或外语组件的默认语言、以及定制语言组件200提供支持。

进到220，考虑定制语言命名约定。通常，定制语言的名称不应与系统中的现有语言冲突。定制语言名称可遵循RFC1766命名约定并且可以在系统中内部格式化。这包括用户可提供一个定制名称，而在一个例子中，系统将该名称转换成合适的命名约定。定制语言可任选地以基础语言为基础或可以完全人工制成。基本语言(或缺乏之)以及所提供的定制名称可以成为由系统生成的RFC1766名称的要素。对于基于英语的称为“Midwestern”的定制语言，系统可生成例如“en-Midwestern”。

在230中，考虑用于定制语言支持的串标识符。在此情形中，部分语言可以被指定或加标签以指示加标签的组件不翻译。因此，定制语言组件200的另一用途会是用于能用作所有不需翻译的文档的默认语言(或其组件)的可能的“未翻译串”定制语言。例如，部件的技术说明和部件号可对所有语言有效因而可存在于将不为翻译而送出的定制语言中，因而将被用作已做如此标识的组件的默认语言。

在240，考虑定制语言应用程序。如上所述在一个例子中，可以在相同语言中指定定制语言，其中一组文档或组件冗长，供一组用户来使用，而另一组文档不那么冗长，供不同类型的用户使用。另一种类型的应用程序240包括为给定语言定义多种方言作为定制语言。例如在印度和中国，各种方言存在于已知的基本语言并且可以作为采用这些方言的地区的定制语言文档替换来提供。可以考虑到安全性来开发其它类型的定制语言。例如，取决于登录到系统中的用户的身份，可以根据特定用户的安全许可或安全特权来提供一套不同的文档。

通常，可以生成定制语言组件200以处理与特定用户相关联的基本上任何类型的细微差别。这可包括基于角色的文档集，其中取决于所标识的用户类型(例如，管理员、工程师、维护员、安全人员)，视这类标识的结果来提供一组不同的定制语言文档组件。其它类型的文档可以是基于上下文的，其中自动组件检测给定上下文(或被告知上下文)(例如，维护或故障查找上下文、操作员上下文、设计上下文等)，并选择相关的定制语言文档200来支持所检测到的上下文。

现在见图3，更详细地说明项目文档管理器300。如上所述，项目文档管理器300对可出现在系统中的各种类型的语言提供控制并管理各种类型之间的切换。这包括为给文档系统选择的310中的当前语言、可以作为当前选择的语言310的替换或外语组件的默认一种或多种默认语言320、以及一种或多种定制语言组件330提供支持。通常，项目文档管理器300可以被视为用于管理语言切换的各方面的控制中心。它为图形用户接口GUI客户机提供用于管理和指导不同语言切换组件的单个接入点。

在310，项目文档管理器300维持项目的当前语言。当前语言指定当前显示项目文档所用的语言。例如，如果向具有项目文档的系统中的对象查询其项目文档，则所返回的所请求的项目文档将使用当前语言。文档客户机能取得并设置项目的当前语言。当客户机设置项目的当前语言时，即出现一个语言开关(Language Switch)。

在320，项目文档管理器300维持项目的默认语言。默认语言指定在当前语言不具有所请求项目文档的条目(entry)时将显示的项目文档。文档客户机能取得并设置项目的默认语言。当客户机设置项目的默认语言时，发生语言切换。

在330中，项目文档管理器330维持为项目或应用程序定义的定制语言。它跟踪这些语言的细节使得它们被系统识别成另一种许可的语言。关于这些定制语言330的信息存留在数据库中。定制语言330在输入过程期间被再生，使得当在输入期间发现未知语言标识符时，能将其当作定制语言并如此创建之。

图4示出可用于以上在图1中所述的系统100的示例系统400。在此例子中，开发和文档系统400被显示成可应用于例如工业控制系统。如图所示，开发工具410能与一个或多个组件420以及用户接口430交互，其中接口可用于根据当前或定制语言上下文来提供文档。控制组件420和接口430可通过网络440与远程服务器应用程序通信。

控制组件420可包括诸如服务器、客户机、可编辑逻辑控制器(PLC)、通信模块、移动计算机、无线组件、控制组件等能通过网络440交互的各种计算机或网络组件。类似地，本说明书使用的PLC一词可包括能通过多个组件、系统和/或网络440共享的功能。例如，一个或多个PLC可通过网络440与各种网络设备通信和合作。这可包括基本上通过包括控制、自动化和/或公用网络在内的网络440通信的任何类型的控件、通信模块、计算机、I/O设备、传感器、人机接口(HIM)如用户接口430等。PLC还可与诸如包括模拟、数字、编程/智能I/O模块在内的输入/输出模块、其它可编程控制器、通信模块、传感器、输出设备等各种其它设备通信并控制它们，其中开发工具410和用户接口430能对控制组件420的各方面进行设计/文档编制。

网络440可包括诸如因特网、内联网等公用网络、以及诸如包括DeviceNet和ControlNet在内的控制和信息协议(CIP)网络等自动网络。其它网络包括以太网、DH/DH+、远程I/O、Fieldbus、Modbus、Profibus、无线网络、串行协议等。另外，网络设备可包括各种可能性(硬件和/或软件组件)。这些包括诸如具有虚拟局域网(VLAN)能力的交换机、LAN、WAN、代理、网关、路由器、防火墙、虚拟专用网络(VPN)设备、服务器、客户机、计算机、配置工具、监视工具和/或其它设备。

见图4-7，例示各种定制语言概念的示例接口被示出。然而，应了解，各图4至7本质上是示例性的并且可以用多个各种各样的形式提供。这可包括与开发工具或诸如任何类型的发送、检索、处理和/或操纵数据、接收、显示、格式化和/或传送数据、和/或便于开发系统的操作的应用程序等文档组件相接的图形用户接口(GUI)。例如，这类接口还可与引擎、服务器、客户机、编辑工具或web浏览器与相关联，但可以使用其它类型的应用程序。

GUI可包括一个显示，该显示具有一个或多个用于编辑或查看文档对象的显示对象，这些文档对象包括诸如可配置图标、按钮、滑动块、输入框、选项、菜单、标签等具有多个可配置尺寸、形状、颜色、文本、数据和声音以便于用开发工具操作的方面。另外，GUI还可包括多个用于调节或配置一个或多个方面的其它输入或控件。这可包括从鼠标、键盘、语音输入、网站、远程web服务或诸如相机或视频输入等其它设备接收用户命令以影响或修改GUI的操作。

现在参见图5，配置接口500被示出。在510中，设置“Key(键)”组合框以使得用户可指定一种语言作为用于要在从接口500选择的配置所生成的文件中执行的翻译的翻译键。组合框510中的选择可限于在当前项目中有内容的语言。如果不存在给定语言的项目文档，则它不应被包括在510处“Key”组选择中。

“Localize to(本地化至)”列表框520包括上述语言切换组件可能支持的语言。具有内容的语言可以被置于列表顶部在用于方便选择的视觉分隔符之前。项目中存在的任何定制语言均可置于530处在分隔符的下方。在540，“Custom...(定制...)”按钮使用户可管理他们的定制的语言。用户可将定制语言添加至可在“Localize to”列表框520中选取的语言列表或重新命名已创建的定制语言。

图6示出当从图5选择定制按钮540时所出现的示例接口。定制语言配置对话600包括项目当前所支持的定制语言的列表框610。在620处设置有Add...(添加...)按钮，当被按下时即显示对话框630，其中用户可在640中指定他们的定制语言的名称。当被接受时，定制语言名称显示在定制语言列表框610中。定制语言的名称不应与系统中现有的语言名相冲突。它们遵循如上所述的RFC 1766命名约定。定制语言可以与650处的根语言(Root language)相关联。通过缺省，根语言可缺省为“<none>(无)”。如果在650指定了根语言，则定制语言可与来自根语言的其它语言一起出现在列表中。在660，Rename(重命名)按钮可以被选择以引出图7中所示的接口。进到图7，图6中的按钮660在被按下时引出对话框700，其中用户可在710重新命名现有的定制语言。图6中的按钮660在列表框610中选择语言时被激活。

图8示出软件文档进程800。虽然为了简化说明起见，该方法被显示和描述成一系列动作，但应理解和了解该方法不限于该动作次序，因为某些动作可以按不同次序发生和/或与本说明书所述和所示的其它动作同时发生。例如，本领域的技术人员将理解和了解，方法可以被替换地表示成一系列相关的状态或事件，诸如在状态图中。另外，并非所有所示动作都是实现本文所述的方法所必需的。

进到图8的810，定义一个或多个替换语言来为给定软件对象编制文档。这可包括基本上任何已知语言或替代语言的代码。一种语言的注释可以例如被输出，并在被输入回系统之前被翻译成几种其它语言的注释。还可以对从被选中的当前语言自动生成的替换语言组件进行自动翻译。在820，为包括标签、程序、梯线(rung)、指令、一般文档等在内的给定文档对象选择当前语言编辑器。在一个例子中，英语被选择为当前语言，其中未来调用任何编辑功能都应采用英语作为当前语言。在其它开发情形或环境中，其它语言可以被选择为当前语言编辑器。

在830，在820为组件选择了语言编辑器之后，为所选中的文档对象定义一种或多种定制语言。这可包括使用诸如英语等基本语言以及定义该基本语言有细微差别或专用的多个版本用作定制语言。在840，定制语言被用作替换文档上下文或被用作未翻译的串。对于替换上下文，定制语言可以基于方言、冗长度、用户角色、安全性考虑等来定义。基于用户检测或规定的上下文，可以查看与所确定或所指定的上下文相关联的定制语言注释或文档对象。

在“未翻译的串”上下文中，定制语言可以用于系统中的串名字，其中不应对串进行语言翻译。因此，例如被加标签或标识为定制语言名称的英语机器名称或常量，在当前或默认语言切换到德语时，该名称将不被翻译成德语。这样，定制语言标签使文档的组件可在一般基本语言说明之外保持所需的形式不变。

参见图9，用于实现本说明书所述各种方面的示例性环境910包括计算机912。计算机912包括：处理单元914、系统存储器916以及系统总线918。系统总线918将系统组件-包括但不限于系统存储器916-耦合至处理单元914。处理单元914可以是各种可用处理器中的任何一种。双微处理器和其它多处理器体系结构也可以用作处理单元914。

系统总线918可以是包括使用各种可用总线体系结构的存储器总线或存储器控制器、外围总线或外部总线和/或局部总线在内的几种类型的总线结构中的任何一种，可用总线体系结构包括但不限于：11位总线、行业标准体系结构(ISA)、微通道体系结构(MSA)、扩展的ISA(EISA)、智能驱动电子设备(IDE)、VESA局部总线(VLB)、外围部件互连(PCI)、通用串行总线(USB)、高级图形接口(AGP)、个人计算机存储器卡国际联合会(PCMCIA)以及小型计算机系统接口(SCSI)。

系统存储器916包括易失性存储器920和非易失性存储器922。包含用于诸如在启动期间在计算机912内的组件之间传送信息的基本例程的基本输入/输出系统(BIOS)被存储在非易失性存储器922中。作为示例而非限定，非易失性存储器922可包括：只读存储器(ROM)、可编程ROM(PROM)、电可编程ROM(EPROM)、电可擦ROM(EEPROM)或闪存。非易失性存储器920包括用作外部高速缓冲存储器的随机存取存储器(RAM)。作为示例而非限定，诸如同步RAM(SRAM)、动态RAM(DRAM)、同步DRAM(SDRAM)、双倍数据速率SDRAM(DDR SDRAM)、增强的SDRAM(ESDRAM)、同步链接DRAM(SLDRAM)和直接存储器总线RAM(DRRAM)等许多形式的RAM可用。

计算机912还包括可移动/不可移动、易失性/非易失性计算机存储介质。图9示出例如盘存储器924。盘存储924包括但不限于象磁盘驱动器、软盘驱动器、磁带驱动器、Jaz驱动器、Zip驱动器、闪存卡或记忆棒那样的设备。另外，盘存储器924可包括与其它存储介质分开或组合在一起的存储介质，包括但不限于诸如光盘ROM设备(CD-ROM)、CD可记录驱动器(CD-R驱动器)、CD可重写驱动器(CD-RW驱动器)或数字通用盘(DVD-ROM)。为了便于将盘存储设备924连接至系统总线918，通常使用诸如接口926等可移动或不可移动接口。

应了解，图9描述用作用户与在合适的操作环境910中所描述的基本计算机资源之间的媒介的软件。这类软件包括操作系统928。可存储在盘存储924上的操作系统928控制和分配计算机系统912的资源。系统应用程序930通过存储在系统存储器916中或盘存储924上的程序模块932和程序数据934来利用操作系统928对资源的管理。应了解本说明书所述的各种组件可以用各种操作系统或操作系统的组合来实现。

用户通过输入设备936将命令或信息输入计算机912。输入设备936包括但不限于诸如鼠标、跟踪球、指示笔、触摸板、小键盘、麦克风、游戏杆、游戏垫、圆盘式卫星电视天线、扫描器、电视调谐器卡、数字相机、数字摄像机、网络相机等定点设备。这些和其它输入设备经由接口端口938通过系统总线918与处理单元914连接。接口端口938包括例如串行端口、并行端口、游戏端口和通用串行总线(USB)。输出设备940使用与输入设备936相同类型的端口中的某一些。因此，例如，USB端口可用于提供对计算机912的输入以及用于将来自计算机912的信息输出至输出设备940。设置输出适配器942以说明存在象监视器、扬声器和打印机那样需要特殊适配器的输出设备940。输出适配器942包括例如但不限于提供输出设备940与系统总线918之间的连接手段的视频卡和声卡。应注意，其它设备和/或设备系统既提供输入能力也提供输出能力，诸如远程计算机944等。

计算机912可以使用到一个或多个诸如远程计算机944等远程计算机的逻辑连接在连网的环境中操作。远程计算机944可以是个人计算机、服务器、路由器、网络PC、工作站、基于微处理器的装置、对等设备或其它共用网络节点等，且通常包括关于计算机912所描述的组件中的许多或全部。为了简洁起见，远程计算机944只例示了存储器存储设备946。远程计算机944通过网络接口948与计算机912逻辑连接，然后通过通信连接950物理地连接。网络接口948包括诸如局域网(LAN)和广域网(WAN)等通信网络。LAN技术包括光纤分布式数据接口(FDDI)、铜线分布式数据接口(CDDI)、以太网/IEEE 802.3、令牌环/IEEE 802.5等。WAN技术包括但不限于点对点链接、象综合服务数字网(ISDN)及其变型那样的电路切换网络、分组交换网以及数字用户线路(DSL)。

通信连接950指用于将网络接口948连接至总线918的硬件/软件。虽然为了清楚示例起见图中的通信连接950在计算机912内部，但它也可以在计算机912外部。连接至网络接口948所需的硬件/软件例如包括诸如包括普通电话级调制解调器、电缆调制解调器和DSL调制解调器在内的调制解调器、ISDN适配器和以太网卡等外置和内置技术。

图10是可采用的采样计算环境1000的示意框图。系统1000包括一个或多个客户机1010。客户机1010可以是硬件和/或软件(例如，线程、进程、计算设备)。系统1000还包括一个或多个服务器1030。服务器1030也可以是硬件和/或软件(例如，线程、进程、计算设备)。服务器1030可以容纳线程以通过采用例如本说明书所述的组件来执行变换。客户机1010与服务器1030之间一种可能的通信形式是适于在两个或多个计算机进程之间传送的数据包。系统1000包括可用来促进客户机1010与服务器1030之间的通信的通信框架1050。客户机1010与一个或多个可用于存储客户机1010本地的信息的客户机数据存储1060可操作地连接。类似地，服务器1030与可用于存储服务器1030本地的信息的服务器数据存储1040可操作地连接。

以上所述的包括各种示例性方面。当然不可能为了说明这些方面而说明组件或方法的每一个可以想到的组合，但本领域的普通技术人员可认识到可以有许多其它的组合和排列。因此，本说明书所述的诸方面旨在包括落在所附权利要求书的精神和范围内的所有这些变更、修改和变型。另外，就“包括”一词被用于详细说明或权利要求书这一方面来说，这个词就如同“包含”一词在权利要求中用作过渡词时所解释的“包含”类似是“包括在内”之意。

Claims (31)

1.一种软件文档系统，包括：

文档对象，用于存储应用程序的文档数据；以及

与所述文档对象存储在一起的一种或多种定制语言组件，用于为应用程序提供语言显示选项。

2.如权利要求1所述的系统，其特征在于，所述定制语言组件被应用作标签以指示加有标签的数据项要保持指定的语言形式。

3.如权利要求1所述的系统，其特征在于，所述定制语言组件被指定成类似语言的不同形式或被指定成用户定义语言的不同形式。

4.如权利要求1所述的系统，其特征在于，所述定制语言组件与字数标识符相关联，其中冗长形式包括比定制语言组件的简洁形式更多的文字。

5.如权利要求1所述的系统，其特征在于，所述定制语言组件与语言方言相关联。

6.如权利要求1所述的系统，其特征在于，所述定制语言组件与用户角色相关联。

7.如权利要求6所述的系统，其特征在于，所述用户角色与操作员角色、设计者角色、维护者角色、安全角色和管理角色有关。

8.如权利要求1所述的系统，其特征在于，所述定制语言组件与安全标识符相关联。

9.如权利要求1所述的系统，其特征在于，还包括与触发编辑器的激活的光标链接的选择组件。

10.如权利要求9所述的系统，其特征在于，所述编辑器与编程语言编辑器相关联。

11.如权利要求10所述的系统，其特征在于，所述编程语言编辑器与梯形逻辑、时序函数图表、标签编辑器、属性编辑器、功能块编辑器或结构化文本编辑器相关联。

12.如权利要求1所述的系统，其特征在于，还包括至少一个用于为定制语言组件提供配置选项的配置菜单。

13.如权利要求12所述的系统，其特征在于，所述配置菜单提供允许根据可配置根语言来命名定制语言组件的接口。

14.如权利要求1所述的系统，其特征在于，所述配置菜单包括用于将定制语言组件本地化的组件。

15.如权利要求1所述的系统，其特征在于，还包括用于控制一种或多种当前语言、一种或多种默认语言以及一种或多种定制语言的项目文档管理器。

16.如权利要求1所述的系统，其特征在于，还包括用于以至少一种标准自动协调为所述定制语言组件指定的名称的命名约定组件。

17.如权利要求16所述的系统，其特征在于，所述命名约定组件与RFC1776命名标准相关联。

18.如权利要求1所述的系统，其特征在于，还包括在一种或多种所选择的语言之间变更文档显示的语言开关。

19.一种其上存储有便于文档编制的数据结构的计算机可读介质，包括：

第一数据字段，用于指定当前语言组件；

第二数据字段，用于指定用所述当前语言定义的一种或多种定制语言组件；以及

第三数据字段，用于将所述定制语言组件与所述当前语言组件绑定。

20.如权利要求19所述的计算机可读介质，其特征在于，还包括用于标识要保持为非本地化文本的文档对象的一部分的标签字段。

21.如权利要求19所述的计算机可读介质，其特征在于，还包括用于标识要如何显示所述定制语言组件的角色字段。

22.如权利要求21所述的计算机可读介质，其特征在于，所述角色字段与安全角色、维护角色、操作员角色、设计者角色、管理角色和开发者角色相关联。

23.如权利要求19所述的计算机可读介质，其特征在于，还包括用于控制要显示多少文档的冗长字段。

24.如权利要求19所述的计算机可读介质，其特征在于，还包括用于指示从当前语言变成至少一种定制语言组件的转换字段。

25.如权利要求19所述的计算机可读介质，其特征在于，还包括至少一个所述一种或多种定制语言组件的配置字段。

26.一种生成文档的方法，包括：

用当前语言定义一个或多个注释；

为所述当前语言定义一个或多个其它注释形式；以及

将所述其它注释形式显示为所述当前语言的一种或多种定制语言形式。

27.如权利要求26所述的方法，其特征在于，还包括自动生成所述一种或多种定制语言形式的名称。

28.如权利要求26所述的方法，其特征在于，还包括通过用户接口在所述一种或多种定制语言形式之间切换。

29.如权利要求26所述的方法，其特征在于，还包括将所述当前语言的组件加标签成不可本地化的形式。

30.一种开发系统，包括：

用于根据当前语言上下文来显示文档对象的装置；以及

用于存储与所述文档对象相关联的定制语言数据以生成项目文档的至少一个替换形式的装置。

31.如权利要求34所述的开发系统，其特征在于，还包括用于在当前语言上下文与替换语言上下文之间切换的装置。

Images