| 12345678910111213141516171819202122232425262728293031323334353637383940414243 |
- .. _reference.entry.summary:
- :py:attr:`entries[i].summary`
- =============================
- A summary of the entry.
- If this contains :abbr:`HTML (HyperText Markup Language)` or :abbr:`XHTML
- (Extensible HyperText Markup Language)`, it is :ref:`sanitized
- <advanced.sanitization>` by default.
- If this contains :abbr:`HTML (HyperText Markup Language)` or :abbr:`XHTML
- (Extensible HyperText Markup Language)`, certain (X)HTML elements within this
- value may contain relative :abbr:`URI (Uniform Resource Identifier)`\s. If so,
- they are :ref:`resolved according to a set of rules <advanced.base>`.
- Some publishing systems auto-generate this value from the first few words or
- first paragraph of the entry. Other publishing systems misuse it to include
- the full content. In the latter cases, :program:`Universal Feed Parser` ought
- to detect it and put the value in :ref:`reference.entry.content` instead, but
- it doesn't.
- .. note::
- Some feeds include both a summary and description element for each entry. In
- this case, the first element will be available in ``entry['summary']`` and the
- second will be available in ``entry['content'][0]``.
- .. rubric:: Comes from
- * /atom10:feed/atom10:entry/atom10:summary
- * /atom03:feed/atom03:entry/atom03:summary
- * /rss/channel/item/description
- * /rss/channel/item/dc:description
- * /rdf:RDF/rdf:item/rdf:description
- * /rdf:RDF/rdf:item/dc:description
- .. seealso::
- * :ref:`reference.entry.summary_detail`
|
