short-description: Hotdoc module authors: - name: Thibault Saunier email: tsaunier@igalia.com years: [2018] has-copyright: false ...

Hotdoc module

This module provides helper functions for generating documentation using hotdoc.

Added 0.48.0

Usage

To use this module, just do: hotdoc = import('hotdoc'). The following functions will then be available as methods on the object with the name hotdoc. You can, of course, replace the name hotdoc with anything else.

hotdoc.generate_doc()

Generates documentation using hotdoc and installs it into $prefix/share/doc/html.

Positional argument:

  • project_name: The name of the hotdoc project

Keyworded arguments:

  • sitemap ([[@str]] or [[@file]]) (required): The hotdoc sitemap file
  • index ([[@str]] or [[@file]]) (required): Location of the index file
  • dependencies([[@build_tgt]]): Build targets to use when generating documentation.
  • depends([[@custom_tgt]]): Custom targets on which this documentation target depends.
  • subprojects: A list of HotdocTarget that are used as subprojects for hotdoc to generate the documentation.
  • ... Any argument of hotdoc can be used replacing dashes (-) with underscores (_). For a full list of available parameters, just have a look at hotdoc help.

Changed in 0.64.1: depends: added. Previously, all types of targets were accepted by dependencies:. This is now deprecated. Use dependencies: only with build targets, to pass their configuration to hotdoc. Use depends: to set up dependency relationships on custom targets.

Returns:

HotdocTarget: A [[custom_target]] with the following extra methods:

  • config_path: Path to the generated hotdoc configuration file.

hotdoc.has_extensions()

Positional arguments:

  • ...: The hotdoc extension names to look for

No keyworded arguments

Returns: true if all the extensions where found, false otherwise.

Example

hotdoc = import('hotdoc')

hotdoc.generate_doc('foobar',
  project_version: '0.1',
  sitemap: 'sitemap.txt',
  index: 'index.md',
  c_sources: ['path/to/file.c'],
  c_smart_index: true,
  languages: ['c'],
  install: true,
)