Local Development

Jekyll allows you to work on your site in a local environment on your computer. It requires you to have Ruby, RubyGems and Bundler installed.

For detailed instructions on installing Ruby for your operating system, see the Ruby Docs.

Once Ruby and RubyGems are installed, you can install Bundler by running:

$ gem install bundler

Working with Git

If you set up and imported your site with Git, local development becomes much easier. We recommend you do this.

To get started, clone your repository to your desktop. For example:

git clone https://github.com/forestryio/jekyll-demo.git

Now you can begin working on your site. Any changes made to your site can be committed in Git, and will automatically be synced with your Forestry CMS.

Working with a Zip-based site

If you set up and imported your site with a zip file, local development becomes more challenging.

Any changes made to your site must be rezipped and reimported into your Forestry CMS.

You can do this from your Forestry Dashboard, by choosing “Re-upload Project” from the site’s dropdown menu (…).

IF YOU ONLY UPDATED LAYOUTS/THEMES

If you didn’t change any of your content files, then you can choose “Update project files” which will only update the source code we use to deploy your site.

IF YOU UPDATED CONTENT FILES

If you did change your content files, then you can choose Update project files & content files which will update the source code and all of the content in Forestry.

Serving your site locally

Jekyll comes with a local development server built into it’s binary. This will allow you to develop locally on your machine, and will automatically rebuild your site and refresh the browser as you make changes.

To run Jekyll with the server, run the command:

$ jekyll serve

This will spin up a local development server with live reload at the port 4000, which is accessible from http://localhost:4000.

Deployment

For information on how to handle deployment of your site to your production or staging environment, see our Deployment doc

Further Reading

• Jekyll Usage Guide

---