reference-feed-links.rst 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .. _reference.feed.links:
  2. :py:attr:`feed.links`
  3. =====================
  4. A list of dictionaries with details on the links associated with the feed.
  5. Each link has a rel (relationship), type (content type), and href (the
  6. :abbr:`URL (Uniform Resource Locator)` that the link points to). Some links
  7. may also have a title.
  8. .. _reference.feed.links.rel:
  9. :py:attr:`feed.links[i].rel`
  10. ----------------------------
  11. The relationship of this feed link.
  12. Atom 1.0 defines five standard link relationships and describes the process for
  13. registering others. Here are the five standard rel values:
  14. - `alternate`
  15. - `enclosure`
  16. - `related`
  17. - `self`
  18. - `via`
  19. .. _reference.feed.links.type:
  20. :py:attr:`feed.links[i].type`
  21. -----------------------------
  22. The content type of the page that this feed link points to.
  23. .. _reference.feed.links.href:
  24. :py:attr:`feed.links[i].href`
  25. -----------------------------
  26. The :abbr:`URL (Uniform Resource Locator)` of the page that this feed link
  27. points to.
  28. If this is a relative :abbr:`URI (Uniform Resource Identifier)`, it is
  29. :ref:`resolved according to a set of rules <advanced.base>`.
  30. :py:attr:`feed.links[i].title`
  31. ------------------------------
  32. The title of this feed link.
  33. .. rubric:: Comes from
  34. * /atom03:feed/atom03:link
  35. * /atom10:feed/atom10:link
  36. * /rdf:RDF/rdf:channel/rdf:link
  37. * /rss/channel/link
  38. .. seealso::
  39. * :ref:`reference.feed.link`