tortus / contentful2hugo

A tool to create content-files for hugo from content on contentful

#Contentful 2 Hugo

A tool to create content-files for hugo from content on contentful.

Installation

gem install c2h

Usage

Place your config file in the root directory of your hugo site, name it contentful.yml and run c2h -v.

Usage: c2h [-cv]
    -c, --conf pad/to/configfile.yml     Location of your configfile
                                     (default contentful.yml)
        --help                       Show this message
    -v, --verbose                    Give more output
        --version                    Show version

Rake tasks

Some Rake tasks are provided:

# In your Rakefile:

require 'c2h/tasks'

rake contentful:download_content
rake contentful:clean_content

Config file

An example config file:

---
access_token: yourownpersonalaccesstokenfromcontentfulhere # Contentful token  (required)
content_dir: content  # Content dir of hugo (required)
download_images: false # Images in the content get downloaded (optional, default = false)
image_dir: static/images  # Image dir of hugo (required if download_images == true)
spaces:               # List of spaces you want to import
  abc123xyz456:       # Space key of contentful
    page: # Contentful content type
      section: page	# Section in hugo you want to map to (required)
      content: content  # Field you want to map as content in hugo (optional)
      filename: slug    # Field you want to use as filename (optional)
      author: author.name # access fields in nested entries
---

Notice: all paths are relative to the config file.

License

Apache