customize_design.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253
  1. Customize the design of your website
  2. ====================================
  3. Below are a few settings that can be used to change branding, design, and layout of your website.
  4. Site name
  5. ---------
  6. This is shown by default in the navbar, and also added to the title attribute of each page.
  7. This can be changed in Settings > Sites > localhost. Hostname and port only need to be changed
  8. when running in production.
  9. Site settings
  10. -------------
  11. Under Settings > Sites in the Wagtail Admin, you will want to make sure this setting is up
  12. to date with the proper Hostname and Port. Failure to do so can cause the Preview button on
  13. pages to return a 500 error.
  14. Logo & icon
  15. -----------
  16. The logo that appears in the navbar, the wagtail admin, and your favicon can be set in
  17. Settings > Layout. Here you can also change navbar settings (based on Bootstrap CSS framework).
  18. Menu / navigation bars
  19. ----------------------
  20. Navbars are top navigation elements that create a "main menu" experience. Navbars are managed
  21. as snippets. They render from top down based on the order they were created in.
  22. Footers
  23. -------
  24. Similar to Navbars, footers are also managed as snippets and also render top down based on
  25. the order they were created in.
  26. Custom CSS
  27. ----------
  28. A django app called ``website`` has been created to hold your custom changes. In website/static/
  29. there are custom.css and custom.js files that get loaded on every page by default. Adding
  30. anything to these files will automatically populate on the site and override any default styles.
  31. By default, Bootstrap 4 and jQuery are already included on the site.
  32. Custom HTML templates
  33. ---------------------
  34. The templates directory inside the ``website`` app is empty by default. Any templates you put
  35. in here will override the default coderedcms templates if they follow the same name and directory
  36. structure. This uses the standard Django template rendering engine. For example, to change the
  37. formatting of the article page, copy ``coderedcms/templates/coderedcms/pages/article_page.html``
  38. to ``website/templates/coderedcms/pages/article_page.html`` and modify it.