From 3d1536beb05d0e223843d0ae4d41af9fac00428d Mon Sep 17 00:00:00 2001 From: Tim McCormack Date: Thu, 14 Nov 2024 14:54:41 +0000 Subject: [PATCH] docs: Expand on how to enable a theme --- docs/devstack_faq.rst | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/devstack_faq.rst b/docs/devstack_faq.rst index 048420228d..660aa09adc 100644 --- a/docs/devstack_faq.rst +++ b/docs/devstack_faq.rst @@ -125,11 +125,18 @@ Make sure that you enable the following code in ./edx-platform/lms/envs/devstack ENABLE_COMPREHENSIVE_THEMING = True COMPREHENSIVE_THEME_DIRS = [ "/edx/app/edxapp/edx-platform/themes/", - "/edx/app/edx-themes/edx-platform/" + "/edx/app/edx-themes/edx-platform/", ] TEMPLATES[1]["DIRS"] = _make_mako_template_dirs derive_settings(__name__) +Enabling a theme +~~~~~~~~~~~~~~~~ + +To enable a theme, go to the Django theme admin page and select "Add site theme". You'll need to create a Site with the "domain" including the port. For the theme, specify the name of a subdirectory in one of the configured theme dirs. After this, the theme will immediately become available and enabled, and changes will show up live. + +For example, to enable the ``edx.org-next`` theme from the ``edx/edx-themes`` repo, you'd visit ``_, use ``localhost:18000`` as the site domain, and specify ``edx.org-next`` as the theme directory. + How do I connect to the databases from an outside editor? ---------------------------------------------------------