Alcor Jekyll documentation

FAQ and support

Answers to common questions, fixes for common problems, and how to reach us.

Is Alcor really free?

Yes, under the MIT licence: use it for your own site or a client’s, change it and share it. Keep the licence file in your copy. The illustrations are MIT too.

Yes: set credit: false under alcor: in _config.yml. The link helps other people find this free theme, so we’d be grateful if you keep it.

Can I add more pages?

Yes. Any page with layout: home and a sections: list works like the home page. A plain page can use layout: default. For a blog, project pages or many layouts, a theme built for them will serve you better: see our Jekyll themes.

Can I use a section twice?

Yes. Give each copy its own id, such as id: work-2026 and id: work-archive, so the menu links and page addresses don’t clash.

My site shows the README instead of the page

GitHub Pages isn’t building with Jekyll. Check that index.md starts with --- front matter and layout: home, and that Pages deploys from the branch and folder that hold _config.yml.

On a project site (username.github.io/repository), set baseurl: "/repository" in _config.yml. On username.github.io or a custom domain, keep it empty.

The build fails after I edited index.md

Usually YAML. Check that the indentation matches the examples and uses spaces, not tabs. Text with a colon followed by a space needs quotes: text: "Note: I'm away in August.". GitHub shows the error under Actions, or in the output of bundle exec jekyll serve.

Messages from the form never arrive

Check that alcor.form.provider isn’t still demo, that the Web3Forms key or Formspree address is right, and look in your spam folder. The first Formspree message asks you to confirm your email address.

Support

Support is the same for every theme. See the support guide for how to reach us and what to include.