zola/docs/content/documentation/getting-started/cli-usage.md
Vincent Prouillet bdcad38310 Finishing up site (#131)
* Finishing up site

* Make site a bit responsive

* Fix menu responsiveness

* Remove Fira Sans and revamp a bit text

* Update list of syntax and change output of syntax

* Add Rust mention

* Some doc tweaks

* Correct capitalization for GitHub

Correct capitalization for GitHub

* Some CSS tweaks

* More css tweaks + favicon

* Add link to my site
2017-10-19 13:48:50 +02:00

1.4 KiB

+++ title = "CLI usage" weight = 2 +++

Gutenberg only has 3 commands: init, build and serve.

You can view the help of the whole program by running gutenberg --help and the command help by running gutenberg <cmd> --help.

init

Creates the directory structure used by Gutenberg at the given directory.

$ gutenberg init <my_site>

will create a new folder named my_site and the files/folders needed by Gutenberg.

build

This will build the whole site in the public directory.

$ gutenberg build

You can override the config base_url by passing a new URL to the base-url flag.

$ gutenberg build --base-url $DEPLOY_URL

This is useful for example when you want to deploy previews of a site to a dynamic URL, such as Netlify deploy previews.

serve

This will build and serve the site using a local server. You can also specify the interface/port combination to use if you want something different than the default (127.0.0.1:1111).

$ gutenberg serve
$ gutenberg serve --port 2000
$ gutenberg serve --interface 0.0.0.0 
$ gutenberg serve --interface 0.0.0.0 --port 2000

The serve command will watch all your content and will provide live reload, without hard refresh if possible.

Gutenberg does a best-effort to live reload but some changes cannot be handled automatically. If you fail to see your change, you will need to restart gutenberg serve.