Girder GeoBrowser

Requirements

• The Girder Geospatial Plugin

Plugin Installation

pip install girder-geobrowser

Custom Python Commands

setup.py includes 2 custom commands:

• build_ui: This command builds the frontend from the gui folder, and places the build into geobrowser_plugin/external_web_client.
• clean_build: This command cleans the project of the files generated by the previous command.

WARNING

The standalone frontend will be served at /geobrowser if the built front-end path exists (i.e. python setup.py build_ui has been run), or if the mode is not development. So, if running girder serve in development mode, you should see no errors if the frontend is not built. However, if running girder serve in production mode, it will attempt to serve the files, regardless of if they've been built or not, throwing an error through cherrypy if they don't exist.

Custom Girder CLI Commands

This plugin adds a Girder CLI command, extract-geospatial. This command manually runs the Geospatial plugin on any Girder paths specified (defaults to '/'). To specify one or more path, use the -p argument. For example, to run this command on the collections collection1 and collection2, you would run:

girder extract-geospatial -p collection/collection1 -p collection/collection2

Standalone Frontend Setup

Install Yarn

npm install -g yarn

Install Frontend packages

cd gui
yarn install

Compiles and hot-reloads for development

yarn run serve

Compiles and minifies for production

yarn run build

Run your tests

yarn run test

Lints and fixes files

yarn run lint

Customize configuration

See Configuration Reference.