/ 
WWW-Wikipedia-TemplateFiller-0.02
River stage zero No dependents
/ WWW::Wikipedia::TemplateFiller

NAME

WWW::Wikipedia::TemplateFiller - Fill Wikipedia templates with your eyes closed

SYNOPSIS

use WWW::Wikipedia::TemplateFiller;

my $filler = new WWW::Wikipedia::TemplateFiller();

# Bit by bit
my $source = $filler->get( pubmed_id => '2309482' )->fill;
print $source->output;

# Or all at once
print $filler->get( pubmed_id => '2309482' )->fill->output;

# With fill-time options
$source = $filler->get( pubmed_id => '123456' )->fill( add_url => 1 );
print $source->output;

# With output-time (mostly formatting) options
print $source->output( vertical => 1, add_accessdate => 1 );

DESCRIPTION

This module generates Wikipedia template markup for various sources of information such as PubMed IDs, ISBNs, URLs, etc. While it works with multiple templates, it was predominantly created to lower the activation energy associated with filling out citation templates.

In writing a Wikipedia article, one aims to cite sufficient references. The trouble is that there are many different ways of citing different sources, all with different Wikipedia citation templates, and many requiring information that may be difficult to obtain. The initial goal of this module was to streamline the process of generating citation templates. Sure, the module's grown and it's been generalized to other templates (Drugbox, etc.), but the principles persist.

METHODS

new

my $filler = new WWW::Wikipedia::TemplateFiller();

Creates a new template filler.

get

my $source = $filler->get( $source_type => $id, %attrs );

Grabs the requested data from the net and returns it as a source object (actually a subclass of WWW::Wikipedia::TemplateFiller::Source). $source_type is something like pubmed_id, drugbank_id, hgnc_id, isbn, etc. It corresponds to a class in the WWW::Wikipedia::TemplateFiller::Source:: namespace.

$id is the corresponding ID, the format of which varies depending on the value of $source_type. For example, $id is numeric if $source_type is pubmed_id.

%attrs are additional attributes that are passed to the source class used to grab the requested data. Consult WWW::Wikipedia::TemplateFiller::Source for information.

cache

my $cache = $filler->cache;

Returns the cache associated with this filler.

AUTHOR

David J. Iberri, <diberri at cpan.org>

BUGS

Please report any bugs or feature requests to bug-www-wikipedia-templatefiller at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Wikipedia-TemplateFiller. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc WWW::Wikipedia::TemplateFiller

You can also look for information at:

COPYRIGHT & LICENSE

Copyright (c) David J. Iberri, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.