wagtail / wagtail/guide

Add ability to export current content (automated or manual)

Open
#160 5 comments 0 reactions 1 assignee View on GitHub

@thibaudcolas is already working on this.

Since Jun 3, 2026.

Dominant language
Python
Stars
36
Forks
39
Avg merge
2d 5h
Merged PRs (30d)
3

Description

With the removal of the versioning solution (see https://github.com/wagtail/guide/issues/62 & https://github.com/wagtail/guide/pull/143 ) we will lose the ability to have a historic record of the Guide.

This will be a reasonably but downgrade from the current RTD solution where anyone can link to the guide for any older version. This is particularly useful for those who only use the LTS versions.

It would be good to be able to provide some kind of future proofing of this loss of detail via a way to export the current site.

This way we can store these somehow and when we do add versioning back we can import this content.

Proposed solution idea 1 - nightly JSON dump to this repo

We automatically use the Django dump data feature and get the CI to commit to this repo - replacing one large JSON file each day.

This would need to be sanitized somewhat (user emails / names) but could be a quick way to resolve this.

Proposed solution idea 2 - Static html export

Similar to above but we have a manual or automatic way to export a static html build of the entire guide. This could be good for those that want to host the content locally/ offline or even remix it.

Could be extended to an epub and even markdown export in the future.

This could also save the html to the rpo. But maybe a seperate isloated branch to avoid too much noise.

This could use bakery or Wagtail freeze.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.