Difference between revisions of "Zh/Documentation/DevGuide/Extensions/Extension Description"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (New page: {{Documentation/DevGuide/ExtensionsTOC/Zh |ShowPrevNext=block |PrevPage=Zh/Documentation/DevGuide/Extensions/Icon |NextPage=Zh/Documentation/DevGuide/Extensions/Extension Identifiers }} [[...)
 
Line 5: Line 5:
 
}}
 
}}
 
[[en:Documentation/DevGuide/Extensions/Extension Description]]
 
[[en:Documentation/DevGuide/Extensions/Extension Description]]
−
{{DISPLAYTITLE:扩展描述}}
+
{{DISPLAYTITLE:扩展说明}}
  
−
扩展管理器可以在对话框中为每个扩展显示一小段文字。完整的版本在扩展被选中时可以看到。这段文字本来是在 OOo 3.0 之前的版本的 '工具提示' 中显示的。
+
扩展管理器可以在对话框中为每个扩展显示一小段说明文字。完整的说明在扩展被选中时可以看到。这段文字本来是在 OOo 3.0 之前的版本的 '工具提示' 中显示的。
−
The Extension Manager can display a small text for each extension in the dialog. The full text will become visible when the extension is being selected. Originally, this text was displayed in a 'tool tip' in versions of OOo previous v3.0.
+
  
−
Versions of OOo earlier than 3.1 use the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description|"Tooltip Description"]] of an extension which is kept in the [[Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description| manifest.xml]]. Using the "Tooltip Description" is '''deprecated''' as of OOo 3.1 and that functionality will not be maintained. Since then the description is specified in the [[Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]]. OOo 3.1 and later will first try to get the description from the description.xml. If there is none then it will try to get the tooltip description. That is, extensions can start to use this feature and need not necessarily require OOo 3.1. However, developers should be aware that the tooltip description may be removed in the future.
 
  
−
Using a description is similar to the use of a [[Documentation/DevGuide/Extensions/Simple License|license]]. One can put a couple of localized description files into the extension and reference them in the description.xml. The description using a locale which matches that of the office will be displayed. See [[Documentation/DevGuide/Extensions/Localized XML Elements]] for how the localization works.
+
OOo 3.1 之前的版本使用 [[Zh/Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description|"扩展工具提示说明"]]，保存在 [[Zh/Documentation/DevGuide/Extensions/File Format#Extension Tooltip Description| manifest.xml]] 中。OOo 3.1 起不再提倡使用 "'''工具提示说明'''" 了，并且也不再会维护此项功能。此后'''说明'''会在 [[Zh/Documentation/DevGuide/Extensions/Description of XML Elements|description.xml]] 中指定。OOo 3.1 和以后的版本将会首先尝试从 description.xml 中获取'''说明'''。也就是说，扩展可以开始使用此功能而不一定非要等到 OOo 3.1。无论如何，开发者们需要留意的是在将来有可能移除"工具提示说明"。
−
The description files must contain '''UTF-8''' encoded text.
+
  
  
−
'''See also'''
+
'''扩展说明'''的使用与 [[Zh/Documentation/DevGuide/Extensions/Simple License|license]] 的使用大致相同。可将一两个本地化的描述文件放到扩展中并在 description.xml 引用它们。'''扩展说明'''选择那个与 Office 安装最匹配的地域来显示。请参阅 [[Zh/Documentation/DevGuide/Extensions/Localized XML Elements|本地化 XML 元素]] 以了解如何实现本地化。
−
*[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/extension-description|XML description for description.xml]]
+
 
−
*[[Documentation/DevGuide/Extensions/Example|Example of description.xml]]
+
 
 +
'''说明'''文件包含的文本必须使用 '''UTF-8''' 编码。
 +
 
 +
 
 +
'''也请参阅'''
 +
*[[Zh/Documentation/DevGuide/Extensions/Description of XML Elements#/description/extension-description 元素|description.xml 的 XML 说明]]
 +
*[[Zh/Documentation/DevGuide/Extensions/Example|description.xml 示例]]
  
  
Line 24: Line 27:
 
{{PDL1}}
 
{{PDL1}}
  
−
[[Category:Documentation/Developer's Guide/Extensions]]
+
[[Category:文档/开发者指南/扩展]]

Revision as of 08:50, 25 September 2008


扩展管理器可以在对话框中为每个扩展显示一小段说明文字。完整的说明在扩展被选中时可以看到。这段文字本来是在 OOo 3.0 之前的版本的 '工具提示' 中显示的。


OOo 3.1 之前的版本使用 "扩展工具提示说明"，保存在 manifest.xml 中。OOo 3.1 起不再提倡使用 "工具提示说明" 了，并且也不再会维护此项功能。此后说明会在 description.xml 中指定。OOo 3.1 和以后的版本将会首先尝试从 description.xml 中获取说明。也就是说，扩展可以开始使用此功能而不一定非要等到 OOo 3.1。无论如何，开发者们需要留意的是在将来有可能移除"工具提示说明"。


扩展说明的使用与 license 的使用大致相同。可将一两个本地化的描述文件放到扩展中并在 description.xml 引用它们。扩展说明选择那个与 Office 安装最匹配的地域来显示。请参阅 本地化 XML 元素 以了解如何实现本地化。


说明文件包含的文本必须使用 UTF-8 编码。


也请参阅


Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=Zh/Documentation/DevGuide/Extensions/Extension_Description&oldid=93519"
Personal tools
In other languages