Skip to content

RST image directive tries to load images from local, even if explicitly passed as absolute URLs #621

@smileBeda

Description

@smileBeda

I am using https://pandoc.org (which, heck, I wish I knew it earlier) to generate rst from my markdown (and other) file formats.
This works like a charm.

However, there is a peculiarity in the PHPDocumentor Guides feature.
Whenever I generate a Guide using the rst file it generates img tags that look for the image source file on the local path. That of course causes the images to not load.

Example

  • In the rst you have:
|GitHub contributors|
// other content
.. |GitHub contributors| image:: https://img.shields.io/github/contributors/ORG/REPO
  • PHPDocumentor Guide HTML output:
<img src="guide/tukutoi-template-builder/https://img.shields.io/github/contributors/ORG/REPO">

It is self-explanatory why I cannot use local files here: the whole point of this badge is that it is dynamically generated by GitHub.

Can this be fixed somehow? I already tried to wrap my absolute URL in <> in the rst file, which did not help.
Perhaps some config attribute, or terminal command I am not aware of?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions