VocBench System Settings

Introduction

The Settings Management page of Semantic Turkey docs details most of the information regarding settings and preferences in the platform. Here we provide a listing of specific properties which need to be setup under the hood, as there is (currently) no counterpart in the UI of the system.

Language Definitions

Semantic Turkey comes with a default definition list of languages that can be shown in different options: editing languages per each project, language proficiencies of the users, language for showing the content, etc... Each of these options restricts the set of languages that can be chosen by users, adopted in projects etc.. but no language can be ever selected if it has not been by first declared in this definition list.

Everything about the definition list is provided in the Settings Management page of Semantic Turkey docs, section: "Available Languages: definition list in the defaults of the "languages" project property".

Home page customization

Vocbench, by default, comes with a clean home page that consists of a top navigation bar, a bottom footer and a middle section containing the application logo flanked by a brief description of what Vocbench is.

Home page

Vocbench provides a basic customization of the middle section, in particular it allows for adding custom content to the blank section between the application description and the footer.

Note: this procedure requires a system administrator to have access to the filesystem of the Vocbench installation. Furthermore, since it is necessary to manipulate the content of Vocbench .war, this procedure can be performed only if the web archive has been extracted and deployed on a separate HTTP server as described here.
A further way to customize the web page from the Vocbench UI is described here. The method described in this section is more thought for unchangeable custom content that should distinguish a certain VB installation (e.g. logo of the organization etc..) while the latter is thought more for dynamic content (e.g. communications to all users) that might be changed by the VB administrator.

The <VOCBENCH_INST_ROOT>/assets/ext/home/ directory contains the file custom_content.html, containing a brief description of how to customize the home page. This description is already formatted as (commented) HTML code and might represent custom content itself. The administrator can directly edit this content.

      
<!-- <div style="overflow-y: auto;">
	<h1>This is a custom content</h1>

	<p>
		This document can be edited in order to insert a custom content in the home page of VocBench.
		The content will be inserted in the central section of the page, just between the brief description of VocBench (on the top)
		and the footer that contains the organizations that contributed to VocBench.
		In order to try this feature, you can uncomment the content of this document and see how the home page changes.
	</p>

	<p>
		The container <code><div/></code> element has the <code>"overflow-y: auto"</code> style
		applied in order to make the content responsive through a vertical scrollbar in case the available space is exceeded.
	</p>

	<p>
		It is also possible to insert images simply by adding them to the assets/ext/home/ folder and to use them as follow:
	</p>

	<img src="./assets/ext/home/example.png">
</div> -->
    

For example, uncommenting the above code, the home page will be shown as follow

Home page custom

Privacy Statement

VocBench provides, to the organizations that wish to, the opportunity to publish a privacy statement document for users to download and read.

This procedure requires a system administrator to have access to the filesystem of the SemanticTurkey installation. In fact, it is necessary to place the privacy statement file, which must be named privacy_statement.pdf, in the path %ST_DATA_FOLDER%/system/docs/, so usually something like:

SemanticTurkeyData\system\docs\privacy_statement.pdf

Once such file is added, in the bottom right section of the page (just above the footer), a download link is visible. It is also added a new entry Privacy statement in the About VocBench dropdown menu on the top right corner.

Privacy statement