Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heremaps/harp-map-editor
Simple map editor for harp.gl map styles
https://github.com/heremaps/harp-map-editor
design harpgl js maps typescript
Last synced: 3 months ago
JSON representation
Simple map editor for harp.gl map styles
- Host: GitHub
- URL: https://github.com/heremaps/harp-map-editor
- Owner: heremaps
- License: apache-2.0
- Archived: true
- Created: 2019-05-24T07:54:18.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-27T07:50:01.000Z (about 2 years ago)
- Last Synced: 2024-07-07T21:04:38.949Z (4 months ago)
- Topics: design, harpgl, js, maps, typescript
- Language: TypeScript
- Homepage: http://heremaps.github.io/harp-map-editor/
- Size: 199 MB
- Stars: 13
- Watchers: 13
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HERE is stopping its engagement on Harp.gl starting 03/01/2022 in favour of a fully productised and production-grade integration of the harp.gl rendering engine into HERE Maps API for JavaScript (https://developer.here.com/develop/javascript-api) All 3D features and many more will be offered via HERE Maps API for JavaScript moving forward.
# @here/harp-map-editor [](https://travis-ci.com/heremaps/harp-map-editor)
## Overview
### A simple online editor for harp.gl themes.
Allows you to create and edit existing themes.
The following features are currently available:
- export and import of themes
- live preview
- style change
- restore page state after page reload
- default themes
- code formatting
- theme source code validation
- code autocompletion
- two window mode
When you run the editor, you should get something similar to the image shown below:
## Development
### Prerequisites
- **Node.js** - Please see [nodejs.org](https://nodejs.org/) for installation instructions.
- **Yarn** - Optional. Please see [yarnpkg.com](https://yarnpkg.com/en/) for installation instructions.
### Download dependencies
Run:
```sh
npm install
```
or
```sh
yarn install
```
to download and install all required packages.
### Launch development server for harp.gl theme editor
Run:
```sh
yarn start
```
To launch `webpack-dev-server`. Open `http://localhost:8080/` in your favorite browser.
To build the editor run:
```sh
yarn build
```
The build result will be in `dist` folder.
### Update gh-pages automatically
In order to update `gh-pages`, you will need to first disable the branch protection, otherwise
TravisCI won't be able to push to that branch.
Increment the package version and then tag your commit, either locally or if the package version has
been updated already, you can make a release in the GitHub UI and it will create the tag. Note, the
tag must be of the form: `vX.X.X`, because this is how travis knows to publish, see `.travis.yml`
This will automatically start the job to publish, go to TravisCI and check the status and make sure
you see something like: `Switched to a new branch 'gh-pages'`
If you have problems, try fixing it manually below.
### Update gh-pages manually
#### Fixing locally
If you have any trouble with the updating of gh-pages, for example the publish works but the deploy
fails, then restarting the job won't work, because npm will complain that the given package already
exists. Deploying to `gh-pages` will then not be executed. To resolve this, go to the root
directory locally, and run (assuming you have a fresh checkout):
- `git checkout master`
- `yarn && yarn build`
- `mv dist/ ..`
- `git checkout gh-pages`
- `cp -r ../dist/* .`
- `git add *` (you may also need to `git rm` some files if `git status` complains)
- `git push origin gh-pages`
- Go to https://github.com/heremaps/harp-map-editor/settings/branches and select `gh-pages`, and re
enable branch protection.
#### Fixing via travis-ci
It is possible to re-run a job with custom yaml, simply remove the `npm publish` step from the
`.travis.yml` and re-run the job.
Check that the changes are visible: https://heremaps.github.io/harp-map-editor/
## License
Copyright (C) 2017-2020 HERE Europe B.V.
See the [LICENSE](./LICENSE) file in the root of this project for license details.