Variable: org-feed-alist

org-feed-alist is a customizable variable defined in org-feed.el.gz.

Value

nil

Documentation

Alist specifying RSS feeds that should create inputs for Org.

Each entry in this list specified an RSS feed tat should be queried to create inbox items in Org. Each entry is a list with the following items:

name a custom name for this feed
URL the Feed URL
file the target Org file where entries should be listed, when
             nil the target becomes the current buffer (may be an
             indirect buffer) each time the feed update is invoked
headline the headline under which entries should be listed

Additional arguments can be given using keyword-value pairs. Many of these specify functions that receive one or a list of "entries" as their single argument. An entry is a property list that describes a feed item. The property list has properties for each field in the item, for example :title for the <title> field and :pubDate for the publication date. In addition, it contains the following properties:

:item-full-text the full text in the <item> tag
:guid-permalink t when the guid property is a permalink

Here are the keyword-value pair allows in org-feed-alist.

:drawer drawer-name
     The name of the drawer for storing feed information. The default is
     "FEEDSTATUS". Using different drawers for different feeds allows
     several feeds to target the same inbox heading.

:filter filter-function
     A function to select interesting entries in the feed. It gets a single
     entry as parameter. It should return the entry if it is relevant, or
     nil if it is not.

:template template-string
     The default action on new items in the feed is to add them as children
     under the headline for the feed. The template describes how the entry
     should be formatted. If not given, it defaults to
     org-feed-default-template.

:formatter formatter-function
     Instead of relying on a template, you may specify a function to format
     the outline node to be inserted as a child. This function gets passed
     a property list describing a single feed item, and it should return a
     string that is a properly formatted Org outline node of level 1.

:new-handler function
     If adding new items as children to the outline is not what you want
     to do with new items, define a handler function that is called with
     a list of all new items in the feed, each one represented as a property
     list. The handler should do what needs to be done, and org-feed will
     mark all items given to this handler as "handled", i.e. they will not
     be passed to this handler again in future readings of the feed.
     When the handler is called, point will be at the feed headline.

:changed-handler function
     This function gets passed a list of all entries that have been
     handled before, but are now still in the feed and have *changed*
     since last handled (as evidenced by a different sha1 hash).
     When the handler is called, point will be at the feed headline.

:parse-feed function
     This function gets passed a buffer, and should return a list
     of entries, each being a property list containing the
     :guid and :item-full-text keys. The default is
     org-feed-parse-rss-feed; org-feed-parse-atom-feed is an
     alternative.

:parse-entry function
     This function gets passed an entry as returned by the parse-feed
     function, and should return the entry with interesting properties added.
     The default is org-feed-parse-rss-entry; org-feed-parse-atom-entry
     is an alternative.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-feed.el.gz
(defcustom org-feed-alist nil
  "Alist specifying RSS feeds that should create inputs for Org.
Each entry in this list specified an RSS feed tat should be queried
to create inbox items in Org.  Each entry is a list with the following items:

name         a custom name for this feed
URL          the Feed URL
file         the target Org file where entries should be listed, when
             nil the target becomes the current buffer (may be an
             indirect buffer) each time the feed update is invoked
headline     the headline under which entries should be listed

Additional arguments can be given using keyword-value pairs.  Many of these
specify functions that receive one or a list of \"entries\" as their single
argument.  An entry is a property list that describes a feed item.  The
property list has properties for each field in the item, for example `:title'
for the `<title>' field and `:pubDate' for the publication date.  In addition,
it contains the following properties:

`:item-full-text'   the full text in the <item> tag
`:guid-permalink'   t when the guid property is a permalink

Here are the keyword-value pair allows in `org-feed-alist'.

:drawer drawer-name
     The name of the drawer for storing feed information.  The default is
     \"FEEDSTATUS\".  Using different drawers for different feeds allows
     several feeds to target the same inbox heading.

:filter filter-function
     A function to select interesting entries in the feed.  It gets a single
     entry as parameter.  It should return the entry if it is relevant, or
     nil if it is not.

:template template-string
     The default action on new items in the feed is to add them as children
     under the headline for the feed.  The template describes how the entry
     should be formatted.  If not given, it defaults to
     `org-feed-default-template'.

:formatter formatter-function
     Instead of relying on a template, you may specify a function to format
     the outline node to be inserted as a child.  This function gets passed
     a property list describing a single feed item, and it should return a
     string that is a properly formatted Org outline node of level 1.

:new-handler function
     If adding new items as children to the outline is not what you want
     to do with new items, define a handler function that is called with
     a list of all new items in the feed, each one represented as a property
     list.  The handler should do what needs to be done, and org-feed will
     mark all items given to this handler as \"handled\", i.e. they will not
     be passed to this handler again in future readings of the feed.
     When the handler is called, point will be at the feed headline.

:changed-handler function
     This function gets passed a list of all entries that have been
     handled before, but are now still in the feed and have *changed*
     since last handled (as evidenced by a different sha1 hash).
     When the handler is called, point will be at the feed headline.

:parse-feed function
     This function gets passed a buffer, and should return a list
     of entries, each being a property list containing the
     `:guid' and `:item-full-text' keys.  The default is
     `org-feed-parse-rss-feed'; `org-feed-parse-atom-feed' is an
     alternative.

:parse-entry function
     This function gets passed an entry as returned by the parse-feed
     function, and should return the entry with interesting properties added.
     The default is `org-feed-parse-rss-entry'; `org-feed-parse-atom-entry'
     is an alternative."
  :group 'org-feed
  :type '(repeat
	  (list :value ("" "http://" "" "")
		(string :tag "Name")
		(string :tag "Feed URL")
		(file :tag "File for inbox")
		(string :tag "Headline for inbox")
		(repeat :inline t
			(choice
			 (list :inline t :tag "Filter"
			       (const :filter)
			       (symbol :tag "Filter Function"))
			 (list :inline t :tag "Template"
			       (const :template)
			       (string :tag "Template"))
			 (list :inline t :tag "Formatter"
			       (const :formatter)
			       (symbol :tag "Formatter Function"))
			 (list :inline t :tag "New items handler"
			       (const :new-handler)
			       (symbol :tag "Handler Function"))
			 (list :inline t :tag "Changed items"
			       (const :changed-handler)
			       (symbol :tag "Handler Function"))
			 (list :inline t :tag "Parse Feed"
			       (const :parse-feed)
			       (symbol :tag "Parse Feed Function"))
			 (list :inline t :tag "Parse Entry"
			       (const :parse-entry)
			       (symbol :tag "Parse Entry Function"))
			 )))))