Deneb Jekyll documentation

FAQ and support

Answers to common questions and fixes for common problems with Deneb Jekyll.

Which Jekyll and Ruby versions do I need?

Jekyll 4.4 and Ruby 3.1 or newer. The Gemfile installs Jekyll for you.

Can I host it on GitHub Pages?

Yes, with a GitHub Actions workflow. GitHub Pages’ own build does not support jekyll-paginate-v2 or jekyll-archives. See Deploy for a workflow you can copy.

Yes. Set credit: false under deneb: in _config.yml.

Can I add more pages?

Yes. Copy about.md, change its permalink and its sections, and add it to _data/navigation.yml. See Pages and sections.

Can I add a dropdown menu?

Not in this version. The header shows a flat list from main in _data/navigation.yml.

Can I use a section twice on one page?

Yes. Give each copy its own id. For the faq section this is required.

Check baseurl in _config.yml. It is empty for a site at the root of a domain, and "/repository-name" for a project site on GitHub Pages. Also check url.

Changes to _config.yml do not show

Jekyll reads _config.yml only when it starts. Stop jekyll serve with Ctrl+C and start it again.

The build fails after I edited a page

Usually YAML. Check that the indentation uses spaces, not tabs, and matches the examples. Text with a colon followed by a space needs quotes: text: "Note: we are closed in August.". The error message names the file.

The blog shows no pages, or tag pages are missing

Check that all five plugins are listed under plugins: in _config.yml, and that blog/index.html still has pagination: with enabled: true in its front matter. On GitHub Pages, use the Actions workflow in Deploy.

A new post does not show

The file name must start with the date, such as 2026-11-20-my-post.md. A post dated in the future is not built until that date.

Messages from the contact form never arrive

Check that deneb.form.provider is not still demo, that deneb.form.action is filled in, and for Web3Forms that access_key is set. Look in your spam folder. See Contact form.

There are grey boxes where pictures should be

The download has no photos. Add your own with the image fields. See Images.

Can I change the colours?

Yes, with a few lines in assets/css/custom.css. See Colours and fonts.

Does it work in Arabic?

Yes. Set lang: ar and dir: rtl. See RTL and languages.

Support

Six months of support is included with your purchase. See the support guide for how to reach us and what to include.