Skip to content

Commit 7453a2f

Browse files
committed
README - Update Docs
1 parent e022be7 commit 7453a2f

File tree

1 file changed

+34
-59
lines changed

1 file changed

+34
-59
lines changed

README.md

Lines changed: 34 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -81,81 +81,56 @@ The project is coded using a simple and intuitive structure presented below:
8181
< PROJECT ROOT >
8282
|
8383
|-- core/
84-
| |-- settings.py # Project Configuration
85-
| |-- urls.py # Project Routing
84+
| |-- settings.py # Project Configuration
85+
| |-- urls.py # Project Routing
8686
|
8787
|-- home/
88-
| |-- views.py # APP Views
89-
| |-- urls.py # APP Routing
90-
| |-- models.py # APP Models
91-
| |-- tests.py # Tests
92-
| |-- templates/ # Theme Customisation
93-
| |-- includes #
94-
| |-- custom-footer.py # Custom Footer
88+
| |-- views.py # APP Views
89+
| |-- urls.py # APP Routing
90+
| |-- models.py # APP Models
91+
| |-- tests.py # Tests
9592
|
96-
|-- requirements.txt # Project Dependencies
93+
|-- templates/
94+
| |-- includes/ # UI components
95+
| |-- layouts/ # Masterpages
96+
| |-- pages/ # Kit pages
9797
|
98-
|-- env.sample # ENV Configuration (default values)
99-
|-- manage.py # Start the app - Django default start script
98+
|-- static/
99+
| |-- css/ # CSS Files
100+
| |-- scss/ # SCSS Files
101+
| |-- soft-ui-dashboard/_variables.scss # File Used for Theme Styling
102+
|
103+
|-- requirements.txt # Project Dependencies
104+
|
105+
|-- env.sample # ENV Configuration (default values)
106+
|-- manage.py # Start the app - Django default start script
100107
|
101108
|-- ************************************************************************
102109
```
103110

104111
<br />
105112

106-
## How to Customize
113+
## Recompile SCSS
107114

108-
When a template file is loaded in the controller, `Django` scans all template directories starting from the ones defined by the user, and returns the first match or an error in case the template is not found.
109-
The theme used to style this starter provides the following files:
115+
The SCSS/CSS files used to style the Ui are saved in the `static` directory.
116+
In order to update the Ui colors (primary, secondary) this procedure needs to be followed.
110117

111118
```bash
112-
# This exists in ENV: LIB/admin_soft
113-
< UI_LIBRARY_ROOT >
114-
|
115-
|-- templates/ # Root Templates Folder
116-
| |
117-
| |-- accounts/
118-
| | |-- login.html # Sign IN Page
119-
| | |-- register.html # Sign UP Page
120-
| |
121-
| |-- includes/
122-
| | |-- footer.html # Footer component
123-
| | |-- sidebar.html # Sidebar component
124-
| | |-- navigation.html # Navigation Bar
125-
| | |-- scripts.html # Scripts Component
126-
| |
127-
| |-- layouts/
128-
| | |-- base.html # Masterpage
129-
| | |-- base-fullscreen.html # Masterpage for Auth Pages
130-
| |
131-
| |-- pages/
132-
| |-- index.html # Dashboard page
133-
| |-- profile.html # Settings Page
134-
| |-- *.html # All other pages
135-
|
136-
|-- ************************************************************************
119+
$ yarn # install modules
120+
$ vi static/scss/soft-ui-dashboard/_variables.scss # edit variables
121+
$ gulp # SCSS to CSS translation
137122
```
138123

139-
When the project requires customization, we need to copy the original file that needs an update (from the virtual environment) and place it in the template folder using the same path.
140-
141-
> For instance, if we want to **customize the footer.html** these are the steps:
142-
143-
-`Step 1`: create the `templates` DIRECTORY inside the `home` app
144-
-`Step 2`: configure the project to use this new template directory
145-
- `core/settings.py` TEMPLATES section
146-
-`Step 3`: copy the `footer.html` from the original location (inside your ENV) and save it to the `home/templates` DIR
147-
- Source PATH: `<YOUR_ENV>/LIB/admin_soft/includes/footer.html`
148-
- Destination PATH: `<PROJECT_ROOT>home/templates/includes/footer.html`
124+
The `_variables.scss` content defines the `primary` and `secondary` colors:
149125

150-
> To speed up all these steps, the **codebase is already configured** (`Steps 1, and 2`) and a `custom footer` can be found at this location:
151-
152-
`home/templates/includes/custom_footer.html`
153-
154-
By default, this file is unused because the `theme` expects `footer.html` (without the `custom-` prefix).
155-
156-
In order to use it, simply rename it to `footer.html`. Like this, the default version shipped in the library is ignored by Django.
157-
158-
In a similar way, all other files and components can be customized easily.
126+
```scss
127+
$primary: #cb0c9f !default; // EDIT for customization
128+
$secondary: #8392AB !default; // EDIT for customization
129+
$info: #17c1e8 !default; // EDIT for customization
130+
$success: #82d616 !default; // EDIT for customization
131+
$warning: #fbcf33 !default; // EDIT for customization
132+
$danger: #ea0606 !default; // EDIT for customization
133+
```
159134

160135
<br />
161136

0 commit comments

Comments
 (0)