Commandline Interface
Help
$ charites help
Usage: charites [options] [command]
Options:
-v, --version output the version number
-h, --help display help for command
Commands:
init [options] <file> initialize a style YAML
convert <source> [destination] convert the style JSON to YAML
build [options] <source> [destination] build a style JSON from the YAML
serve [options] <source> serve your map locally
help [command] display help for command
Checking version
$ charites --version
0.3.0
Inititalize style.yml
$ charites init -h
Usage: charites init [options] <file>
initialize a style YAML
Options:
-t, --tilejson-urls <tilejson_urls> an URL for TileJSON. It will create empty layers from vector_layers property of TileJSON. Please use
comma (,) in case multiple TileJSONs require.
-m, --metadatajson-urls <metadatajson_urls> an URL for metadata.json. It will create empty layers from vector_layers property of metadata.json.
Please use comma (,) in case multiple metadata.json require.
-c, --composite-layers If it is true, a single YAML will be generated with multiple layers. Default is false.
-h, --help display help for command
Convert existing style.json
$ charites convert -h
Usage: charites convert [options] <source> [destination]
convert the style JSON to YAML
Options:
-h, --help display help for command
Build style.json from style.yml
charites build -h
Usage: charites build [options] <source> [destination]
build a style JSON from the YAML
Options:
-c, --compact-output build a minified style JSON
-w, --watch watch YAML and build when changed
-u, --sprite-url [<sprite url>] url to set as the sprite in style.json
-i, --sprite-input [<icon input directory>] directory path of icon source to build icons. The default <icon source> is `icons/`
-o, --sprite-output [<icon output directory>] directory path to output icon files. The default <icons destination> is the current directory
--provider [provider] your map service. e.g. `mapbox`, `geolonia`
-h, --help display help for command
if you use mapbox v2 for your style, please use –provider mapbox to specify mapbox service rather than default. Please see –provider option at serve command section.
Realtime editor on browser
charites serve -h
Usage: charites serve [options] <source>
serve your map locally
Options:
--provider [provider] your map service. e.g. `mapbox`, `geolonia`
--mapbox-access-token [mapboxAccessToken] Access Token for the Mapbox
-i, --sprite-input [<icon input directory>] directory path of icon source to build icons. The default <icon
source> is `icons/`
--port [port] Specify custom port
-h, --help display help for command
Charites has three options for serve command.
--provider
- mapbox, geolonia, or default. When not specified, default or the value in the configuration file will be used.mapbox - The format linter runs against the Mapbox GL JS v2.x compatible specification.
geolonia and default - the format linter runs against the MapLibre GL JS compatible specification.
--mapbox-access-token
- Set your access-token when styling for Mapbox.--sprite-input
- If you are building icon spritesheets with Charites, you can specify the directory of SVG files to compile here. See thebuild
command for more information.--port
- Set http server’s port number. When not specified, the default is 8080.