planet(1) [debian man page]

PLANET(1)							    0~bzr116""								 PLANET(1)

NAME

       planet - an aggregate feed generator

SYNOPSIS

       planet [OPTION]... [CONFIGURATION-FILE]

DESCRIPTION

       Planet  Venus  downloads  news  feeds published by web sites and aggregates their content together into a single combined feed, latest news
       first.

       The exit status is 0 for success or 1 for failure.

OPTIONS

       -h, --help
	      display a short help message and exit

       -V, --version
	      display version information and exit

       -v, --verbose
	      verbose logging during update

       -d, --debug
	      debug logging during update

       -o, --offline
	      update from the cache only

       -n, --only-if-new
	      only spider new feeds

       -x, --expunge
	      expunge old entries from cache

       -c, --create=DIRECTORY
	      create a new planet in DIRECTORY

EXAMPLES

       You can create a default planet:

	      planet --create example

       You can build this default planet right away:

	      cd example && planet --verbose planet.ini

       You can test the results in your favourite browser:

	      sensible-browser output/index.html

       The configuration file has more details for customisation:

	      sensible-editor planet.ini

AUTHOR

       Written by Sam Ruby <rubys@intertwingly.net>.

REPORTING BUGS

       Report bugs using the `reportbug' command.

       Copyright 2008, Sam Ruby <rubys@intertwingly.net>

       Licenced under the Python Software Foundation License Version 2.

planet - Planet Venus						   October 2009 							 PLANET(1)

Perlanet::Trait::YAMLConfig(3pm)			User Contributed Perl Documentation			  Perlanet::Trait::YAMLConfig(3pm)

NAME

       Perlanet::Trait::YAMLConfig - configure Perlanet through a YAML configuration file

SYNOPSIS

	  package MyPerlanet;
	  extends 'Perlanet';
	  with 'Perlanet::Traits::YAMLConfig';

	  my $perlanet = MyPerlanet->new_with_config(
	    configfile => 'whatever.yml'
	  );

	  $perlanet->run;

DESCRIPTION

       Allows you to move the configuration of Perlanet to an external YAML configuration file.

   Example Configuration File
	 title: planet test
	 description: A Test Planet
	 url: http://planet.example.com/
	 author:
	   name: Dave Cross
	   email: dave@dave.org.uk
	 entries: 20
	 opml: opml.xml
	 page:
	   file: index.html
	   template: index.tt
	 feed:
	   file: atom.xml
	   format: Atom
	 cache_dir: /tmp/feeds
	 feeds:
	   - url: http://blog.dave.org.uk/atom.xml
	     title: Dave's Blog
	     web: http://blog.dave.org.uk/
	   - url: http://use.perl.org/~davorg/journal/rss
	     title: Dave's use.perl Journal
	     web: http://use.perl.org/~davorg/journal/
	   - url: http://www.oreillynet.com/pub/feed/31?au=2607
	     title: Dave on O'Reillynet
	     web: http://www.oreillynet.com/pub/au/2607

METHODS

   THIRTY_DAYS
       The default length of caching, if caching options are present in the configuration

   get_config_from_file
       Extracts the configuration from a YAML file

AUTHOR

       Oliver Charles, <oliver.g.charles@googlemail.com>

COPYRIGHT AND LICENSE

       Copyright (c) 2010 by Magnum Solutions Ltd.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.14.2							    2012-03-17					  Perlanet::Trait::YAMLConfig(3pm)