The Wagtail Guide app adds functionality for creating and editing a guide for editors and publishers to help them create good content.

Wagtailguide has a pypi package and can be installed with:

pip install wagtail-guide

After installing, add it to your settings file along with wagtail.contrib.settings, the settings inclusion should be placed with your other wagtail.contrib libraries:

INSTALLED_APPS = [
    ...
    'wagtail_guide',
    'wagtail.contrib.settings',
]

Wagtail guide has some customisation options...

WAGTAIL_GUIDE_MENU_LABEL Use this setting to define your own menu label for viewing the guide.

ADD_WAGTAIL_GUIDE_TO_HELP_MENU This setting will place the guide within the 'Help' menu.

HIDE_WAGTAIL_CORE_EDITOR_GUIDE You can use this setting to turn off the Wagtail core Editor Guide link

Here is an example of a custom menu label (outlined here in orange), and placing the editor guide link in the help menu:

WAGTAIL_GUIDE_SETTINGS = {
    "ADD_WAGTAIL_GUIDE_TO_HELP_MENU": True,
    "WAGTAIL_GUIDE_MENU_LABEL": "CMS Publishing Guide",
    "HIDE_WAGTAIL_CORE_EDITOR_GUIDE": False,
}

Here is an example of hiding the core Editor Guide link and just using ours:

WAGTAIL_GUIDE_SETTINGS = {
    "ADD_WAGTAIL_GUIDE_TO_HELP_MENU": True,
    "WAGTAIL_GUIDE_MENU_LABEL": "CMS Publishing Guide",
    "HIDE_WAGTAIL_CORE_EDITOR_GUIDE": True,
}

You can define them in your project settings file like this:

WAGTAIL_GUIDE_SETTINGS = {
    "ADD_WAGTAIL_GUIDE_TO_HELP_MENU": False,
    "WAGTAIL_GUIDE_MENU_LABEL": "WG guide menu label",
    "HIDE_WAGTAIL_CORE_EDITOR_GUIDE": True,
}

To edit the guide, the user needs to be an admin, or have the Manage editor guide 'change' value checked in their user group permissions.

To edit the guide, from the left hand menu open settings > then click 'Manage editor guide'. Edit your content and then save.

If more than one 'heading' blocks are added to the content, an automatic menu will be displayed at the top of the guide under the heading 'Contents'

Once logged in, a new menu icon towards the bottom of the left hand menu will be visible labeled as 'Editor guide':

Wagtail Guide requires wagtail>=5.2

We welcome contributions to this project, see CONTRIBUTING.md for more details.