-
Notifications
You must be signed in to change notification settings - Fork 15
Stanford Theming
To enable Stanford theming in a sandbox instance:
- Add the following lines to /edx/app/edx_ansible/server-vars.yml
edxapp_use_custom_theme: true
edxapp_theme_name: 'default'
edxapp_theme_source_repo: 'git://github.com/Stanford-Online/edx-default-theme.git'
edxapp_theme_version: 'HEAD'
- Re-run the provisioning scripts:
sudo /edx/bin/update edx-platform master
Theming only works for the LMS.
You should first modify /edx/app/edxapp/lms.auth.json, and set USE_CUSTOM_THEME (True), THEME_NAME (the theme directory name) and PLATFORM_NAME (it will replace "edX" in many views).
You must put theme files in /edx/app/edxapp/themes/<theme-name>/.
Put your images in themes/<theme-name>/static/images.
The themes/<theme-name>/static/sass directory should at least contain a file named _<theme-name>.scss.
The themes/<theme-name>/templates directory must contain 4 files :
- theme-header.html
- theme-head-extra.html
- theme-footer.html
- theme-google-analytics.html
You shall then [recompile the assets](If you're on the production stack, run the commands at https://github.com/edx/configuration/wiki/edX-Managing-the-Production-Stack#compile-assets-manually).
If you want deeper customisations, you shall begin by looking at the lms/templates/main.html file.