JavaScript Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
client
gulp
local-libs/ace Added turtle editor in mapping edition Jul 12, 2017
scripts Fixed some encoding issues Aug 28, 2017
server Fixed template list permissions Sep 5, 2017
test Syntax is validated if possible when saving mapping Aug 18, 2017
.babelrc
.dockerignore Fixed bug in css Aug 19, 2017
.editorconfig Included Aqua Framework May 30, 2017
.env-sample
.eslintignore First version of template editor Jul 25, 2017
.eslintrc.json fix travis Aug 17, 2017
.gitignore Deleted dbpedia-ontology folder Jul 3, 2017
.travis.yml Test heroku deployment Jun 7, 2017
Dockerfile Fixed Forbiden error Aug 21, 2017
LICENSE Included Aqua Framework May 30, 2017
Procfile Added docker support Aug 17, 2017
README.md Update README.md Aug 21, 2017
config.js Activated github sync on herou Aug 22, 2017
docker-compose.yml Added docker support Aug 17, 2017
docker-set-hosts.sh Host Aug 19, 2017
gulpfile.js Included Aqua Framework May 30, 2017
index.js
manifest.js
package.json
screenshot.png Added screenshot Jul 14, 2017
server.js Connected to stats and template list Aug 16, 2017
start.sh Fixed bug in css Aug 19, 2017

README.md

DBpedia RML Mappings UI

Build Status Heroku

Web application (front and back-end) that provides a user-friendly interface so the DBPedia community can easily view, create and administrate DBPedia mapping rules using RML. It includes users and groups management, mapping list, a powerful RML editor, and integration with the DBPedia Extraction Framework to provide mapping stats, test extractions and many powerful features.

Developed under the "DBPedia Mappings Front-end Administration" GSoC 2017 project.

Based on Aqua Framework.

Installation

The Mappings UI can be run either using Docker (Recommended) or your local system. But, before running, some steps have to be followed:

First of all, clone the project and enter into its directory:

$ git clone https://github.com/dbpedia/mappings-ui
$ cd mappings-ui

Then, copy the sample .env-sample file into .env. That file will be used to store the secrets of the app.

$ cp .env-sample .env
$ vi .env

Edit the file with your own configuration parameters. Please read the ENVIRONMENT VARIABLES wiki page to obtain more details.

After that, edit the config.json file to edit the rest of configuration parameters.

$ vi config.json

Edit only those whose value do not start with process.env. Also, take into account that if you are going to use docker, it will run in production mode, so edit always the production configuration values. Please read the CONFIG FILE wiki page to obtain more details.

Github sync configuration

The Mappings UI is capable of synchronizing the Mappings with a github repository (two-way) and integrate with a WebProtege instance to edit an ontology and push it to a Github repository. If you want to know more details and configure it, please read the Pushing mappings and ontology to Github wiki page.

Running using Docker (Recommended)

To run in Docker, just make sure that you have docker and docker-compose installed, and run:

$ sudo docker-compose build
$ sudo docker-compose up

That's it. You can access the interface via http://localhost:8000 and the MongoDB instance on your local port 27018. See the Default accounts section below to obtain login details.

Running using your local system

To run in your own system, make sure that you have node (v6), npm and mongodb installed. Then, follow these steps:

$ npm install
$ sudo npm install -g gulp  #You need to install gulp globally also
$ gulp build
$ bash start.sh

By default, it is run on development mode. If you want to run the system in production mode, set NODE_ENV variable to production:

$ export NODE_ENV=production

That's it. You can access the interface via http://localhost:8000. See the Default accounts section below to obtain login details.

Running an Extraction Framework instance

A DBpedia Extraction Framework instance is needed to have full functionality (ontology search, validation,...). This instance can be either hosted anywhere else, or in the same host as the Mappings UI. Just make sure that the EXTRACTION_FRAMEWORK_URL variable in your .env file points to it.

To run an instance, just follow these steps:

#Install Extraction Framework
$ mkdir ef
$ cd ef
$ wget https://raw.githubusercontent.com/dbpedia/extraction-framework/rml/Dockerfile
$ sudo docker build -t ef .

#Run Extraction Framework. Execute this each time you want to run it.
$ sudo docker run -p 9999:9999 ef

Default accounts

The first time that the system is executed, some default accounts are created:

user type username password
Administrator root dbpedia
Regular user dbpedia

Please, change those passwords ASAP.