Figure out where to place images

[Anders Logg]

Images are placed in different places: _static, _themes/fenics/_static, and locally in directories. Where to put them?

[Harish Narayanan (hnarayanan)]

- Theme or UI-related images go in _themes/fenics/_static
- General images and media go in _static

Also, I would like the output directory to be something like fpo/style/images (for the first kind of image) and fpo/media for the rest of the images.

I don't know what you mean by locally in directories.

[Anders Logg (logg)]

On Tue, Aug 09, 2011 at 11:58:29AM -0000, Harish Narayanan wrote:
> - Theme or UI-related images go in _themes/fenics/_static

ok.

> - General images and media go in _static

One big directory for all images? Or multiple?

I've tried to put images under _static/images.

> Also, I would like the output directory to be something like
> fpo/style/images (for the first kind of image) and fpo/media for the
> rest of the images.

What is an "output directory"?

> I don't know what you mean by locally in directories.

As we have done for the downloading icons where they are located in a
subdirectory inside download/. That's probably not a good idea since
it requires referring to the images in the .rst to make sure they get
copied along during build.

--
Anders

[Harish Narayanan (hnarayanan)]

- Let's start with one big directory for all images and split it up later if this becomes too unwieldy?

- Output directory = the directory that Sphinx writes the built files to.

[Anders Logg (logg)]

- Sounds good. I propose that directory to be

    source/_static/images

- Can we control that? In that case, how does fpo/media relate to the already existing fpo/pub/{graphics,images,photos,movies,etc}?

[Anders Logg (logg)]

I found it more convenient to place images locally in a subdirectory named images. See for example source/featured/2011/images/.

[Harish Narayanan (hnarayanan)]

That is much better. (And I didn't know that was possible.)

[Anders Logg (logg)]

I believe figures linked to from the theme itself and from raw html .inc files still need (or should) go under _static/images though.

ok, so this is resolved:

1. Place images locally under <current_folder>/images/ if possible.
2. Otherwise in _static/images/.