Sphinx extension: log build errors next to emitting error markup

[felixfontein]

So far, when the roles in the Sphinx extension were used with bad data, only error markup was generated, but no log output was printed during the build.

Example input:

[...]

:ansplugin:`foo.bar.baz`
:ansopt:`foo.bar.baz:bam`

:ansretval:`foo.bar.baz#bamboo`
:ansplugin:`foo.bar.baz#module`

[...]

Example output:

[..]
reading sources... [100%] index
/path/to/index.rst:7: ERROR: while processing :ansplugin:`foo.bar.baz`: Cannot extract plugin name and type
/path/to/index.rst:7: ERROR: while processing :ansopt:`foo.bar.baz:bam`: Invalid option name "foo.bar.baz:bam"
/path/to/index.rst:10: ERROR: while processing :ansretval:`foo.bar.baz#bamboo`: Invalid return value name "foo.bar.baz#bamboo"
looking for now-outdated files... none found
[...]
writing output... [100%] index
/path/to/index.rst:10: WARNING: undefined label: 'ansible_collections.foo.bar.baz_module'
generating indices... done
[...]

(The undefined label warning was already printed before when Sphinx tries to resolve the reference. What's new are the errors printed while processing the sources.)

[gotmax23]

Thanks for working on this!

[felixfontein]

@gotmax23 thanks!