Skip to content

Commit 3c79ad3

Browse files
authored
docs: Expand on how to enable a theme (#73)
1 parent 7e14f5b commit 3c79ad3

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

docs/devstack_faq.rst

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,11 +125,18 @@ Make sure that you enable the following code in ./edx-platform/lms/envs/devstack
125125
ENABLE_COMPREHENSIVE_THEMING = True
126126
COMPREHENSIVE_THEME_DIRS = [
127127
"/edx/app/edxapp/edx-platform/themes/",
128-
"/edx/app/edx-themes/edx-platform/"
128+
"/edx/app/edx-themes/edx-platform/",
129129
]
130130
TEMPLATES[1]["DIRS"] = _make_mako_template_dirs
131131
derive_settings(__name__)
132132
133+
Enabling a theme
134+
~~~~~~~~~~~~~~~~
135+
136+
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.
137+
138+
For example, to enable the ``edx.org-next`` theme from the ``edx/edx-themes`` repo, you'd visit `<http://localhost:18000/admin/theming/sitetheme/>`_, use ``localhost:18000`` as the site domain, and specify ``edx.org-next`` as the theme directory.
139+
133140
How do I connect to the databases from an outside editor?
134141
---------------------------------------------------------
135142

0 commit comments

Comments
 (0)