Skip to content

This is a sample search application with faceting for the eXist-db Open Source XML Database managing SKOS glossaries

Notifications You must be signed in to change notification settings

easymetahub/emh-exist-glossary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EasyMetaHub Glossary for an eXist-db project

Introduction

This application is a SKOS glossary manager and faceted search application that can manage multiple glossaries. It is intended for organizations that need to manage one or more glossaries.

There a many projects out there that do not require the power of MarkLogic and the licensing fees for it as well.
http://history.state.gov is one such project. It has been using eXist-db as its hosting platform.

It was created as an easily customizable search application. It abstracts out the common code for faceted search and gives an easy development interface to customize for uses other than a glossary manager.

About the author

Loren Cahlander is the creator of this tool and the sister glossary application for MarkLogic.

Consulting

EasyMetaHub is available for consulting in developing your own customization of this tool.

Development

Requirements

Building

In the root directory of the application run:

gradle buildXAR

The build is in the build directory.

Customization

The customizations for this project template are in:

  • src/main/xquery/modules/custom/custom.xqm
  • src/main/resources/collection.xconf
  • src/main/polymer/src/emh-accelerator-app/result-item.js

Basic installation and getting started is here:

Download version 5 of eXist-db following the instructions here: http://exist-db.org/exist/apps/doc/basic-installation

Version 5 of eXist-db is required for the faceting feature.

The initial view when you open your browser to http://localhost:8080 is:

images/eXist-start.png

Click login and usee the username admin with no password.

images/login.png

You will then see the page

images/launcher-1.png

Select the 'Package Manager'

images/package-manager.png

Click on 'Upload' and select emh-glossary-0.8.0.xar

images/package-upload.png

The EMH Glossary shows up in the installed list.

images/package-manager-2.png

Close the dialog and you will get this:

images/emh-glossary-00.png

Type Galaxy in the search bar.

images/emh-glossary-01.png

You can then select a facet to narrow the search results. You can also expand a result item by selecting Show Details

images/emh-glossary-02.png

If you select one of the buttons for Related, Broader, or Narrower, then you will be hyperlinked to that Concept

images/emh-glossary-03.png

Authentication and Authorization

This glossary manager in searchable as a guest. In order to manage the glossaries, then you need to go the the Administration screen. Click on HELLO GUEST.

images/emh-glossary-04.png

This page shown the user as logged in.

images/emh-glossary-05.png

Click on the username to get details of the user.

images/emh-glossary-06.png

The details about the user show up in a dialog, including the groups that the user is part of.

images/emh-glossary-07.png

Administration

In order to go to the administration screen, you need to be logged in as part of the emh group and click on the gear icon.

images/emh-glossary-08.png

This page shows the list of glossaries that are loaded and the ability to load more glossaries.

images/emh-glossary-10.png

You can delete a glossary by clicking on the trash can by the name. You can add glossaries by uploading RDF files containing either SKOS or SKOS-XL.

Sample glossaries can be found here: https://github.com/easymetahub/emh-exist-glossary/tree/master/samples

Click on the chevron next tothe Administration header to return the the search page.

Donation

If you find this template application useful, then I would appreciate a contribution to the development through PayPal to loren.cahlander@easymetahub.com