There is a bug in the latest Sphinx that appears to only affect Windows.

See https://github.com/sphinx-doc/sphinx/issues/9018

The simple solution for now is to pin sphinx<3.5


On Fri, Mar 19, 2021 at 7:05 AM Lex Margai <[email protected]> wrote:

> Hi, everyone
>
> After having installed Sphinx and Python, during a project building,
> multiple following issues have appeared and images cannot be parsed:
> *WARNING: image file not readable:
> assets/images/Server/Tasks/trashIcon.png*
>
> In the .rst file, the path for an image is specified as
> *../../assets/images/Server/Tasks/trashIcon.png *
>
> The path to a file is correct and when I compile this project on other
> machines (Ubuntu/Windows 10) compilation succeeds and no warnings appear
> (images are present in html output).
>
> I found that compilation also succeeds when I specify the path as absolute
> i.e. */../assets/images/Server/Probe.Page/trashIcon.png *
>
> Sphinx documentation says that relative paths are available for the image
> directive.
> But I cannot define what's wrong with a relative path in my case on this
> machine? May I wrongly understand the point of relative paths? What's the
> correct way of specifying path for image directives?
>
> My environment is:
>
> *Python 3.9.2Sphinx v3.5.2*
>
> NB: OFC I may convert all the paths to absolute, but there are lots of
> images and I should ensure that this is required because I wrongly specify
> path all this time before.
>
> Thanks in advance!
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/sphinx-users/e3f214fe-9894-4da6-9839-1fa9d1094793n%40googlegroups.com
> <https://groups.google.com/d/msgid/sphinx-users/e3f214fe-9894-4da6-9839-1fa9d1094793n%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/CAE8Ss2FC0E5gwecw1W3JwgFmR%3Dc7o%3DT-v8PifHf4CtipTLAyKg%40mail.gmail.com.

Reply via email to