Skip to content

Commit

Permalink
docs: Expand on how to enable a theme (#73)
Browse files Browse the repository at this point in the history
  • Loading branch information
timmc-edx authored Nov 14, 2024
1 parent 7e14f5b commit 3c79ad3
Showing 1 changed file with 8 additions and 1 deletion.
9 changes: 8 additions & 1 deletion docs/devstack_faq.rst
Original file line number Diff line number Diff line change
@@ -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 `<http://localhost:18000/admin/theming/sitetheme/>`_, 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?
---------------------------------------------------------

0 comments on commit 3c79ad3

Please sign in to comment.