Skip to content

Reusable configuration files and UI templates for registry installations

License

Notifications You must be signed in to change notification settings

BRGM/registry-config-base

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

registry-config-base

Provides configuration, UI templates and bootstraping for a starting registry installation.

Custom installations can fork this repository then customize the configuration and UI files. This makes it possible to pull in an merge upstream UI fixes made in this base repository.

N.B. Requires registry-core 1.2.0 or higher

Layout

Directory Role
ldregistry A starting set of configuration files and templates which should be install in /opt/ldregistry on the target system. For details of the role of these files see Configuration
install Files used to configure the front end nginx proxy
scripts Example installation scripts

Customizing the configuration

The base configuration is based on the UK Government Environment registry.

Files in ldregistry which may require customization are:

File Role
templates Velocity templates which implement the registry UI, particular targets for customization are ...
templates/about.vm Provides descriptive information on the registry instance
ui/assets Style sheets and associated javascript and images, the ones here are based on bootstrap3
boot Initial register contents
config Configuration files for the registry instance see Configuration

Change notes - July 2016

A substantial restructuring of the UI templates has been completed. The key changes are:

  • Moved UI assets to subdirectory ui/assets. This makes it easier to configure the front end web server to serve the static assets directly, with only the ui templates being served from tomcat.

  • Updated default look and feel to be more consistent with, but not infringe, gov.uk styling. This is created using sass to customize bootstrap 3.3.6. The new subdirectory ui-customize contains the sass scripts and instructions for regenerating the styling.

  • Restructure the UI templates to split into smaller, more maintainable parts with more consistent naming convention. In particular all top level pages are in the root directory, the elements that application to all pages are in templates/structure, all templates that are intended to be included within a parent template ("partials" in Rails terminology) start with "_".

  • Simplified the default UI:

    • splitting the "admin" tab into separate "actions" and "administrators"
    • flattening the "registration" action
    • move some actions to "advanced" menu
    • improved "create register" dialog to include metadata annotation These are aimed a supporting common operations where a register might be manually created but most content is upload from CSV (or maybe jsonld or ttl files) with "patch" mode being a good universal default.

The templates are structured as follows:

Template Role
templates/ All top level page templates
templates/main.vm All normal page renders go through this, if it is the landing page it displays the category based view (templates/main/_page-category.vm), otherwise it normally displays a register or item (templates/main/_item-render.vm)
templates/structure Elements used on every page to provide the header (_header.vm), optional status bar (_service-bar.vm) and footer (_footer.vm). A standard page normally starts with a sequence of header, navbar and status bar via _preamble.vm.
templates/nav Partials used to render the navigation bar
templates/main Partials used for the main pages, in particular all the pieces that make up the default register/item view
templates/action Templates used for the various actions (whether on the navbar menus or in the admin tab). The convention is that _{action}.vm renders the link which can be used to invoke {action} then _{action}-dialog.vm or _{action}-page.vm render the UI for carrying out the action either as an inline modal (dialog) or as a separately page (page). The macros #startActionSection, #action and #endActionSection are used to render the actions tab and keep track of which actions are available so which dialogs need to be included. The macro #renderDialogs then includes the required dialog partials.

About

Reusable configuration files and UI templates for registry installations

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 62.7%
  • CSS 33.9%
  • SCSS 1.7%
  • Other 1.7%