Home Explore Help
Sign In
CityApper
/
coderedcms
mirror of https://github.com/coderedcorp/coderedcms
2
0
Fork 0
Files Issues 0 Wiki
Branch: 332-align
Branches Tags
coderedcms
/
docs
/
getting_started
/
customize_design.rst

customize_design.rst 2.1 KB
Permalink History Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253 
  1. Customize the design of your website
    2. 

  2. ====================================
    3. 

  3. 

  4. Below are a few settings that can be used to change branding, design, and layout of your website.
    5. 

  5. 

  6. Site name
    7. 

  7. ---------
    8. 

  8. 

  9. This is shown by default in the navbar, and also added to the title attribute of each page.
    10. 

  10. This can be changed in Settings > Sites > localhost. Hostname and port only need to be changed
    11. 

  11. when running in  production.
    12. 

  12. 

  13. Site settings
    14. 

  14. -------------
    15. 

  15. 

  16. Under Settings > Sites in the Wagtail Admin, you will want to make sure this setting is up
    17. 

  17. to date with the proper Hostname and Port. Failure to do so can cause the Preview button on
    18. 

  18. pages to return a 500 error.
    19. 

  19. 

  20. Logo & icon
    21. 

  21. -----------
    22. 

  22. 

  23. The logo that appears in the navbar, the wagtail admin, and your favicon can be set in
    24. 

  24. Settings > Layout. Here you can also change navbar settings (based on Bootstrap CSS framework).
    25. 

  25. 

  26. Menu / navigation bars
    27. 

  27. ----------------------
    28. 

  28. 

  29. Navbars are top navigation elements that create a "main menu" experience. Navbars are managed
    30. 

  30. as snippets. They render from top down based on the order they were created in.
    31. 

  31. 

  32. Footers
    33. 

  33. -------
    34. 

  34. 

  35. Similar to Navbars, footers are also managed as snippets and also render top down based on
    36. 

  36. the order they were created in.
    37. 

  37. 

  38. Custom CSS
    39. 

  39. ----------
    40. 

  40. 

  41. A django app called ``website`` has been created to hold your custom changes. In website/static/
    42. 

  42. there are custom.css and custom.js files that get loaded on every page by default. Adding
    43. 

  43. anything to these files will automatically populate on the site and override any default styles.
    44. 

  44. By default, Bootstrap 4 and jQuery are already included on the site.
    45. 

  45. 

  46. Custom HTML templates
    47. 

  47. ---------------------
    48. 

  48. 

  49. The templates directory inside the ``website`` app is empty by default. Any templates you put
    50. 

  50. in here will override the default coderedcms templates if they follow the same name and directory
    51. 

  51. structure. This uses the standard Django template rendering engine. For example, to change the
    52. 

  52. formatting of the article page, copy ``coderedcms/templates/coderedcms/pages/article_page.html``
    53. 

  53. to ``website/templates/coderedcms/pages/article_page.html`` and modify it.
    54.