Skip to content

Commit 2d02a3d

Browse files
committed
Clean up info boxes and headers
1 parent 15a5f3b commit 2d02a3d

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

content/en/docs/refguide/installation/upgrading-from-10-to-11/atlas4-migration.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ In CSS (Atlas 4), you define it like this:
105105

106106
The browser directly understands `--brand-primary`. It can even change its value dynamically using JavaScript!
107107

108-
### 1.2 The New `theme/web/custom-variables.scss` File
108+
### 1.2 The New Theme .scss File
109109

110110
In Atlas 4, your `theme/web/custom-variables.scss` file (or any custom SASS file where you define global variables) needs to declare **CSS variables** instead of SASS variables. See the key changes in the code samples below:
111111

@@ -156,7 +156,7 @@ If you omit the `$use-css-variables: true;` declaration, your theme may not func
156156

157157
SASS offers many built-in functions (like `mix()`, `darken()`, `lighten()`) that perform calculations on colors or other values during compilation. With CSS variables, you will need to leverage native CSS functions, as SASS functions will not function with CSS variables.
158158

159-
#### Example: The `mix()` Function and `color-mix()`
159+
#### Example: The mix() and color-mix() Functions
160160

161161
In SASS, `mix()` blends two colors. The CSS equivalent is `color-mix()`. For more information, see the code samples below:
162162

@@ -222,7 +222,7 @@ For other SASS functions like `darken()`, `lighten()`, `rgba()`, `transparentize
222222
The Atlas core theme (`themesource/atlas_core/web/themes/_theme-default.scss`) uses `color-mix()` extensively for color variations. Review it for real-world examples.
223223
{{% /alert %}}
224224

225-
### 1.4 Atlas 4 Backward Compatibility: The Role of `_css-variables-mappings.scss` and `_theme-default.scss`
225+
### 1.4 Atlas 4 Backward Compatibility
226226

227227
Atlas 4 has backward compatibility which helps modules using SASS variables still function. However, there are some limitations due to how the two technologies work (pre-processor versus runtime interpretation):
228228

@@ -264,7 +264,7 @@ Do the following steps before your migration begins:
264264
1. Ensure you are using Mendix Studio Pro 11 or later.
265265
1. In your Mendix project, update the Atlas UI module to its latest Atlas 4 compatible version via the Marketplace. Also, ensure you update all other Marketplace modules, especially `Atlas Web Content` if used, as they may also require Atlas 4 compatibility.
266266

267-
### 2.2 Converting `theme/web/custom-variables.scss`
267+
### 2.2 Converting theme/web/custom-variables.scss
268268

269269
This section, where you convert `theme/web/custom-variables.scss`, is critical for your global theme variables:
270270

@@ -274,9 +274,9 @@ This section, where you convert `theme/web/custom-variables.scss`, is critical f
274274
$use-css-variables: true;
275275
```
276276

277-
{{% alert color="info" %}}
278-
This declaration tells the Atlas UI compiler to generate CSS variables instead of traditional SASS compilation.
279-
{{% /alert %}}
277+
{{% alert color="info" %}}
278+
This declaration tells the Atlas UI compiler to generate CSS variables instead of traditional SASS compilation.
279+
{{% /alert %}}
280280

281281
1. Declare CSS Variables:
282282
* Wrap all your SASS variable declarations within a `:root { ... }` block.
@@ -308,9 +308,9 @@ Now that your variables are declared as CSS variables, you need to update everyw
308308

309309
1. Use your code editor's search function to find all occurrences of SASS variable usage (`$variable-name`) within your custom `.scss` files (for example, within your `theme/web/` folder or your custom UI modules' `themesource/{modulename}/web/` folders).
310310

311-
{{% alert color="info" %}}
312-
Use a regex pattern like `\$([a-zA-Z0-9_-]+)` to identify SASS variable names. Most code editors support regex in their find/replace functions.
313-
{{% /alert %}}
311+
{{% alert color="info" %}}
312+
Use a regex pattern like `\$([a-zA-Z0-9_-]+)` to identify SASS variable names. Most code editors support regex in their find/replace functions.
313+
{{% /alert %}}
314314

315315
1. For each instance, replace `$variable-name` with `var(--variable-name)` (see example below):
316316

0 commit comments

Comments
 (0)