Deneb Jekyll documentation

Blog

Write posts, add authors, use tags, and set how many posts show on each blog page.

The blog is at /blog/. Posts are Markdown files in _posts/. Authors are files in _authors/.

Write a post

Create a file in _posts/. The name must start with the date: 2026-11-20-my-first-post.md. The rest of the name becomes the address: /blog/my-first-post/.

---
title: "Seven questions to ask before you hire an agency"
excerpt: "A short list of questions that show how an agency works."
author: maya-chen
tags: [ growth, process ]
image: /assets/img/questions.webp
image_small: /assets/img/questions-sm.webp
image_alt: "Two people reviewing a printed list of questions"
---

Write the post here, in Markdown.

## A heading

More text.
Field What it does
title The post title.
excerpt The short text on cards and under the title.
author The file name of an author in _authors/, without .md.
tags A list of tags.
image The cover picture on the post page.
image_small A smaller picture for cards. If missing, image is used.
image_alt The picture description.

Every post shows the date, the reading time, a share box (X, LinkedIn and copy link), the author box, previous and next links, and related posts. Related posts share a tag with the post, and the latest posts fill the rest.

A post with a date in the future is not built until that date. Run jekyll serve --future to preview it.

Add an author

Create a file in _authors/. The file name is the author’s id, such as _authors/maya-chen.md.

---
title: Maya Chen
role: Founder and design lead
avatar: /assets/img/maya-chen.webp
image_alt: "Portrait of Maya Chen"
bio: Maya founded Deneb after ten years of designing sites for startups.
social:
  - label: LinkedIn
    url: "https://www.linkedin.com/"
---

Text below the front matter shows on the author page. Without an avatar, the author’s initials show in a circle. The author page is at /author/maya-chen/ and lists that author’s posts.

Also add the author to _data/authors.yml. Search engines read their name and address from there:

maya-chen:
  name: Maya Chen
  url: /author/maya-chen/

Tags

Add tags in a post’s front matter. Each tag gets a page at /tag/<name>/, and the blog shows a row of tag links above the posts. Tag pages are made by jekyll-archives.

Tags show as you write them. To show another name in another language, add tag_names to that language in _data/i18n.yml. The Arabic block already has an example. The address keeps the English tag.

Pagination

The blog list is split into pages at /blog/page/2/, /blog/page/3/ and so on. In _config.yml:

pagination:
  enabled: true
  per_page: 6

Change per_page to show more or fewer posts on each page. The first page shows the newest post as a large card. The blog is made by blog/index.html, which has pagination: enabled: true in its front matter. Keep it.

Show posts on other pages

Use the posts section. See Pages and sections.

No blog

Delete the _posts and _authors folders and the blog folder. Remove the Blog link from _data/navigation.yml and any posts section.