Products.PloneGlossary 1.4.0

4.1 Installing PloneGlossary

[instance]
recipe = plone.recipe.zope2instance
...
eggs =
    ...
    Products.PloneGlossary

$ cd $BUILDOUT_HOME/src
$ svn co \
https://svn.plone.org/svn/collective/Products.PloneGlossary/trunk \
Products.PloneGlossary
$ cd Products.PloneGlossary
$ python setup.py develop

[buildout]
...
develop =
    ...
    src/Products.PloneGlossary

4.2 Plone Unicode issue

If you use an old version of Plone (< 3.2), you’ll encounter this issue: using non ASCII characters in your glossary requires to change the default encoding of your Zope.

To do this, add a sitecustomize.py file to your $SOFTWARE_HOME with these two lines:

import sys
sys.setdefaultencoding('utf-8')

Then replace “utf-8” above with the value of the “default_charset” property in your “portal_properties/site_properties”.

4.3 Upgrades

Visit in ZMI the portal_setup object of your site, click Upgrades and select Products.PloneGlossary:default.

If you’re upgrading from PloneGlossary 1.2 or older you may force upgrades using “Show old upgrades”.

5.1 Add a glossary portlet

Use the portlets manager to display a portlet of all definitions found in the displayed content.

5.2 zope.conf tweaks (optional)

PloneGlossary assumes that your site charset is UTF-8. As this charset must be known very early in Zope startup, we cannot always use the charset in the properties of your Plone site.

PloneGlossary views have a batch size of 30 terms. You might prefer another size.

If the Plone sites of your instance use another charset, or if you need another batch size, you might append this to your zope.conf:

<product-config ploneglossary>
  charset iso-8859-15 # Or any valid charset that suits your needs.
  batch-size 40 # Or any positive integer you might prefer.
</product-config>

5.3 The Glossary configlet

Highlight content: if this option is chosen, all defined words are hightlighted in the chosen content types (see further).

Description length : Choose the maximum length of the given definition in the highlights.

Description ellipsis: Choose an ellipsis. It is used in the highlight when the defined term exceeds the description length.

Not highlighted tags: Define the html tags in which definitions should not be highlighted. Default: h1, a, input, textarea

Allowed portal types: Select the portal types for which defined words are highlighted.

Use glossaries globally for all content?: When checked, all glossaries will be used to highlight terms globally for all of the site’s content. By unchecking this option, only the first glossary found while traversing upwards from the content is used.

General glossaries: Select glossaries used to check related terms of content.

5.4 Additional tools

PloneGlossaryTool

A tool is installed by the installer. It provides a few configuration options so that you can customize and manage your glossaries.

10.1 Developers

• Cyrille Lebeaupin

• Bertrand Mathieu

• Maik Roeder

• Gilles Lenfant

10.2 Translations

• French (fr): Ingeniweb

• Czech (cs): Lukas Zdych

• Danish (da): Anton Stonor

• German (de): Lukas Zdych

• Polish (pl): Piotr Furman

• Spanish (es): Héctor Velarde

10.3 1.4.0 - 2009-12-04

• Fix upgrade step version. [kdeldycke] 2009-04-29

• Refactor to avoid errors in tests tearDown [tdesvenain]

