``feed.image``
=====================

A dictionary with details about the feed image.  A feed image can be a logo,
banner, or a picture of the author.


.. _reference.feed.image.title:

``feed.image.title``
---------------------------

The alternate text of the feed image, which would go in the alt attribute if
you rendered the feed image as an :abbr:`HTML (HyperText Markup Language)` img
element.


.. _reference.feed.image.href:

``feed.image.href``
--------------------------

The :abbr:`URL (Uniform Resource Locator)` of the feed image itself, which
would go in the src attribute if you rendered the feed image as an :abbr:`HTML
(HyperText Markup Language)` img element.

If this is a relative :abbr:`URI (Uniform Resource Identifier)`, it is
:ref:`resolved according to a set of rules <advanced.base>`.


.. _reference.feed.image.link:

``feed.image.link``
--------------------------

The :abbr:`URL (Uniform Resource Locator)` which the feed image would point to.
If you rendered the feed image as an :abbr:`HTML (HyperText Markup Language)`
img element, you would wrap it in an a element and put this in the href
attribute.

If this is a relative :abbr:`URI (Uniform Resource Identifier)`, it is
:ref:`resolved according to a set of rules <advanced.base>`.


.. _reference.feed.image.width:

``feed.image.width``
---------------------------

The width of the feed image, which would go in the width attribute if you
rendered the feed image as an :abbr:`HTML (HyperText Markup Language)` img
element.


.. _reference.feed.image.height:

``feed.image.height``
----------------------------

The height of the feed image, which would go in the height attribute if you
rendered the feed image as an :abbr:`HTML (HyperText Markup Language)` img
element.


``feed.image.description``
---------------------------------

A short description of the feed image, which would go in the title attribute if
you rendered the feed image as an :abbr:`HTML (HyperText Markup Language)` img
element.  This element is rare; it was available in Netscape :abbr:`RSS (Rich
Site Summary)` 0.91 but was dropped from Userland :abbr:`RSS (Rich Site
Summary)` 0.91.


.. rubric:: Annotated example

This is a feed image:

..  code-block:: xml

    <image>
    <title>Feed logo</title>
    <url>http://example.org/logo.png</url>
    <link>http://example.org/</link>
    <width>80</width>
    <height>15</height>
    <description>Visit my home page</description>
    </image>


This feed image could be rendered in :abbr:`HTML (HyperText Markup Language)` as this:

..  code-block:: html

    <a href="http://example.org/">
    <img src="http://example.org/logo.png"
    width="80"
    height="15"
    alt="Feed logo"
    title="Visit my home page">
    </a>


.. rubric:: Comes from

* /rdf:RDF/rdf:image
* /rss/channel/image
