SEO and sharing

What Alcor does for you

• Titles and descriptions. Each page gets a title (“Page title | Site title”) and a description, from title and description in its front matter, falling back to _config.yml.
• Social sharing. Open Graph and Twitter tags with your sharing image, through the jekyll-seo-tag plugin.
• Who you are. The home page tells search engines about you as a Person (or a ProfessionalService): name, role, location, email and profiles, from the alcor: settings.
• Your FAQ. Questions in the FAQ section are marked up so search engines can show them.
• A sitemap at /sitemap.xml and a robots.txt, from the jekyll-sitemap plugin. The thank-you and 404 pages are left out of the sitemap and hidden from search.
• Clean HTML. One main heading per page, headings in order, and real links.

Before you launch

1. Set url in _config.yml to your real address. Sharing tags and the sitemap need it.
2. Write a title and description in index.md that say what you do and where, such as “Brand and web designer in Lisbon”.
3. Set role and location under alcor:.
4. Replace assets/images/og.png with your own 1200 × 630 picture.
5. Add your site to Google Search Console and submit https://your-domain.com/sitemap.xml.

Checking it

• Paste your address into PageSpeed Insights for speed, accessibility and SEO scores.
• The Rich Results Test shows the FAQ and Person data search engines see.
• To check social sharing, paste your address into a post on LinkedIn or Bluesky before publishing it.