Merge pull request #206 from iamcarrico/allow-for-overrides

Allow for custom overrides by the user
This commit is contained in:
Patrick Marsceill 2019-09-09 15:35:31 -04:00 committed by GitHub
commit 3b42ec2762
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 21 additions and 0 deletions

3
_sass/overrides.scss Normal file
View File

@ -0,0 +1,3 @@
//
// Custom overrides from a user.
//

View File

@ -46,3 +46,4 @@ $logo: "{{ site.logo | absolute_url }}";
@import "./tables";
@import "./code";
@import "./utilities/utilities";
@import "./overrides";

View File

@ -69,3 +69,20 @@ $link-color: $blue-000;
```
_Note:_ Editing the variables directly in `_sass/support/variables.scss` is not recommended and can cause other dependencies to fail.
## Override styles
To add your own CSS at the end of the cascade, edit `_sass/overrides.scss` to add in your own custom CSS. This will allow for all overrides to be kept in a single file, and allow for any upstream changes to still be allowed.
For example, if you'd like to add your own styles for printing a page, you could add the following styles.
#### Example
{: .no_toc }
```scss
// Print-only styles.
@media print {
.side-bar, .page-header { display: none; }
.main-content { max-width: auto; margin: 1em;}
}
```