Skip to main content

A package that suggests similar titles to one being added

Project description

Introduction

EEA Similarity is a Plone add-on which provides content suggestions based on similarity scores to a search string. It uses NLP algorithms like TF-IDF (frequency–inverse document frequency) and LSI (Latent Semantic Indexing).

Initial use case is to provide a list of possible duplicates when adding content (based on the entered title).

Installation

zc.buildout

If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:

  • Update your buildout.cfg file:

    [instance]
    ...
    eggs =
      ...
      eea.similarity
    
    zcml =
      ...
      eea.similarity
  • Re-run buildout, e.g. with:

    $ ./bin/buildout

You can skip the ZCML slug if you are going to explicitly include the package from another package’s configure.zcml file.

Getting started

  1. Go to Site Setup > Add-ons and install EEA Similarity

  2. Create IDF index by calling @@create_idf_index Browser view on site root. If you have plone.app.async installed, it will add a daily job to async queue, otherwise you’ll have to setup an external cron job to call this periodically.

  3. Customize settings via Site Setup > EEA Similarity Settings

Dependencies

EEA Similarity has the following dependencies:
  • stemming

  • gensim (which in turn depends on numpy and scipy)

On CentOS you need to install:
  • blas-devel

  • lapack-devel

  • gcc-fortran

On Debian/Ubuntu you need to install:
  • libblas-dev

  • liblapack

  • gfortran

Possible issues with scipy and numpy:

Due to a bug in scipy, it is possible that the packages will not install when running buildout. There are two solutions/options:

  1. Install them with easy_install pip before running the buildout.

  2. Update zc.buildout to version 2.9.0 and activate the wheel support via buildout.wheel and the dependencies will be installed normally.

Source code

Funding

EEA - European Environment Agency (EU)

Changelog

1.5 - (2017-05-22)

  • Upgrade step: Within “Plone > Site setup > Add-ons” click on upgrade button available for EEA Similarity [avoinea refs #84915]

  • Change: Add dedicated async quota for similarity jobs [avoinea refs #84915]

  • Change: fixed PyLint warnings and errors [valipod refs #84949]

1.4 - (2017-04-24)

  • Feature: add control panel option to show suggestions only after a certain title length [valipod refs #84480]

  • Change: updated package information [eduard-fironda]

1.3 - (2017-04-19)

  • Bug fix: fixed issue with the equivalent sets [valipod refs #84294]

  • Feature: added metadata info to the suggestion dialog [valipod refs #84294]

1.2 - (2017-04-14)

  • Bug fix: Remove hard dependency on plone.app.async and eea.versions [avoinea refs #83163]

  • Bug fix: removed hard coded path in the dialog’s javascript [valipod refs #83163]

  • Bug fix: added some defaults to the control panel settings [valipod refs #83163]

  • Bug fix: removed mandatory status for some control panel settings [valipod refs #83163]

1.1 - (2017-04-13)

  • Bug fix: fixed README markup [alecghica refs #82296]

  • Upgrade step: trigger index generation once (/www/create_idf_index) Feature: added index update frequency to the registry settings [valipod refs #83163]

1.0 - (2017-04-12)

  • Feature: related to index and score:
    • moved the index creation to the async instance

    • add similarity score next to object link in dialog

    • [valipod refs #83163]

  • Feature: added to registry settings:
    • equivalent content types sets, use of stopwords, number of shown suggestions

    • max. score difference between suggestions, dialog title and text

    • [valipod refs #83163]

  • Pre-upgrade step: run etc/scripts/prereq.sh on each backend [alecghica refs #82296]

  • Pre-upgrade step: run deploy.sh [alecghica refs #82296]

  • Upgrade step: from control panel instal eea.similarity [valipod refs #82296] [alecghica refs #82296]

  • Feature: Initial release [valipod refs #82296]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

eea.similarity-1.5.zip (59.5 kB view details)

Uploaded Source

File details

Details for the file eea.similarity-1.5.zip.

File metadata

  • Download URL: eea.similarity-1.5.zip
  • Upload date:
  • Size: 59.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for eea.similarity-1.5.zip
Algorithm Hash digest
SHA256 8cf28e1495cf877d141178756eafa3cea421a9a3bad797b756bc9e29911ec13c
MD5 6334681bd7d6119e622b963e13bb0afe
BLAKE2b-256 b9ffbbbe52d9427bb9171ee2e627b4562238b117b18de4a00d4fe7592fe3701a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page