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

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

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?
> >
> > All I can do at the moment is get to see the text "picture.png".
> >
> You can use relative path from your source file to the image, or full 
> uri(url). Make sure the path is correct.
> 
So what appears above as "picture.png" should actually be:-

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

(fictional address but that's the idea)

...or for a relative address:-

    ../../pictures/picture.png

(or something like that, does it need anything more?)


> Some more info will help:
> 1. How do you generate the output? e.g. rst2html, online editor, github 
> or blog using rst?

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.


Thank you.

-- 
Chris Green