Re: [Docutils-users] Naive question about the image directive

[Guenter M. <mi...@us...>]

On 2017-01-22, Chris Green wrote:
> On Sun, Jan 22, 2017 at 09:58:55AM +0800, log4yes wrote:
>> 在 2017年01月22日 02:52, Chris Green 写道:
>> > This may be rather a silly question but at the moment I can't get the
>> > image directive to do anything useful for me.
>> >
>> > The documentation shows the syntax as:-
>> >
>> >      .. image:: picture.png
>> >
>> > and says: "The URI for the image source file is specified in the
>> > directive argument."
>> >
>> > So, does that picture.png have to be a full URI or what?  ... and
>> > where will the picture.png file be exactly?

There has to be a file at the location pointed to by the URI.
If the URI is picture.png, this means a file picture.png in the same
direcory as the generated document.

> So what appears above as "picture.png" should actually be:-

>     http://server.mylan/pictures/picture.png

This would work for any document that can access this URI (provided it
points to a valid image file).

> I'm using rst2html.

>> 2. Is there some error/warning?

> Not that I can see.  It's being run from PHP with stderr being
> redirected to a file, that file is zero length (but does exist) so I
> don't think there are any errors being reported.

When generating HTML and not giving options that require a look at the image
(scaling, ...), the URI is not checked during the process.

Günter