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

[Chris G. <cl...@is...>]

On Sun, Jan 22, 2017 at 09:46:13PM +0000, Guenter Milde wrote:
> 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
> 
OK, thanks, I'll try a bit more.

-- 
Chris Green