WWW::Eksisozluk version 0.07
============================

This module provides a simple command line interface for eksisozluk,
which is a user-based web dictionary, a famous web site in Turkey since 1999.
You can get "debe" list (list of most voted entries from yesterday) by using
this module.

	use WWW::Eksisozluk;
	my $eksi  = WWW::Eksisozluk->new();
	my @debe  = $eksi->debe_ids();

This will return the entry id's of the online debe list. Element at index 0 will be a the first entry, 1 is second and so on.

You can also get details of an entry by only giving the entry id.

	my %entry = $eksi->entry($debe[0]);

Ideally, you should call these methods from an object. This will return a hash with the values below.

	'id' # is the id of the entry. it was already given by the user.
	'id_link' # is the direct link to the entry.
	'id_ref' # is the id of the reference entry. reference entry is the first entry of the day in the same topic. it might be equal to id.
	'date_accessed' # will show the date-time of the script running.

	'is_found' # will show whether entry is found or not. will return 0 if entry is deleted, or not written yet.

	'topic' # is the topic of the entry.
	'topic_link' # is the link of the topic. can be used for search.
	'number_in_topic' # is the order of the entry in the topic.
			
	'date_published' # is the date-time entry is first published.
	'is_modified' # will show if the entry is modified or not.
	'date_modified' # is the date entry is modified. if it is not modified, will return 0.
	'date_print' # is the human readable date that can be used to print.

	'author' # is the username who wrote the entry.
	'author_link' # is the link of the author.
	'body_raw' # is the raw entry, as downloaded from eksisozluk directly.
	'body' # is the edited entry, several fixes is applied to the raw.
	'fav_count' # is the number that shows the time that entry is marked as favourite.


INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  LWP::UserAgent
  LWP::Protocol::https
  DateTime

ExtUtils::MakeMaker might also be required to run the Makefile.pl.

COPYRIGHT AND LICENCE

Copyright (C) 2014 by Kivanc Yazan

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

The data you reach by using this module might be subject to the
copyright terms of Eksisozluk. See eksisozluk.com for details.