How to use innoConv

The principle way of using innoConv is using its command-line interface (CLI) innoconv. Another option is to use innoConv in a programmatic way as a Python library.

Run the converter on your content directory.

$ innoconv /path/to/my/content

This will trigger the conversion and store the result in a folder innoconv_output. According to Unix philosophy you will not see any messages if the conversion was successful. Though you might pass the --verbose flag to change this behaviour.

Command line arguments

innoconv

Converter for interactive educational content.

innoconv [OPTIONS] SOURCE_DIR

Options

-o, --output-dir <output_dir>

Set output directory. [default: ./innoconv_output]

-e, --extensions <extensions>

Enable extensions (comma-separated). [default: join_strings,copy_static,generate_toc,write_manifest]

-f, --force

Force overwriting of output.

-v, --verbose

Print verbose messages.

--version

Show the version and exit.

Arguments

SOURCE_DIR

Required argument

Using innoConv as a library

Using innoConv within a Python program involves creating a Manifest object and using it with a InnoconvRunner.

>>> manifest = Manifest(manifest_data)
>>> runner = InnoconvRunner(source_dir, output_dir, manifest, extensions)
>>> runner.run()

Have a look at the source of innoconv.cli for a more detailed example.