The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
WWW-WWWJDIC-0.003
River stage zero No dependents
++
/ WWW::WWWJDIC

NAME

WWW::WWWJDIC - information about online Japanese dictionary WWWJDIC

SYNOPSIS

    use utf8;
    use WWW::WWWJDIC;
    my $wj = WWW::WWWJDIC->new (mirror => 'usa');
    print $wj->lookup_url ('日本'), "\n";

produces output

    http://www.edrdg.org/cgi-bin/wwwjdic/wwwjdic?QMUJ%E6%97%A5%E6%9C%AC_3

(This example is included as synopsis.pl in the distribution.)

VERSION

This documents WWW::WWWJDIC version 0.003 corresponding to git commit 7f6c3e67b624d2ce65bcc79ea139603994053fb5 released on Tue Oct 10 11:58:04 2017 +0900.

DESCRIPTION

Get information about the WWWJDIC online Japanese dictionaries.

FUNCTIONS

get_mirrors

    my %mirrors = get_mirrors ();

Get a list of mirrors of WWWJDIC. The keys are arbitrary identifiers, and the values are the URLs of the mirrors. As of this version, the following sites are available:

australia_melb

http://nlp.cis.unimelb.edu.au/~jwb/cgi-bin/wwwjdic/wwwjdic

australia_monash

http://nihongo.monash.edu/cgi-bin/wwwjdic

canada

http://www.ottix.net/cgi-bin/wwwjdic/wwwjdic

germany

http://wwwjdic.biz/cgi-bin/wwwjdic

japan

http://gengo.com/wwwjdic/cgi-data/wwwjdic

sweden

http://wwwjdic.se/cgi-bin/wwwjdic.cgi

usa

http://www.edrdg.org/cgi-bin/wwwjdic/wwwjdic

METHODS

new

    my $wwwjdic = WWW::WWWJDIC->new (mirror => "japan")

Create the object which extracts the information from WWWJDIC.

The arguments are a hash with the following keys:

mirror

Set the mirror site to use for "lookup_url". The possible values can be obtained from "get_mirrors". If you do not specify a mirror, the current default value is usa.

Please note that mirrors may change or go out of service, and new mirrors may be created. The above mirrors are obtained using the script boot/scrape-json.pl in the git repository. This script is not part of the CPAN distribution.

lookup_url

    my $url = $wwwjdic->lookup_url ($key);

Make a lookup url (the "backdoor URL") which links to a WWWJDIC page. As of version 0.003, this URL goes to the combined dictionary page.

SEE ALSO

WWWJDIC user guide

WWWJDIC Japanese Dictionary Server User Guide

BUGS

  • Mirrors (including the main edrdg one) frequently go out of service.

  • The return value of "lookup_url" may become invalid as WWWJDIC's options are often changed so that different letters and numbers are used to indicate the various dictionaries.

  • There is no way to set the dictionary in "lookup_url".

  • There is no way to get the URL for the plain text output of WWWJDIC.

HISTORY

I started this module as a scraper for the WWWJDIC web site in around 2009. I released it to CPAN in 2017, but with documentation unwritten and with scraper code which no longer worked. Currently the only active use I have for this module is to get the list of mirrors. In version 0.003 I removed the scraper code, leaving only the method "lookup_url" and the function "get_mirrors".

AUTHOR

Ben Bullock, <bkb@cpan.org>

COPYRIGHT & LICENCE

This package and associated files are copyright (C) 2009-2017 Ben Bullock.

You can use, copy, modify and redistribute this package and associated files under the Perl Artistic Licence or the GNU General Public Licence.