reference-entry-link.rst 1.1 KB

123456789101112131415161718192021222324252627282930313233
  1. .. _reference.entry.link:
  2. :py:attr:`entries[i].link`
  3. ==========================
  4. The primary link of this entry. Most feeds use this as the permanent link to
  5. the entry in the site's archives.
  6. If this is a relative :abbr:`URI (Uniform Resource Identifier)`, it is
  7. :ref:`resolved according to a set of rules <advanced.base>`.
  8. Some :abbr:`RSS (Rich Site Summary)` feeds use guid when they mean link. guid
  9. can also be used as an opaque identifier that has nothing to do with links. If
  10. an :abbr:`RSS (Rich Site Summary)` feed uses guid as the entry link and no link
  11. is present, :program:`Universal Feed Parser` detects this and makes the guid
  12. available in :py:attr:`entries[i].link`.
  13. In other words, you can always use :py:attr:`entries[i].link` to get the entry
  14. link, regardless of how the feed is actually structured.
  15. .. rubric:: Comes from
  16. - /atom03:feed/atom03:entry/atom03:link[@rel="alternate"]/@href
  17. - /atom10:feed/atom10:entry/atom10:link[@rel="alternate"]/@href
  18. - /atom10:feed/atom10:entry/atom10:link[not(@rel)]/@href
  19. - /rdf:RDF/rdf:item/rdf:link
  20. - /rss/channel/item/link
  21. .. seealso::
  22. * :ref:`reference.entry.links`