flexmeasures.utils.doc_utils

Functions

flexmeasures.utils.doc_utils.rst_to_openapi(text: str) → str

Convert a string with RST markup to OpenAPI-safe text.

  • Replaces to some section with “the docs”

  • Replaces section A with “section A in the docs”

  • Removes any RST footnote references like [#]_ or [1]_ or [label]

  • Replaces X with <abbr title=”Y”>X</abbr>

  • Converts \(base^{exp}\) into HTML sup/sub notation for OpenAPI

  • Converts inline code to <code>

  • Converts bold to <strong>

  • Converts italic to <em>