Changes between Initial Version and Version 1 of WikiMarkupInMetadata


Ignore:
Timestamp:
Nov 21, 2012, 5:46:14 AM (12 years ago)
Author:
jesseeichar
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiMarkupInMetadata

    v1 v1  
     1= Extended Regions =
     2
     3|| '''Date''' || 2012/09/14 ||
     4|| '''Contact(s)''' || [http://wiki.osgeo.org/wiki/User:Jeichar Jesse Eichar] ||
     5|| '''Last edited''' || ||
     6|| '''Status''' || Ongoing ||
     7|| '''Assigned to release''' || 2.9.x ||
     8|| '''Resources''' || Ifremer ||
     9|| '''Code''' || https://github.com/jesseeichar/core-geonetwork/compare/master...feature;wiki-editing ||
     10
     11== Overview ==
     12
     13Provide an option to enable wiki-markup text in a selected set of metadata elements. 
     14
     15=== Proposal Type ===
     16 * '''Type''': Improvement
     17 * '''App''': Geonetwork
     18 * '''Module''': Web
     19
     20=== Links ===
     21 
     22 * '''Email discussions''':
     23 * '''IRC discussions''':
     24 * '''Related work''':
     25
     26 
     27=== Voting History ===
     28
     29 * None as yet
     30
     31----
     32
     33
     34== Proposal ==
     35
     36Add 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. 
     37
     38Once 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.
     39
     40To 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.
     41
     42At 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.
     43
     44The services that have been updated are:
     45
     46  - q
     47  - metadata.search
     48  - metadata.search.embeded
     49  - metadata.show
     50  - metadata.show.embedded
     51  - metadata.edit
     52  - metadata.edit.embedded
     53 
     54
     55=== Backwards Compatibility Issues ===
     56
     57none
     58
     59== Risks ==
     60
     61
     62== Participants ==
     63 * As above