Deneb Jekyll documentation
Images
Add your own pictures to pages, posts, projects and team members, and what size and format to use.
The download has no photos. Every picture slot shows a soft placeholder until you add an image. The live demo uses its own photos, which are not included.
Where to put pictures
Save them in assets/img/, then point to them with a path that starts with a slash:
image: /assets/img/team.webp
image_alt: "The team in a meeting room"
Which fields take a picture
| Where | Fields |
|---|---|
A section of type about |
image, image_alt, image_label |
A team member in _data/team.yml |
image, image_alt |
A project in _portfolio/ |
image, image_small, image_alt |
A post in _posts/ |
image, image_small, image_alt |
An author in _authors/ |
avatar |
image_label is the text on the placeholder while there is no picture.
image_small is a smaller copy for cards and lists. If you leave it out, the full image is used.
An author with no avatar shows their initials in a circle. A testimonial always shows initials: it has no picture field.
Format and size
- Use WebP files. They are small and every modern browser shows them.
- Make each picture about twice as wide as it shows on screen, so it stays sharp on high-density screens. A cover picture needs about 2400 pixels. A card picture needs about 800.
- Crop to the shape the template uses: about 4:3 for the
aboutsection, 1:1 for team members, 16:9 for post cards and 21:9 for the cover of a post or project. - Keep each file as small as you can. A good target is under 200 KB.
The template sets the width and height, so the page does not jump while pictures load. Pictures load lazily, except the cover at the top of a post or project.
Alt text
Always fill image_alt with a short description of the picture. It helps visitors who use a screen reader, and it helps search engines. A picture with no image_alt is hidden from screen readers.
Logo, favicon and the social image
- The logo is your
titlein_config.yml, in lowercase, with a small dot. There is no logo file. - The favicon is
assets/favicon.svg. Replace the file with your own. - To set the picture shown when a page is shared, add
image:to the page’s front matter.jekyll-seo-tagreads it.
Icons
Service icons are drawn in the theme. See the list of names in Services and portfolio.