Bourse/Lib python/feedparser-5.2.1/docs/reference-feed-image.rst

:py:attr:`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:

:py:attr:`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:

:py:attr:`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:

:py:attr:`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:

:py:attr:`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:

:py:attr:`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.


:py:attr:`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:
::


    <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:
::


    <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