Skip to content

docs: build with eleventy instead of jekyll#9146

Draft
alxndrsn wants to merge 26 commits intoapache:masterfrom
alxndrsn:eleventy
Draft

docs: build with eleventy instead of jekyll#9146
alxndrsn wants to merge 26 commits intoapache:masterfrom
alxndrsn:eleventy

Conversation

@alxndrsn
Copy link
Contributor

@alxndrsn alxndrsn commented Nov 21, 2025

TODO


Note

If building the site with this branch after using npm run dev-site-with-docker, generated files in docs/_site/ may belong to root. To fix this:

sudo rm -rf ./docs/_site/

Benefits

  • drop ruby dependency

Changes

Eleventy is mostly compatible with Jekyll, so there are minimal changes to the site.

The main changes are:

  • collections need to be defined explicitly, and (may) need to change dir
  • collections are referenced via collections.x instead of site.x
  • collection props are referenced via item.data.x instead of item.x
  • page props are renamed from e.g. page.title to global title
  • include vs page usage of the posts collection means that post now becomes post.data vs global, depending on how the template is used

@espy
Copy link
Contributor

espy commented Feb 5, 2026

Hello @alxndrsn, I gave this a spin and this looks like a great start! Thanks very much.

I have some capacity to continue the work, would you mind if I move this branch into the PouchDB repo and finish it?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants