2
0

customize_design.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  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. :ref:`site-name`
  10. Site settings
  11. -------------
  12. Under Settings > Sites in the Wagtail Admin, you will want to make sure this setting is up
  13. to date with the proper Hostname and Port. Failure to do so can cause the Preview button on
  14. pages to return a 500 error.
  15. Logo & icon
  16. -----------
  17. The logo that appears in the navbar, the wagtail admin, and your favicon can be set in
  18. Settings > CRX Settings. Here you can also change navbar settings (based on Bootstrap CSS framework).
  19. :ref:`logo`
  20. Menu / navigation bars
  21. ----------------------
  22. Navbars are top navigation elements that create a "main menu" experience. Navbars are managed
  23. as snippets. They render from top down based on the order they were created in.
  24. :ref:`navbar-global`
  25. :ref:`navbar`
  26. Footers
  27. -------
  28. Similar to Navbars, footers are also managed as snippets and also render top down based on
  29. the order they were created in.
  30. :ref:`footer`
  31. Custom CSS
  32. ----------
  33. A Django app called ``website`` has been created to hold your custom changes. In website/static/
  34. there are custom.css and custom.js files that get loaded on every page by default. Adding
  35. anything to these files will automatically populate on the site and override any default styles.
  36. By default, Bootstrap 5 is already included on the site.
  37. .. note::
  38. You can also use Bootstrap color and utility classes in the **Custom CSS** fields on your pages in CMS.
  39. Sometimes you may need more customization than Bootstrap classes can provide, in which case you can
  40. create your own custom classes in your CSS files and use them in your templates and in the CMS.
  41. Custom HTML templates
  42. ---------------------
  43. To learn how to create custom HTML templates, see the advanced tutorial:
  44. :doc:`/advanced/advanced01`.