A Sphinx extension for generating Matlab HTML docs.
Project description
sphinx-matlabdoc-builder
A Sphinx extension for generating Matlab HTML docs.
This extension builds the Sphinx project into a set of HTML
documents and additionally generates the TOC helptoc.xml
file
required for the
Matlab toolbox documentation
For generating documentation for Matlab code, check out the matlabdomain Sphinx extension.
Installation
The package can be installed from Pip
pip install sphinx-matlabdoc-builder
Alternatively you can download the sphinx_matlabdoc_builder
package into your
sphinx directory and add the local directory to the sphinx path.
Requirements
This package is an extension to Sphinx. Requires Python 3.
Usage
To use sphinx-matlabdoc-builder, you must first install the package and add
the extension to your sphinx conf.py
file. For example, add the
sphinx_matlabdoc_builder
extension to the end of your extension list:
extensions = [
'sphinx.ext.mathjax',
'sphinx.ext.githubpages',
'sphinx_matlabdoc_builder',
]
Then compile the source with
make matlabdoc
or if using sphinx-build
sphinx-build -M matlabdoc ./ build
this should generate the normal HTML output and add the helptoc.xml
file to the output directory.
To use the helptoc.xml
file in your toolbox, create a new matlab
package and click add documentation and specify the documentation
output directory.
If you have an existing info.xml
file, simply change the documentation
directory to point to the output directory containing the helptoc.xml
file.
For example, on Matlab 2018a, a info.xml
file might look something like:
<?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>
where help_location
specifies the path to the Sphinx output directory.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sphinx-matlabdoc-builder-0.1.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5519f5ace6967404efa264cdfb95b9810b4e8561b8413834e773314740575d80 |
|
MD5 | ae65cac8912d922ba2d37d0789207cab |
|
BLAKE2b-256 | 54a91c1000c8415a3b55c01550e257efb04b364232b786f5f43a765764acf1a6 |
Hashes for sphinx_matlabdoc_builder-0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21f56d30835925a319f7a65608c3974443458589d5721a3ad1a4f84665c5532a |
|
MD5 | aef41a7edb6fa52f93b91150f87fc04e |
|
BLAKE2b-256 | 28463068079ea46e562f859c8ec71f2ad2c7c7d14f798975903f5bd97b797a78 |