===========
EEA Alchemy
===========
Auto-discover geographical coverage, temporal coverage and keywords from
documents common metadata (title, description, body, etc) and auto highlight
keywords within a page content based on selected tags.


Contents
========

.. contents::


Introduction
============
This tool allows Plone managers to auto-discover and fix subject keywords,
location and temporal coverage using http://www.alchemyapi.com/ web service.


Main features
=============

- Auto-discover keywords, locations and temporal coverage;
- Auto highlight keywords within a page content based on selected
  tags and link them to a custom search page.


Planed features
===============

- Add a wizard icon near Subject, Location, etc fields in edit form
  to auto-discover and suggest tags based on text in
  other fields (Title, Description)


Install
=======

- Add eea.alchemy to your eggs section in your buildout and re-run buildout. You
  can download a sample buildout from
  https://github.com/collective/eea.alchemy/tree/master/buildouts/plone4
- Install eea.alchemy within Site Setup > Add-ons


Getting started
===============

Auto discover keywords, location or temporal coverage
-----------------------------------------------------

1. Get your alchemy key here: http://www.alchemyapi.com/api/register.html
2. Update your alchemy API key within Site Setup > Alchemy Settings
3. Within Plone Control panel go to Alchemy Discoverer.

Auto tagging
------------

1. *Enable auto-tagging* within **Site Setup > Alchemy Settings**
2. Edit your document and add some tags for it within **/edit > Categorization.**
   For example, if you're writing a news article about *water pollution* go to
   **/edit > Categorization** and add *water pollution* within tags field
   (also known as *keywords*, *subjects*, *topics*).
   Now when you navigate to the **View** page of this article,
   you'll notice that all occurrences of *water pollution* within your news
   article body are links to a custom search page which is also configurable
   within **Alchemy Settings ControlPanel**

Source code
===========

Latest source code (Plone 4 compatible):
  https://github.com/collective/eea.alchemy

Plone 2 and 3 compatible:
  https://github.com/collective/eea.alchemy/tree/plone25

Copyright and license
=====================
The Initial Owner of the Original Code is European Environment Agency (EEA).
All Rights Reserved.

The EEA Alchemy (the Original Code) is free software;
you can redistribute it and/or modify it under the terms of the GNU
General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later
version.

More details under docs/License.txt


Funding
=======

EEA_ - European Environment Agency (EU)

.. _EEA: http://www.eea.europa.eu/
