Deneb Jekyll documentation

Services and portfolio

Add services and portfolio projects as Markdown files, and control their order.

Each service is one file in _services/. Each project is one file in _portfolio/. The file name becomes the address: _services/web-design.md is at /services/web-design/.

Add a service

Create a file in _services/:

---
title: Web design
icon: layout
excerpt: "Clear pages that explain what you do and turn visitors into leads."
order: 1
features: [ "Sitemap and page plan", "Layout and visual design", "Two rounds of revisions" ]
---

## Our approach

Write the page here, in Markdown.
Field What it does
title The service name.
icon The icon on the card and the page. Names: layout, code, megaphone, search, pen, phone, chart, shield, layers, rocket, check.
excerpt The short text on the card and under the page title.
order The position in lists. 1 comes first.
features The checklist in the “What is included” box at the side.

The page also shows a “Start a project” button, a list of your other services, and the “how we work” and call to action sections.

The starter files also contain image and image_alt fields. The service page template does not show them.

Add a project

Create a file in _portfolio/:

---
title: Alder Dental practice website
client: Alder Dental
category: Web design
year: 2026
excerpt: "A calm, clear website that helps new patients book in minutes."
services: [ "Web design", "SEO" ]
results:
  - value: "+63%"
    label: online appointment requests
image: /assets/img/alder-dental.webp
image_small: /assets/img/alder-dental-sm.webp
image_alt: "Alder Dental home page with a booking button"
order: 2
---

## Challenge

Write the case study here, in Markdown.
Field What it does
title The project name.
client Shown in the facts list and the breadcrumb.
category The small label on the card and the page.
year Shown in the facts list.
excerpt The short text on the card and under the title.
services A list of the services you provided.
results Big numbers, each with value and label. Leave out for none.
image The large cover picture.
image_small A smaller version for cards. If missing, image is used.
image_alt The picture description.
order The position in lists. 1 comes first.

The project page shows previous and next links and three more projects.

Where they appear

  • /services/ and the services section show services sorted by order.
  • /portfolio/ and the projects section show projects sorted by order.
  • Use limit on a section to show only the first few. See Pages and sections.

To remove one, delete its file.

For pictures, see Images.