Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# EasyBuild Documentation

![EasyBuild logo](img/easybuild_logo_2022_vertical_dark_bg_transparent.png){: align=left style="height:455px;width:400px"}
![EasyBuild logo](img/easybuild_logo_2022_vertical_dark_bg_transparent.png#only-dark){: align=left style="height:455px;width:400px"}
![EasyBuild logo](img/easybuild_logo_2022_vertical_light_bg_transparent.png#only-light){: align=left style="height:455px;width:400px"}

Welcome to the documentation of **[EasyBuild](https://easybuild.io) (version {{ easybuild.version }})**.

Expand Down
47,748 changes: 23,874 additions & 23,874 deletions docs/release-notes.md

Large diffs are not rendered by default.

147 changes: 20 additions & 127 deletions docs/stylesheets/extra.css
Original file line number Diff line number Diff line change
@@ -1,133 +1,26 @@
/*
* Custom EasyBuild color scheme for Material for MkDocs,
* derived from default dark mode color scheme 'slate'.
*/
[data-md-color-scheme="easybuild"] {
--eb-blue: #94BDCF;
--eb-green: #A8BD90;
--eb-red: #B2666C;
[data-md-color-scheme="slate"] {
/* EB colours - main logo colours */
--eb-blue: #94BDCF;
--eb-green: #A8BD90;
--eb-red: #B2666C;

/* hue (in range [0,360]) */
--md-hue: 232;
--md-primary-fg-color: #1c1e26;
--md-default-bg-color: #2F343F;

--md-default-fg-color: hsla(var(--md-hue), 75%, 95%, 1);
--md-default-fg-color--light: hsla(var(--md-hue), 75%, 90%, 0.62);
--md-default-fg-color--lighter: hsla(var(--md-hue), 75%, 90%, 0.32);
--md-default-fg-color--lightest: hsla(var(--md-hue), 75%, 90%, 0.12);

--md-default-bg-color: #2F343F; /*hsla(var(--md-hue), 15%, 21%, 1);*/
--md-default-bg-color--light: hsla(var(--md-hue), 15%, 21%, 0.54);
--md-default-bg-color--lighter: hsla(var(--md-hue), 15%, 21%, 0.26);
--md-default-bg-color--lightest: hsla(var(--md-hue), 15%, 21%, 0.07);

--md-primary-fg-color: hsla(var(--md-hue), 15%, 12%, 0.87);
--md-primary-fg-color--dark: hsla(var(--md-hue), 15%, 10%, 1);
--md-primary-fg-color--light: var(--eb-green);

/* Code color shades */
--md-code-fg-color: hsla(var(--md-hue), 18%, 86%, 1);
--md-code-bg-color: hsla(var(--md-hue), 15%, 15%, 1);

/* Code highlighting color shades */
--md-code-hl-color: hsla(#{hex2hsl($clr-blue-a200)}, 0.15);
--md-code-hl-number-color: hsla(6, 74%, 63%, 1);
--md-code-hl-special-color: hsla(340, 83%, 66%, 1);
--md-code-hl-function-color: hsla(291, 57%, 65%, 1);
--md-code-hl-constant-color: hsla(250, 62%, 70%, 1);
--md-code-hl-keyword-color: hsla(219, 66%, 64%, 1);
--md-code-hl-string-color: hsla(150, 58%, 44%, 1);
--md-code-hl-name-color: var(--md-code-fg-color);
--md-code-hl-operator-color: var(--md-default-fg-color--light);
--md-code-hl-punctuation-color: var(--md-default-fg-color--light);
--md-code-hl-comment-color: var(--md-default-fg-color--light);
--md-code-hl-generic-color: var(--md-default-fg-color--light);
--md-code-hl-variable-color: var(--md-default-fg-color--light);

/* Typeset color shades */
--md-typeset-color: var(--md-default-fg-color);

/* Typeset `a` color shades */
--md-typeset-a-color: var(--eb-blue);

/* Typeset `a:hover` color shades */
--md-accent-fg-color: var(--eb-green);

/* Typeset `mark` color shades */
--md-typeset-mark-color: hsla(#{hex2hsl($clr-blue-a200)}, 0.3);

/* Typeset `kbd` color shades */
--md-typeset-kbd-color: hsla(var(--md-hue), 15%, 94%, 0.12);
--md-typeset-kbd-accent-color: hsla(var(--md-hue), 15%, 94%, 0.2);
--md-typeset-kbd-border-color: hsla(var(--md-hue), 15%, 14%, 1);

/* Typeset `table` color shades */
--md-typeset-table-color: hsla(var(--md-hue), 75%, 95%, 0.12);

/* Admonition color shades */
--md-admonition-fg-color: var(--md-default-fg-color);
--md-admonition-bg-color: var(--md-default-bg-color);

/* Footer color shades */
--md-footer-bg-color: hsla(var(--md-hue), 15%, 12%, 0.87);
--md-footer-bg-color--dark: hsla(var(--md-hue), 15%, 10%, 1);

/* Shadow depth 1 */
--md-shadow-z1:
0 #{px2rem(4px)} #{px2rem(10px)} hsla(0, 0%, 0%, 0.2),
0 0 #{px2rem(1px)} hsla(0, 0%, 0%, 0.1);

/* Shadow depth 2 */
--md-shadow-z2:
0 #{px2rem(4px)} #{px2rem(10px)} hsla(0, 0%, 0%, 0.3),
0 0 #{px2rem(1px)} hsla(0, 0%, 0%, 0.25);

/* Shadow depth 3 */
--md-shadow-z3:
0 #{px2rem(4px)} #{px2rem(10px)} hsla(0, 0%, 0%, 0.4),
0 0 #{px2rem(1px)} hsla(0, 0%, 0%, 0.35);

/* Hide images for light mode */
img[src$="#only-light"],
img[src$="#gh-light-mode-only"] {
display: none;
}

/* Show images for dark mode */
img[src$="#only-dark"],
img[src$="#gh-dark-mode-only"] {
display: initial;
}
}

/* -------------------------------------------------------------------------- */

/* Adjust link colors for dark primary colors */
@each $name, $color in (
"pink": hsl(340, 81%, 63%),
"purple": hsl(291, 43%, 63%),
"deep-purple": hsl(262, 63%, 70%),
"indigo": hsl(219, 56%, 63%),
"teal": hsl(174, 100%, 40%),
"green": hsl(122, 39%, 60%),
"deep-orange": hsl(14, 100%, 73%),
"brown": hsl(16, 45%, 60%),

// Set neutral colors to indigo
"grey": hsl(219, 56%, 63%),
"blue-grey": hsl(219, 56%, 63%),
"white": hsl(219, 56%, 63%),
"black": hsl(219, 56%, 63%)
) {
[data-md-color-scheme="slate"][data-md-color-primary="#{$name}"] {
--md-typeset-a-color: #{$color};
}
}

/* -------------------------------------------------------------------------- */

/* Switching in progress - disable all transitions temporarily */
[data-md-color-switching] *,
[data-md-color-switching] *::before,
[data-md-color-switching] *::after {
transition-duration: 0ms !important; /* stylelint-disable-line */
[data-md-color-scheme="default"] {
/* EB colours - main logo border colours */
--eb-blue: #72a4b0;
--eb-blue-dark: #538693; /* darker variant of blue in logo */
--eb-green: #8ca379;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both the blue and green is a bit too light on a white background imho, so let's use slightly darker variants, see branfosj#2

--eb-green-dark: #71895d;
--eb-red: #ab5860;
--eb-red-dark: #88444b;

--md-primary-fg-color: #1c1e26;

--md-typeset-a-color: var(--eb-blue-dark);
--md-accent-fg-color: var(--eb-green-dark);
}
11 changes: 10 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,16 @@ theme:
- search.highlight
- search.suggest
palette:
scheme: easybuild
- media: "(prefers-color-scheme: light)"
scheme: default
toggle:
icon: material/brightness-7
name: Switch to dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
toggle:
icon: material/brightness-4
name: Switch to light mode
extra_css:
- stylesheets/extra.css
- stylesheets/asciinema-player-2.6.1.css
Expand Down