docs: def include_feed(feed_url, *args):
      """
      Parse an RSS or Atom feed and render a given number of its items
      into HTML.
      
      It is **highly** recommended that you use `Django's template
      fragment caching`_ to cache the output of this tag for a
      reasonable amount of time (e.g., one hour); polling a feed too
      often is impolite, wastes bandwidth and may lead to the feed
      provider banning your IP address.
      
      .. _Django's template fragment caching: http://www.djangoproject.com/documentation/cache/#template-fragment-caching
      
      Arguments should be:
      
      1. The URL of the feed to parse.
      
      2. The name of a template to use for rendering the results into HTML.
  
      3. The number of items to render (if not supplied, renders all
         items in the feed).
             
      The template used to render the results will receive two variables:
      
      ``items``
          A list of dictionaries representing feed items, each with
          'title', 'summary', 'link' and 'date' members.
      
      ``feed``
          The feed itself, for pulling out arbitrary attributes.
      
      Requires the Universal Feed Parser, which can be obtained at
      http://feedparser.org/. See `its documentation`_ for details of the
      parsed feed object.
      
      .. _its documentation: http://feedparser.org/docs/
      
      Syntax::
      
          {% include_feed [feed_url] [num_items] [template_name] %}
      
      Example::
      
          {% include_feed "http://www2.ljworld.com/rss/headlines/" 10 feed_includes/ljworld_headlines.html %}
      
      """
      feed = feedparser.parse(feed_url)
      items = []
      
      if len(args) == 2:
          # num_items, template_name
          num_items, template_name = args
      elif len(args) == 1:
          # template_name
          num_items, template_name = None, args[0]
      else:
          raise TemplateSyntaxError("'include_feed' tag takes either two or three arguments")
          
      num_items = int(num_items) or len(feed['entries'])
      for i in range(num_items):
          pub_date = feed['entries'][i].updated_parsed
          published = datetime.date(pub_date[0], pub_date[1], pub_date[2])
          items.append({ 'title': feed['entries'][i].title,
                         'summary': feed['entries'][i].summary,
                         'link': feed['entries'][i].link,
                         'date': published })
      return template_name, { 'items': items, 'feed': feed }