reference-entry-links.rst 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. .. _reference.entry.links:
  2. :py:attr:`entries[i].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.entry.links.rel:
  9. :py:attr:`entries[i].links[j].rel`
  10. ----------------------------------
  11. The relationship of this entry 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.entry.links.type:
  20. :py:attr:`entries[i].links[j].type`
  21. -----------------------------------
  22. The content type of the page that this entry link points to.
  23. .. _reference.entry.links.href:
  24. :py:attr:`entries[i].links[j].href`
  25. -----------------------------------
  26. The :abbr:`URL (Uniform Resource Locator)` of the page that this entry 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. .. _reference.entry.links.title:
  31. :py:attr:`entries[i].links[j].title`
  32. ------------------------------------
  33. The title of this entry link.
  34. .. rubric:: Comes from
  35. - /atom03:feed/atom03:entry/atom03:link
  36. - /atom10:feed/atom10:entry/atom10:link
  37. - /rdf:RDF/rdf:item/rdf:link
  38. - /rss/channel/item/link
  39. .. seealso::
  40. * :ref:`reference.entry.link`