概述

如果您创建一个适用于MathWorks的工具箱^®下载188bet金宝搏产品，即使它只包含一些函数，也可以以HTML帮助文件的形式包含自定义文档。Toolbox的自定义文档可以包括数字，图表，屏幕捕获，方程式和格式化，以使工具箱帮助更具可用性。

要正确显示，您的自定义文档必须包含以下文件：

要查看自定义文档，请打开“帮助浏览器”并导航到主页。在主页的底部，下补充软件，单击工具箱的名称。您的帮助在当前窗口中打开。

创建HTML帮助文件

您可以在任何文本编辑器或Web发布软件中创建HTML帮助文件。要在MATLAB中创建帮助文件，请使用这两种方法中的任何一种：

将所有HTML帮助文件存储在一个文件夹中，例如HTML.Toolbox文件夹中的子文件夹。此文件夹必须是：

文档集通常包含：

创建info.xml.文件

这info.xml.文件描述了您的自定义文档，包括要为文档显示的名称。它还标识了查找HTML帮助文件和何处的位置helptoc.xml.文件。创建一个名为的文件info.xml.对于您记录的每个工具箱。

去创造info.xml.要描述您的工具箱，可以调整此模板：

 <？xml样式表类型=“text / xsl”href =“可选”？>R2016B. mytoolbox. 工具箱 <图标>  HTML. 

COPYFILE（全文件（MATLABROOT，'HELP'，'TECHDOC'，'MATLAB_ENV'，...'示例'，'模板'，'info_template.xml'），pwd）fileattrib（'info_template.xml'，'+ w'）编辑（'info_template.xml'）

下表描述了所需的元素info.xml.文件。

您还可以包括您的评论info.xml.文件，例如版权和联系信息。通过括在界面之间的文本来创建评论<！ -和- >。

当你创造的时候info.xml.文件，确保：

创建helptoc.xml.文件

这helptoc.xml.文件定义了所显示的帮助文件的层次结构内容补充软件浏览器的窗格。

你可以创建一个helptoc.xml.使用MATLAB文档包含的模板来文件。创建和编辑模板文件的副本helptoc_template.xml.在当前文件夹中，在“命令”窗口中运行此代码：

Copyfile（FullFile（MatlaBroot，'帮助'，'TechDoc'，'Matlab_env'，...'exampleR_template'，'helptoc_template.xml'），pwd）fileattrib（'helptoc_template.xml'，'+ w'）编辑（'helptoc_template.xml'）

放置helptoc.xml.文件在包含HTML文档文件的文件夹中。此文件夹必须称为在你的info.xml.文件。

每个进入helptoc.xml.文件引用您的HTML帮助文件之一。首先进入helptoc.xml.文件用作文档的初始登录页面。

在顶级元素，嵌套元素定义内容表的结构。每个元素有A.目标提供文件名的属性。文件和路径名称区分大小写。

当你创造的时候helptoc.xml.文件，确保：

<？xml版本='1.0'编码=“utf-8”？>  我的工具箱函数第一个  second  第三  我的示例  

构建搜索数据库

要使文档可搜索，请使用“创建搜索数据库”（也称为搜索索引）builddocsearchdb.命令。使用此命令时，请指定包含HTML文件的文件夹的完整路径。

例如，假设您的HTML文件已在C：\ matlab \ mytoolbox \ html。此命令为这些文件创建可搜索数据库：

builddocsearch db（'c：\ matlab \ mytoolbox \ html'）

builddocsearchdb.创造一个子文件夹C：\ matlab \ mytoolbox \ html命名为helpsearch-v3，包含数据库文件。

要在工具箱中搜索条款，请打开帮助浏览器，并在其中搜索文档字段，输入要搜索的术语。然后，在页面的左侧，下通过来源精炼， 选择补充软件查看工具箱的结果。

从MATLAB R2014B开始，您可以并排维护搜索索引。例如，如果您已经为Matlab R2014a或更早版本有搜索索引，则运行builddocsearchdb.使用MATLAB R2014B对您的帮助文件。然后，当您运行任何MATLAB版本时，帮助浏览器会自动使用适当的索引来搜索文档数据库。

解决验证错误info.xml.文件

警告：文件未验证。......

通常，错误是由XML标记的不正确的排序产生的。通过更新info.xml文件内容来遵循MATLAB帮助文档中的指南来纠正错误。