Sourcefabric Manuals

 English |  Español |  Français |  Italiano |  Português |  Русский |  Shqip

Template library

Images: how, which and why

It's an understatement to say that images are crucial to news organizations. Because of their central role, Newscoop has a powerful and user-friendly media archive for storing, retrieving and reusing images in the administration interface. Newscoop's template language can access images in a number of different ways, and the output can be sent to web pages, to Javascript slideshows or other channels. In this section, we'll look at how Newscoop templates work with images, image attributes and metadata.

In Newscoop, you can work with several kinds of image:

  • Renditions
    A rendition is a preset image width and height, in pixels, intended to fit the design of a particular template. It has a specific name and can be called in the template by this name
  • Scaled in the template
    Each image can be scaled inside the template. The rendition method is preferred for performance and caching reasons
  • Author images
    The author manager allows users to upload images as part of the author profiles. These images are stored separately and are not a property of the article, nor are they set in renditions
  • Thumbnail
    Newscoop has a preset for thumbnails, but it is better to use renditions
  • From the media archive
    You can call images directly from the media archive. It is more common to call them in relation to an article they are attached to
  • Static images
    These images are outside the control of the templates, and are linked directly rather than fetched with $gimme. You can transform them using CSS and Javascript

According to the Newscoop template reference, "The image object is usually initialized inside a list of article images or a list of images. It is not initialized at the beginning of the template and cannot be initialized by other Newscoop functions." In other words, images must be used through lists or through articles.

You can make use of images through the article object, like when the current article has one or more images attached. One more place where you can use an image object is with author objects. We'll go into these options in detail later. What you can't do at this point is use an image object as a single isolated element, because it has to be set first by any of the means mentioned above.

There has been error in communication with Booktype server. Not sure right now where is the problem.

You should refresh this page.