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.