Skip to main content

用于生成 Matlab HTML 文档的 Sphinx 扩展。

项目描述

sphinx-matlabdoc-builder

构建状态

用于生成 Matlab HTML 文档的 Sphinx 扩展。此扩展将 Sphinx 项目构建为一组 HTML 文档,并另外生成Matlab 工具箱文档helptoc.xml所需的 TOC 文件

要为 Matlab 代码生成文档,请查看 matlabdomain Sphinx 扩展。

安装

该软件包可以从Pip安装

pip install sphinx-matlabdoc-builder

或者,您可以将sphinx_matlabdoc_builder包下载到 sphinx 目录中,并将本地目录添加到 sphinx 路径中。

要求

这个包是 Sphinx 的扩展。需要 Python 3。

用法

要使用 sphinx-matlabdoc-builder,您必须首先安装该软件包并将扩展名添加到您的 sphinxconf.py文件中。例如,将 sphinx_matlabdoc_builder扩展名添加到扩展名列表的末尾:

extensions = [
    'sphinx.ext.mathjax',
    'sphinx.ext.githubpages',
    'sphinx_matlabdoc_builder',
]

然后编译源代码

make matlabdoc

或者如果使用sphinx-build

sphinx-build -M matlabdoc ./ build

这应该会生成正常的 HTML 输出并将helptoc.xml 文件添加到输出目录。

要使用helptoc.xml工具箱中的文件,请创建一个新的 matlab 包并单击添加文档并指定文档输出目录。如果您有一个现有info.xml文件,只需将文档目录更改为指向包含该helptoc.xml文件的输出目录。例如,在 Matlab 2018a 上,info.xml文件可能类似于:

<?xml version="1.0" encoding="utf-8"?>
<productinfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="optional"><?xml-stylesheet type="text/xsl"href="optional"?>
   <matlabrelease>2018a</matlabrelease>
   <name>otslm</name>
   <type>toolbox</type>
   <icon/>
   <help_location>docs\_build\matlabdoc</help_location>
   <help_contents_icon/>
</productinfo>

wherehelp_location指定 Sphinx 输出目录的路径。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

sphinx-matlabdoc-builder-0.1.2.tar.gz (4.0 kB 查看哈希)

已上传 source

内置分布

sphinx_matlabdoc_builder-0.1.2-py3-none-any.whl (5.7 kB 查看哈希

已上传 py3