Skip to content

Building and Serving a Site

Philip Colmer edited this page Dec 13, 2019 · 7 revisions

By default, the build process does just that - runs Jekyll to build the site into the static HTML output. It can be useful, though, to have Jekyll serve the built content for checking before submitting upstream.

  • Make sure you've read Getting Started

  • Run this command: JEKYLL_ACTION=serve ./build-site.sh

If the site builds correctly, you will be able to browse to http://localhost:4000/ to validate the site.

An extended version of the build-site.sh script allows you to specify an alternative host-local port to use. This is useful if you are working on multiple sites at the same time. The usage form is:

JEKYLL_PORT=xxxx JEKYLL_ACTION=serve ./build-site.sh

where xxxx is the desired local port number, e.g. 4001.