Alcor Jekyll documentation
Sections
Build your page from Alcor's nine section types, reorder them, switch them off and change their backgrounds.
Your home page is the sections: list in the front matter of index.md. Each item is one section, shown in the order you list them.
---
layout: home
title: Brand and web designer in Lisbon
description: Independent brand and web designer in Lisbon.
sections:
- type: hero
heading: I design brands and websites for *small, careful* businesses.
- type: services
label: Services
nav: Services
heading: What I can help with
items:
- title: Brand identity
text: Name, logo, colours and type.
---
YAML is fussy about two things. Keep the indentation exactly as in the examples (spaces, never tabs). If a line of text contains a colon followed by a space, wrap it in quotes: text: "Note: I'm away in August.".
Settings every section has
| Field | What it does |
|---|---|
type |
Which section: hero, logos, services, work, process, about, testimonials, faq or contact. |
variant |
Which look, where a section has more than one. |
label |
The small label above the heading, numbered for you: “01 — Services”. Reorder the sections and the numbers follow. |
nav |
Adds a link to this section in the header menu, with this text. |
heading |
The section’s heading. Words in *stars* turn vermilion and italic. |
intro |
A line or two under the heading. Markdown links work. |
id |
The section’s address on the page (#work). Defaults to its type. Set it if you use a type twice. |
tone |
The background: default, sand, ink (always dark) or vermilion (always dark). |
hidden |
true switches the section off without deleting it. |
actions |
Buttons: a list of label, url and style (primary, outline or link). The first is primary unless you say otherwise. |
hero
The opening statement. Use it once, first.
- Variants:
text(words only; looks finished with no photo) andportrait(the same beside a photo or drawing). - Fields:
heading,text,status(overrides the availability badge),actions,facts(a list oflabelandvalue), and forportrait:imageorart, pluscaption.
- type: hero
variant: text
heading: I design brands and websites for *small, careful* businesses.
text: I'm Ana, an independent designer in Lisbon.
actions:
- label: Start a project
url: "#contact"
- label: See the work
url: "#work"
facts:
- label: Based in
value: Lisbon, working worldwide
logos
A row of clients you’ve worked with. Use only clients who are happy to be named.
- Fields:
label, anditems, each with anameand optionally aurland animage(src,alt,width,height). Names are set in the display font. Logo images are shown at the same height in one colour, and flip to light in dark mode. - Its label isn’t numbered.
services
What you offer.
- Variants:
list(numbered rows on rules, like a printed menu) andcards. - Fields:
items, each withtitle,text,priceandtags(a list). All buttitleare optional.
work
Selected projects, two to six.
- Variants:
cards(big cards, two across) andlist(a compact index by year). - Fields:
items, each withtitle,client,year,role,text,url, and a picture:image(a photo),art(a drawing) or neither, which shows a coloured panel with the title in the colour set bytone(sand,inkorvermilion). - With a
url, the whole card is a link.
process
How working with you goes, in three to five steps.
- Fields:
steps, each withtitle,time(such as “Within a week”) andtext.
about
Who you are.
- Fields:
text(a few paragraphs; use|and a blank line between paragraphs),imageorart,facts(a list oflabelandvalue), andactions, for example a link to your CV. - Without a picture, the text moves to the right and keeps a comfortable line length.
- type: about
label: About
nav: About
heading: Hello, I'm *Ana*.
text: |
I've been a designer for twelve years.
I like small businesses because you can see the work matter.
art: designer-desk
art_label: Drawing of a designer at her desk
testimonials
What clients say. Use their real words, with permission.
- Variants:
single(one large quote; extra items are ignored) andgrid(two or three side by side). - Fields:
items, each withquote,name,role,companyand optionallyimage(a small square photo). Without a photo, their initials show in a circle.
faq
Questions people ask before they get in touch. They open and close without JavaScript, and search engines are told about them.
- Fields:
items, each withqanda(Markdown),open_first: trueto open the first one, andactions.
contact
The form and other ways to reach you.
- Fields:
email(overridesalcor.email),booking(labelandurl, for Calendly, Cal.com or similar),budgets(a list, adds a budget menu to the form) andnote(a short line beside the Send button). - Your profiles come from
alcor.social. The form itself is set up in_config.yml: see Contact form.
Text below the front matter
Anything you write in index.md below the closing --- appears after the sections, in a narrow column. Handy for a short privacy note.