www::wikipedia(3pm) [debian man page]
WWW::Wikipedia(3pm) User Contributed Perl Documentation WWW::Wikipedia(3pm) NAME
WWW::Wikipedia - Automated interface to the Wikipedia SYNOPSIS
use WWW::Wikipedia; my $wiki = WWW::Wikipedia->new(); ## search for 'perl' my $result = $wiki->search( 'perl' ); ## if the entry has some text print it out if ( $result->text() ) { print $result->text(); } ## list any related items we can look up print join( " ", $result->related() ); DESCRIPTION
WWW::Wikipedia provides an automated interface to the Wikipedia <http://www.wikipedia.org>, which is a free, collaborative, online encyclopedia. This module allows you to search for a topic and return the resulting entry. It also gives you access to related topics which are also available via the Wikipedia for that entry. INSTALLATION
To install this module type the following: perl Makefile.PL make make test make install METHODS
new() The constructor. You can pass it a two letter language code, or nothing to let it default to 'en'. ## Default: English my $wiki = WWW::Wikipedia->new(); ## use the French wiki instead my $wiki = WWW::Wikipedia->new( language => 'fr' ); WWW::Wikipedia is a subclass of LWP::UserAgent. If you would like to have more control over the user agent (control timeouts, proxies ...) you have full access. ## set HTTP request timeout my $wiki = WWW::Wikipedia->new(); $wiki->timeout( 2 ); You can turn off the following of wikipedia redirect directives by passing a false value to "follow_redirects". language() This allows you to get and set the language you want to use. Two letter language codes should be used. The default is 'en'. my $wiki = WWW::Wikipedia->new( language => 'es' ); # Later on... $wiki->language( 'fr' ); follow_redirects() By default, wikipeda redirect directives are followed. Set this to false to turn that off. search() Which performs the search and returns a WWW::Wikipedia::Entry object which you can query further. See WWW::Wikipedia::Entry docs for more info. $entry = $wiki->search( 'Perl' ); print $entry->text(); If there's a problem connecting to Wikipedia, "undef" will be returned and the error message will be stored in "error()". random() This method fetches a random wikipedia page. error() This is a generic error accessor/mutator. You can retrieve any searching error messages here. TODO
o Clean up results. Strip HTML. o Watch the development of Special:Export XML formatting, eg: http://en.wikipedia.org/wiki/Special:Export/perl SEE ALSO
o LWP::UserAgent AUTHORS
Ed Summers <ehs@pobox.com> Brian Cassidy <bricas@cpan.org> COPYRIGHT AND LICENSE
Copyright 2003-2011 by Ed Summers This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2011-04-05 WWW::Wikipedia(3pm)
Check Out this Related Man Page
WWW::Mediawiki::Client::Exceptions(3pm) User Contributed Perl Documentation WWW::Mediawiki::Client::Exceptions(3pm) NAME
WWW::Mediawiki::Client::Exception - exception handling for WWW::Mediawiki::Client SYNOPSIS
use WWW::Mediawiki::Client::Exception; use Data::Dumper; # throw eval { WWW::Mediawiki::Client::LoginException->throw( error => 'Something bad happened', res => $res, cookie_jar => $cookie_jar, ); }; # catch if (UNIVERSAL::isa($@, 'WWW::Mediawiki::Client::LoginException') { print STDERR $@->error; print Dumper($@->res); } DESCRIPTION
A base class for WWW::Mediawiki::Client exceptions. SUBCLASSES
WWW::Mediawiki::Client::URLConstructionException Indicates a problem with the URL with which we to the Mediawiki server. WWW::Mediawiki::Client::AuthException Indicates a problem with the provided authentication information WWW::Mediawiki::Client::LoginException Indicates that login failed for an unknown reason Fields: res For the apache response object returned by the attempt to log in. cookie_jar For the cookie jar which was returned by the attempt to log in. WWW::Mediawiki::Client::CookieJarException Something went wrong saving or loading the cookie jar WWW::Mediawiki::Client::FileAccessException Something went wrong saving or loading a file WWW::Mediawiki::Client::FileTypeException The file which we attempted to operate on is not a .wiki file WWW::Mediawiki::Client::AbsoluteFileNameException The file which we attempted to operate on is not a .wiki file WWW::Mediawiki::Client::CommitMessageException There is a problem with the commit message WWW::Mediawiki::Client::CommitException Something went wrong while committing a change WWW::Mediawiki::Client::PageDoesNotExistException There is no such page, either here or on the server WWW::Mediawiki::Client::UpdateNeededException The page on the server has changed since the local file was last updated WWW::Mediawiki::Client::ConflictsPresentException An attempt was made to commit a file containing conflicts WWW::Mediawiki::Client::CorruptedConfigFileException The configuration file cannot be parsed. WWW::Mediawiki::Client::ServerPageException Something went wrong fetching the server page. Throws: res The apache response object which was returned in the attempt to fetch the page. WWW::Mediawiki::Client::ReadOnlyFieldException Client code tried to set a read-only field. SEE ALSO
Exception::Class AUTHORS
Mark Jaroski <mark@geekhive.net> Author Bernhard Kaindl <bkaindl@ffii.org> Inspired the improvement in error handling and reporting. LICENSE
Copyright (c) 2004 Mark Jaroski. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2011-02-12 WWW::Mediawiki::Client::Exceptions(3pm)