mirror of
https://github.com/a-nyx/maputnik-with-pmtiles.git
synced 2024-12-27 09:15:29 +01:00
update readme
This commit is contained in:
a-nyx
parent
b7838ad6e1
commit
a65a2bd1da
1 changed files with 1 additions and 160 deletions
161
README.md
161
README.md
|
|
@ -1,160 +1 @@
|
||||||
<img width="200" alt="Maputnik logo" src="https://cdn.jsdelivr.net/gh/maputnik/design/logos/logo-color.png" />
|
This is a fork of [maputnik/editor](https://github.com/maputnik/editor) which is "An open source visual editor for the 'Mapbox Style Specification'". In this fork, `pmtiles` protocol has been added to `maplibregl` so that the editor should work also with [Protomaps](https://docs.protomaps.com/).
|
||||||
|
|
||||||
# Maputnik
|
|
||||||
[][github-action-ci]
|
|
||||||
[][license]
|
|
||||||
|
|
||||||
[github-action-ci]: https://github.com/maputnik/editor/actions?query=workflow%3Aci
|
|
||||||
[license]: https://tldrlegal.com/license/mit-license
|
|
||||||
|
|
||||||
A free and open visual editor for the [MapLibre GL styles](https://maplibre.org/maplibre-style-spec/)
|
|
||||||
targeted at developers and map designers.
|
|
||||||
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
- :link: Design your maps online at **<https://maputnik.github.io/editor/>** (all in local storage)
|
|
||||||
- :link: Use the [Maputnik CLI](https://github.com/maputnik/editor/wiki/Maputnik-CLI) for local style development
|
|
||||||
- In a Docker, run this command and browse to http://localhost:8888, Ctrl+C to stop the server.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
docker run -it --rm -p 8888:8888 maputnik/editor
|
|
||||||
```
|
|
||||||
|
|
||||||
## Donations
|
|
||||||
Mapbox has built one of the best and most amazing OSS ecosystems. A key component to ensure its longevity and independence is an OSS map designer.
|
|
||||||
If you or your organisation has seen value from Maputnik, please consider donating at <https://maputnik.github.io/donate>
|
|
||||||
|
|
||||||
## Documentation
|
|
||||||
|
|
||||||
The documentation can be found in the [Wiki](https://github.com/maputnik/editor/wiki). You are welcome to collaborate!
|
|
||||||
|
|
||||||
- :link: **Study the [Maputnik Wiki](https://github.com/maputnik/editor/wiki)**
|
|
||||||
- :video_camera: Design a map from Scratch https://youtu.be/XoDh0gEnBQo
|
|
||||||
|
|
||||||
[](https://youtu.be/XoDh0gEnBQo)
|
|
||||||
|
|
||||||
## Develop
|
|
||||||
|
|
||||||
Maputnik is written in ES6 and is using [React](https://github.com/facebook/react) and [MapLibre GL JS](https://maplibre.org/projects/maplibre-gl-js/).
|
|
||||||
|
|
||||||
We ensure building and developing Maputnik works with the [current active LTS Node.js version and above](https://github.com/nodejs/Release#release-schedule).
|
|
||||||
|
|
||||||
Install the deps, start the dev server and open the web browser on `http://localhost:8888/`.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# install dependencies
|
|
||||||
npm install
|
|
||||||
# start dev server
|
|
||||||
npm run start
|
|
||||||
```
|
|
||||||
|
|
||||||
If you want Maputnik to be accessible externally use the [`--host` option](https://webpack.js.org/configuration/dev-server/#devserverhost):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# start externally accessible dev server
|
|
||||||
npm run start -- --host 0.0.0.0
|
|
||||||
```
|
|
||||||
|
|
||||||
The build process will watch for changes to the filesystem, rebuild and autoreload the editor. However note this from the [webpack-dev-server docs](https://webpack.js.org/configuration/dev-server/):
|
|
||||||
|
|
||||||
> webpack uses the file system to get notified of file changes. In some cases this does not work. For example, when using Network File System (NFS). Vagrant also has a lot of problems with this. ([snippet source](https://webpack.js.org/configuration/dev-server/#devserverwatchoptions-))
|
|
||||||
|
|
||||||
To enable polling add `export WEBPACK_DEV_SERVER_POLLING=1` to your environment.
|
|
||||||
|
|
||||||
```
|
|
||||||
npm run build
|
|
||||||
```
|
|
||||||
|
|
||||||
Lint the JavaScript code.
|
|
||||||
|
|
||||||
```
|
|
||||||
# run linter
|
|
||||||
npm run lint
|
|
||||||
npm run lint-styles
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Tests
|
|
||||||
For testing we use [webdriverio](https://webdriver.io) and [selenium-standalone](https://github.com/webdriverio/selenium-standalone).
|
|
||||||
|
|
||||||
[selenium-standalone](https://github.com/webdriverio/selenium-standalone) starts a server that will launch browsers on your local machine. You need to have Java installed on your machine as well as *chrome* or *firefox*.
|
|
||||||
|
|
||||||
Now open a terminal and run the following using *chrome*:
|
|
||||||
|
|
||||||
```
|
|
||||||
npm run test
|
|
||||||
```
|
|
||||||
or *firefox*:
|
|
||||||
```
|
|
||||||
BROWSER=firefox npm run test
|
|
||||||
```
|
|
||||||
|
|
||||||
After some time you should see a browser launch which will be automated by the test runner.
|
|
||||||
|
|
||||||
|
|
||||||
## Related Projects
|
|
||||||
|
|
||||||
- [maputnik-dev-server](https://github.com/nycplanning/labs-maputnik-dev-server) - An express.js server that allows for quickly loading the style from any mapboxGL map into mapuntnik.
|
|
||||||
|
|
||||||
## Sponsors
|
|
||||||
|
|
||||||
Thanks to the supporters of the **[Kickstarter campaign](https://www.kickstarter.com/projects/174808720/maputnik-visual-map-editor-for-mapbox-gl)**. This project would not be possible without these commercial and individual sponsors.
|
|
||||||
|
|
||||||
### Gold
|
|
||||||
|
|
||||||
- [Wemap](https://getwemap.com/)
|
|
||||||
- [Orbicon Informatik](https://www.orbiconinformatik.dk/)
|
|
||||||
- [Terranodo](http://terranodo.io/)
|
|
||||||
|
|
||||||
<a href="https://getwemap.com/">
|
|
||||||
<img width="33%" alt="Wemap" style="display:inline" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/wemap.jpg" />
|
|
||||||
</a>
|
|
||||||
<a href="http://terranodo.io/">
|
|
||||||
<img width="33%" alt="Terranodo" style="display:inline" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/terranodo.png" />
|
|
||||||
</a>
|
|
||||||
<a href="https://www.orbiconinformatik.dk/">
|
|
||||||
<img width="32%" alt="Terranodo" style="display:inline" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/orbicon_informatik.png" />
|
|
||||||
</a>
|
|
||||||
|
|
||||||
<br/>
|
|
||||||
|
|
||||||
### Silver
|
|
||||||
|
|
||||||
- [Klokan Technologies](https://www.klokantech.com/)
|
|
||||||
- [Geofabrik](http://www.geofabrik.de/)
|
|
||||||
- [Dreipol](https://www.dreipol.ch/)
|
|
||||||
|
|
||||||
<a href="https://www.klokantech.com/">
|
|
||||||
<img width="18%" alt="Klokan Technologies" style="display:inline-block" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/klokantech.png" />
|
|
||||||
</a>
|
|
||||||
<a href="http://www.geofabrik.de/">
|
|
||||||
<img width="18%" alt="Geofabrik" style="display:inline-block" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/geofabrik.png" />
|
|
||||||
</a>
|
|
||||||
<a href="https://www.dreipol.ch/">
|
|
||||||
<img width="18%" alt="Dreipol" style="display:inline-block" src="https://cdn.jsdelivr.net/gh/maputnik/editor@1.5.0/media/sponsors/dreipol.png" />
|
|
||||||
</a>
|
|
||||||
|
|
||||||
<br/>
|
|
||||||
|
|
||||||
### Individuals
|
|
||||||
|
|
||||||
**Influential Stakeholder**
|
|
||||||
|
|
||||||
Alan McConchie, Odi, Mats Norén, Uli [geOps](http://geops.ch/), Helge Fahrnberger ([Toursprung](http://www.toursprung.com/)), Kirusanth Poopalasingam
|
|
||||||
|
|
||||||
**Stakeholder**
|
|
||||||
|
|
||||||
Brian Flood, Vasile Coțovanu, Andreas Kalkbrenner, Christian Mäder, Gregor Wassmann, Lee Armstrong, Rafel, Jon Burgess, Lukas Lehmann, Joachim Ungar, Alois Ackermann, Zsolt Ero, Jordan Meek
|
|
||||||
|
|
||||||
**Supporter**
|
|
||||||
|
|
||||||
Sina Martinelli, Nicholas Doiron, Neil Cawse, Urs42, Benedikt Groß, Manuel Roth, Janko Mihelić, Moritz Stefaner, Sebastian Ahoi, Juerg Uhlmann, Tom Wider, Nadia Panchaud, Oliver Snowden, Stephan Heuel, Tobin Bradley, Adrian Herzog, Antti Lehto, Pascal Mages, Marc Gehling, Imre Samu, Lauri K., Visahavel Parthasarathy, Christophe Waterlot-Buisine, Max Galka, ubahnverleih, Wouter van Dam, Jakob Lobensteiner, Samuel Kurath, Brian Bancroft
|
|
||||||
|
|
||||||
## License
|
|
||||||
|
|
||||||
Maputnik is [licensed under MIT](LICENSE) and is Copyright (c) Lukas Martinelli and contributors.
|
|
||||||
|
|
||||||
**Disclaimer** This project is not affiliated with Mapbox or Mapbox Studio. It is an independent style editor for the
|
|
||||||
open source technology in the Mapbox GL ecosystem.
|
|
||||||
As contributor please take extra care of not violating any Mapbox trademarks. Do not get inspired by Mapbox Studio and make your own decisions for a good style editor.
|
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue