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.