Open navClose nav
July 24, 2013 docs

Asset Pipeline

If you’re planning on using any preprocessing on your assets (images, CSS, or JS) you’ll need to be careful how you implement this as it effects how Forestry builds your sites. SASS Jekyll supports .sass and .scss processing out of the box. It requires special configuration, so please see Jekyll’s docs on asset processing in the resources below. CoffeeScript Jekyll also supports preprocessing CoffeeScript with an officially support gem. It requires special configuration, so please see Jekyll’s docs on asset processing in the resources below.

June 20, 2017 docs

Environments

They are three unique developer environments when working with a Hugo site in Forestry: Local environment this is your local development environment on your own machine. See Local Development for more info. Staging environment this is the environment Forestry creates when we generate a preview for you. See Previews for more info. Production environment this is the environment Forestry publishes your site to. See Hosting Options for more info.

July 24, 2013 docs

Environments

There are three unique developer environments when working with a Jekyll site in Forestry: Local environment this is your local development environment on your own machine. See Local Development for more info. Staging environment this is the environment Forestry creates when we generate a preview for you. See Previews for more info. Production environment this is the environment Forestry publishes your site to. See Hosting Options for more info.

July 24, 2013 docs

Local Development

Hugo allows you to work on your site in a local environment on your computer. It requires you to install the Hugo binary on your local machine. For detailed instructions on installing Hugo for your operating system, see the Hugo Docs. 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.

July 24, 2013 docs

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.

July 24, 2013 docs

Hugo Shortcodes

You can extend the functionality of markdown in Hugo with short codes. Short codes are special templates that are called when a short code is used inside the content body. They can be used to add custom markup, format text, generate HTML elements, or pull in data from external sources. Using Short Codes in Forestry Forestry provides no interface for using short codes in the editor, but does support using Hugo short codes.

July 24, 2013 docs

Jekyll Plugins

Jekyll allows you to add Gem-based plugins using your Gemfile. This allows you to add things like [CoffeeScript][1] preprocessing. Installing Plugins Forestry supports all third-party Jekyll plugins, and installs them in the same manner they are installed in your [local environment][2]. Installation generally has three steps: Add the plugin to your Gemfile. If you do not have a Gemfile, you must create one in your project root. source ‘https://rubygems.

July 24, 2013 docs

Misc

Sitemap Hugo comes with support for XML Sitemaps built-in. Hugo will export a sitemap.xml file with all of your content using a standard XML template to the root of your built site. You can configure this in your config.yml. [sitemap] changefreq: "monthly" priority: 0.5 filename: "sitemap.xml" RSS Feeds Hugo will also generate an RSS feed in the following locations: At the root of your built site In the root of every section directory At the root of every taxonomy directory You can configure parts of the output of the RSS feeds in your config.

July 24, 2013 docs

Misc

Sitemaps/Feeds Jekyll has no built-in support for Sitemaps or Feeds, but there are a multitude of community plugins to add this functionality. See the references below for more info. Menus Jekyll does not have built-in support for menus. Forestry has built a Jekyll menus plugin that integrates with the Menu Manager of the CMS. Further Reading Jekyll Plugins Reference