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.
Can I remove the “Theme by Tortoiz Themes” link?
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.
The page loads but has no styles, or links go to the wrong place
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.