Skip to content

Commit bf47e4b

Browse files
authored
docs: further documentation on the SCSS load path (#109)
* Update getStarted.adoc * Update migrationGuide.adoc
1 parent 6592e1e commit bf47e4b

File tree

2 files changed

+4
-0
lines changed

2 files changed

+4
-0
lines changed

docs/getStarted.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ This should add a new entry to your `package.json` file:
5858
@import "@db-ui/core/sources/css/enterprise/db-ui-core";
5959
----
6060

61+
### SCSS: `node_modules include path / load path
62+
6163
Please keep in mind, that you would need to set your `include path` also known as `load path` depending on your setup for the sass compiler to find the correct `node_modules` folder, e.g. like the following (this is similar to how other frameworks and libraries like link:https://github.com/twbs/bootstrap-npm-starter/blob/main/package.json#L18[Bootstrap] are handling this):
6264

6365
#### link:https://npmjs.com/sass[`sass` compiler]

docs/migrationGuide.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ Especially the following aspects have changed through the various different rele
1212

1313
Please note that we've switched from the deprecated link:https://www.npmjs.com/package/node-sass[`node-sass`] compiler to its successor link:https://www.npmjs.com/package/sass[`sass`]. As `sass` doesn't support the tilde (`~`) reference to your `node_modules` folder out of the box and there even also doesn't seem to be a general solution out there, we've removed that one, so that in case you're using our SCSS sources directly, you would need to provide your `node_modules` folder as a load path or include path (e.g. `--load-path=node_modules` on the `sass` CLI usage).
1414

15+
You need to set the load path / include path depending on your SCSS compiler as described within our link:getStarted.adoc#scss-node_modules-include-path--load-path[getting started]
16+
1517
Additionally we've deprecated the `@db-ui/core/sources/css/enterprise/db-ui-core-include` SCSS endpoint – please either `@import` the file `@db-ui/core/sources/css/rollup.assets-paths` or `@db-ui/core/sources/css/webpack.assets-paths` depending on your bundler, previous to `@import`ing `@db-ui/core/sources/css/enterprise/db-ui-core` directly from now on.
1618

1719
==== SCSS Helper functions

0 commit comments

Comments
 (0)