Yeoman generators and Grunt tasks to work with Jekyll sites



Grab dev dependencies (yeoman generators & grunt tasks). In the Jekyll website root.

# init a new repo
mkdir -p ~/sites/blogthing
cd ~/sites/blogthing
npm init

# install the package. Add it to your package.json dependencies
npm install --save

# Run the generator and create the initial file structure
yeoman init jekyll

# anwser a few prompts

# Install Jekyll locally (get [bundler](
bundle install

# start jekyll server
grunt --config Gruntfile.js jekyll

# or yeoman jekyll


The generator should create a basic Gruntfile.js with a _tasks directory including few jekyll-* tasks to serve or compile the website.

jekyll          Compile jekyll with default config (in _config.yml)
jekyll-compile  Runs jekyll in no-server mode, compiling to _site
jekyll-help     Outputs Jekyll help output


jekyll-reload   Watch _site for file changes and send a LiveReload notification
jekyll-build    Compiles assets and update layouts


yeoman-jekyll defines the following generators:

  • gruntfile:jekyll
  • jekyll

yeoman init jekyll -h

Generator based on @necolas' jekyll-boilerplate, with some ability to wire up some of the GitHub Page theme.

  yeoman init jekyll LOCATION [options]

  -h, --help       # Print generator's options and usage
                   # Default: false
      --theme      # Choose a theme from the following GitHub page templates:
                     - orderedlist/modernist
                     - orderedlist/minimal
                     - mattgraham/Midnight
                     - jsncostello/slate
                     - mattgraham/Leap-Day
                     - jonrohan/time-machine-theme
                     - cameronmcefee/merlot
                     - broccolini/dinky
                     - tactile
                   # Default: tactile
      --gruntfile  # Gruntfile to be invoked
                   # Default:

    Yeoman generator based on @necolas' Jekyll Boilerplate.

    This generator will simply fetch the latest state of jekyll-boilerplate's
    master branch (unless the content is already cached by yeoman at
    `~/.yeoman/cache/necolas/jekyll-boilerplate)` in the `location` argument


    - location: Defaults to current working directory. Base directory to copy
                the content of the remote template.


    This generator will also generate:

      - a basic Gruntfile if none were found
      - a tasks/ directory with:
        - server: Override the built-in server command to run Jekyll instead.


    yeoman init jekyll

    This will create:
        |-- .gitignore
        |-- README
        |-- _config.yml
        |-- _layouts
        |   |-- default.html
        |   |-- post.html
        |-- _includes
        |-- _posts
        |   |--
        |-- index.html

yeoman init gruntfile:jekyll -h

Invoked by jekyll generator as hook, but can be triggered directly to generate only the grunt configuration, or update an existing one.

  yeoman init gruntfile:jekyll  [options]

  -h, --help  # Print generator's options and usage
              # Default: false

    This generator is here to help with the setup of grunt / yeoman
    configuration on Jekyll based websites.

    It'll scan the current working directory for key-directories and known file
    patterns. You'll then be asked for confirmation on each of these directory,
    with sensitive defaults, or suggestion based on the current file structure.

    ex. A lookup is performed on the current working directory for CSS (and
    scss/sass files). Each result is then reduced into a list of unique
    directory paths. If the scanned directories consists in a single result,
    then the system suggest to use that path as "styles" value.

    The result is then persisted as a local `.yeomanrc` JSON file, along the
    generation of a Yeoman Gruntfile.

    yeoman init gruntfile:jekyll

    This will create:
jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer