Skip to content

Commit

Permalink
Place skins in minima/skins to clarify purpose (#479)
Browse files Browse the repository at this point in the history
Merge pull request 479
  • Loading branch information
hszhakka committed Feb 21, 2020
1 parent f93bda2 commit 895c611
Show file tree
Hide file tree
Showing 5 changed files with 10 additions and 12 deletions.
18 changes: 8 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,8 +73,7 @@ Refers to snippets of code within the `_includes` directory that can be inserted

Refers to `.scss` files within the `_sass` directory that define the theme's styles.

- `minima-classic.scss` — The core file imported by preprocessed `css/style.scss`, it defines the variable defaults for
the "classic" skin of the theme.
- `minima/skins/classic.scss` — The "classic" skin of the theme. *Used by default.*
- `minima/initialize.scss` — A component that defines the theme's *skin-agnostic* variable defaults and sass partials.
It imports the following components (in the following order):
- `minima/custom-variables.scss` — A hook that allows overriding variable defaults and mixins. (*Note: Cannot override styles*)
Expand Down Expand Up @@ -134,7 +133,7 @@ Therefore, your `assets/css/style.scss` should contain the following at minimum:
---
---
@import "minima-{{ site.minima.skin | default: 'classic' }}";
@import "minima/skins/{{ site.minima.skin | default: 'classic' }}";
@import "minima/initialize";
```

Expand All @@ -150,14 +149,13 @@ Minima 3.0 supports defining and switching between multiple color-palettes (or *
```
A skin is a Sass file named in the format `minima-*` and is the core file imported by the `assets/css/style.scss`. It defines the
variable defaults related to the "color" aspect of the theme.
A skin is a Sass file placed in the directory `_sass/minima/skins` and it defines the variable defaults related to the "color"
aspect of the theme. It also embeds the Sass rules related to syntax-highlighting since that is primarily related to color and
has to be adjusted in harmony with the current skin.
A skin also embeds the Sass rules related to syntax-highlighting since that is primarily related to color and has to be adjusted
in harmony with the current skin.
The default color palette for Minima is defined within `_sass/minima-classic.scss`. To switch to another available skin, simply
declare it in the site's config file. For example, to activate `_sass/minima-sunrise.scss` as the skin, the setting would be:
The default color palette for Minima is defined within `_sass/minima/skins/classic.scss`. To switch to another available skin,
simply declare it in the site's config file. For example, to activate `_sass/minima/skins/sunrise.scss` as the skin, the setting
would be:
```yaml
minima:
Expand Down
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
@charset "utf-8";

$sol-is-dark: true;
@import "minima-solarized";
@import "minima/skins/solarized";
File renamed without changes.
2 changes: 1 addition & 1 deletion assets/css/style.scss
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,5 @@
---

@import
"minima-{{ site.minima.skin | default: 'classic' }}",
"minima/skins/{{ site.minima.skin | default: 'classic' }}",
"minima/initialize";

0 comments on commit 895c611

Please sign in to comment.