• Fix portlet’s <span> HTML tags to please IE6 (see http://dev.plone.org/plone/ticket/9027 for details). [kdeldycke] 2009-05-06

10.4 1.4.0 RC2 - 2008-09-22

• Upgrades moved to the GenericSetup way, and removed (useless) “Migration” tab. [glenfant]

• i18n of schemas using message factory. [glenfant]

• Fixed test fixtures and associated GS profile. [glenfant]

• Added metadata.xml to profiles, provision for future upgrades. [glenfant]

• Fixed sorting of terms in glosary view using unicode normalization. [glenfant]

• Eggification. [glenfant]

• Added “add permissions” for content types instead of generic “Add portal content” [bmathieu]

• Using unicode normalization to get first letter of the term. This allows to find terms starting with non-ascii characters. [naro]

• use the standard PropertyManager API to handle properties on the tool [wichert]

• clean up imports and remove some unneeded bbb code to make pyflakes happy [wichert]

• improve the English wording in a few places [wichert]

10.5 1.4.0 RC1

• Using Zope 3 “page” technology to speed up complex templates [glenfant]

• Using KSS style views for fast edit. [glenfant]

• Full GenericSetup installation [glenfant]

• Changed portlet into Plone 3 style [glenfant]

• Fixed unit tests (new worflow doesn’t allow anon to grab into glossary) [glenfant]

• Adding a /browser for new style views [glenfant]

• Fix bug causing html entities in definition title/description to appear as entity code instead of char ( ie. &amp; instead of & )

• Install: check for scripts/CSS before registering them

• Added support for Generic setup for the main tool

• Refactored as it can be overloaded

• Manages many types of glossaries

• Added interfaces

• Added test environment

• Don’t set to debug in config.py by default. [roeder] Otherwise there would be a bogus content type cluttering up portal_types.

• Batch navigation in glossary view added [roeder]

• Fixed highlighting : all glossaries are used if no glossary explicitly selected

• Added czech translation (Lukas Zdych)

• Added a patch for ZCTextIndex _apply_index method: search terms with synonymous found in global glossaries are replaced by an equivalent “OR”. By default this is done only for ‘SearchableText’ . This patch is disabled by default (see config.py). [bmathieu]

• Fill portlet by template construct instead of javascript [bmathieu]

• Dropped plone 2.0 compatibility: use css and javascript registries. Portlet structure complies with plone 2.1/2.5 standard structures. Improved: highlight definitions whether portlet is displayed or not. [bmathieu]

• Configure Glossary and Definitions to be managed by portal_factory [bmathieu]

• Added support for rename after creation for glossary and definition contents [bmathieu]

• Added german translation thanks to Richard M. Kues

• Added spanish translation thanks to Hector Velarde

• Added share tabs [zegor]

10.6 1.3.3 - 2006-03-01

• Added a screenshot in the docs folder

• Added polish translation thanks to Piotr Furman

• Fixed a problem in htm2text. Carriage returns were not interpreted as white space. This resulted in combined words to be merged. For example: “<div>plonernglossary</div>” -> “ploneglossary” instead of “plone glossary”.

10.7 1.3.2 - 2006-01-06

• Added ‘alpha_sort’ parameter on tool.getObjectRelated*, for getting terms sorted by title [b_mathieu] 2006-02-06

• In encode ascii function, normalize char by char, to make sure unicode string has the same length as ascii string

• Added functionality to allow true local glossaries. It includes a config setting in the configlet. [ender] 2006-01-30

• Changed the definition view so that it also shows the variants. [ender] 2006-01-30

10.8 1.3.1 2006-01-30

• Fix bug in encode ascii method

• For AT content, analyse only string and text fields

10.9 1.3 2006-01-24

• Variants of a word can now be defined.

10.10 1.3 RC2 - 2006-01-06

• Fix highlight script. The position of word to highlight was erroneous.

10.11 1.3 RC1 - 2006-01-05

• Object words with accents are highlighted even if the glossary term is a little bit different

• Improve find_word function

• Changed Title and Description indexes to be ZCTextIndex based.

• Added a special latin lexicon class. The lexicon is initialized when adding the GlossaryCatalog and used by the ZCTextIndex indexes.

• Use the same normalizer of lexicon to parse SearchableText

• Add method rebuildCatalog on PloneGlossary to rebuild all glossary catalog

• Update javascript highlighting words to work on Firefox and IE

• Fixed access problem to glossary’s catalogs for anonymous users - [zegor]

• Use AddPortalContent permission to add Glossary and definitions

10.12 1.1 - 2005-09-05

• Remove highlight for input or textarea tags

• Check permissions in plone glossary portlet