Deneb Jekyll documentation

Configuration

Every setting in _config.yml, including the deneb block with your contact details, social links and form.

All site settings are in _config.yml. After you change it, stop jekyll serve (Ctrl+C) and start it again.

Site settings

title: Deneb
description: A small digital agency for ambitious companies.
lang: en
url: "https://deneb-jekyll.tortoizthemes.com"
baseurl: ""
dir: ltr
Key What it does
title Your agency name. Shown in the logo, the footer and the page titles. The logo is this name in lowercase.
description The default description for search engines.
lang The language of the site: en or ar. It picks the texts from _data/i18n.yml.
url Your live address, with no slash at the end.
baseurl Empty for a site at the root of a domain. For a project site on GitHub Pages use the repository name with a slash, such as "/deneb".
dir ltr or rtl. With rtl the site loads deneb.rtl.css.

The deneb block

Everything about your agency that appears in more than one place.

deneb:
  email: hello@deneb.example
  phone: "+1 (555) 014-2290"
  address: 120 Market Street, Suite 400, San Francisco, CA 94105
  hours: Mon to Fri, 9:00 to 18:00
  footer_about: We help startups and growing brands plan, design and build websites.
  social:
    - label: LinkedIn
      url: https://www.linkedin.com/
  form:
    provider: demo
    action: ""
  newsletter:
    title: Get our monthly notes
    text: One email a month on design and growth. No spam.
    action: ""
  credit: true
Key What it does
email Shown in the contact section and the footer, as a mail link.
phone Shown as a call link in the contact section and the footer.
address Shown in the contact section and the footer.
hours Shown in the contact section.
footer_about The short text under the logo in the footer.
social A list of label and url. Each one becomes a link in the footer. Add or remove items freely.
form.provider formspree, web3forms or demo. See Contact form.
form.action The address your form provider gives you.
form.access_key Web3Forms only. Your access key. This key is not in the starter file, so add it yourself.
newsletter The newsletter form in the footer: title, text and action. Set newsletter: false to hide it.
credit true shows “Theme by Tortoiz Themes” in the footer. Set false to hide it.

Leave out email, phone, address or hours and that line disappears.

Collections

collections:
  services:
    output: true
    permalink: /services/:name/
  portfolio:
    output: true
    permalink: /portfolio/:name/
  authors:
    output: true
    permalink: /author/:name/

These set the address of each service, project and author page. Posts live at /blog/<title>/, set in the defaults: block. You can change these addresses, but existing links will break, so decide before you launch.

Blog pagination and tags

pagination:
  enabled: true
  per_page: 6

jekyll-archives:
  enabled: [tags]

per_page is the number of posts on each blog page. See Blog.

Plugins

plugins:
  - jekyll-seo-tag
  - jekyll-sitemap
  - jekyll-feed
  - jekyll-paginate-v2
  - jekyll-archives

jekyll-seo-tag writes the title, description and social tags. jekyll-sitemap writes /sitemap.xml. jekyll-feed writes the feed at /feed.xml. The other two make the blog pages and tag pages. Keep all five.

Excluded files

The exclude: list keeps Gemfile, Gemfile.lock, README.md and vendor out of the built site.