Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lblod/frontend-gelinkt-notuleren

Ember frontend of the Gelinkt Notuleren application
https://github.com/lblod/frontend-gelinkt-notuleren

Last synced: 22 days ago
JSON representation

Ember frontend of the Gelinkt Notuleren application

Awesome Lists containing this project

README

        

# frontend-gelinkt-notuleren

This is the Gelinkt Notuleren application implementing the ember-rdfa-editor in the domain of notulen for local governments. For demo purposes, we advise you to run the stack as per https://github.com/lblod/app-gelinkt-notuleren. The following describes the development setup.

## Setting up the backend

Information on setting up the backend can be found at https://github.com/lblod/app-gelinkt-notuleren

## Running the frontend

We advise the use of [edi](https://github.com/madnificent/docker-ember) but have chosen to include the default ember commands to limit confusion.

First make sure you have ember-cli installed

npm install -g ember-cli

Next we clone this repository, install the dependencies, and boot the development server

git clone https://github.com/lblod/frontend-gelinkt-notuleren.git
cd frontend-gelinkt-notuleren

# install the dependencies
npm install

# run the development server
ember s --proxy http://localhost

You can visit the live reloading site at http://localhost:4200

## Configuration via docker environment variables

This frontend can be configured at runtime. It will get the environment variables prefixed by EMBER_ and match them with the variables defined in the frontend's configuration. When the docker container is started it will update /app/index.html to match the provided configuration.

### Analytics through Plausible

Plausible analytics is handled by the [ember-plausible addon](https://github.com/redpencilio/ember-plausible).

* `EMBER_PLAUSIBLE_APP_DOMAIN`: domain the app is deployed on, e.g. "gelinkt-notuleren.vlaanderen.be".
* `EMBER_PLAUSIBLE_API_ENDPOINT`: URL of the Plausible instance to post analytics data, e.g. "https://analytics.mydomain.com"

### authentication through ACM/IDM
* `EMBER_OAUTH_API_KEY`
* `EMBER_OAUTH_BASE_URL`
* `EMBER_OAUTH_REDIRECT_URL`
* `EMBER_OAUTH_LOGOUT_URL`
* `EMBER_OAUTH_SWITCH_URL`

### environment banner

When in a testing or development environment, a banner is shown containing the versions of the application, editor and editor-plugins. This banner is disabled on production.

* `EMBER_ENVIRONMENT_NAME`: name of the environment, appended to the document title. If this string is non-empty, the environment banner is shown. When this string is empty (such as on production), the banner is not shown.
### other
* `EMBER_PUBLICATION_BASE_URL`: url of the linked [publication platform](https://github.com/lblod/app-gn-publicatie/), e.g. "https://publicatie.gelinkt-notuleren.vlaanderen.be/"