Extended Regions

Date	2012/09/14
Contact(s)	​Jesse Eichar
Last edited
Status	Ongoing
Assigned to release	2.9.x
Resources	Ifremer
Code	​https://github.com/jesseeichar/core-geonetwork/compare/master...feature;wiki-editing

Overview

Provide an option to enable wiki-markup text in a selected set of metadata elements.

Proposal Type

• Type: Improvement
• App: Geonetwork
• Module: Web

Links

• Email discussions:
• IRC discussions:
• Related work:

Voting History

• None as yet

---

Proposal

Add new setting for configuring which type of Markup to support for the installation. By default it will be none (no wiki syntax supported) but the administrator can select one of the options enabling the feature.

Once a markup type is selected then certain elements in metadata will have the element parsed by the markup parser before display. To assist the user, the editors (both old and new) will have a help tip explaining which markup is used and will provide a link to a webpage containing the syntax explanation. In the old UI the element will have a new icon beside the other element buttons (up, down, delete, add) which will show a tool tip when clicked on. The tip will contain the message and link. This give a visual clue that the element can contain markup. In the new edit UI, the tip will be in the Help panel below the other help tips for the element.

To control the fields that can have markup, a new file has been added to each schema's present xsl files and has to be imported by both the profile's metadata.xsl and metadata-view.xsl files. The new file: metadata-markup.xsl contains a template of the "permitMarkup" mode which must return true() for each element that can have markup. For iso19139 the default elements that support markup are: gmd:abstract, gmd:description, gmd:statement, gmd:purpose, gmd:supplementalInformation. In addition to the permitMarkup templates, the dumpFields configuration also has a new attribute markup which (if true) indicate that the element may contain markedup text and there for should be processed before dumping the element.

At the moment the markup languages that are supported are: Confluence, Mediawiki, Textile, Trac Wiki and TWiki. The library used for parsing markup is the org.eclipse.mylyn.wikitext library. Each markup language is a single strategy object that implements the MarkupLanguage interface so if needed addition implementations can be added. The settings simply contains the classname to be instantiated and the translations are as usual in config.xsl. Although there are other strings in strings.xml that are used by the edit user interfaces.

The services that have been updated are:

• q
• metadata.search
• metadata.search.embeded
• metadata.show
• metadata.show.embedded
• metadata.edit
• metadata.edit.embedded

Backwards Compatibility Issues

none

Risks

Participants

• As above