Skip to content

Commit 754a5ea

Browse files
facelessuserfacelessuser
committed
Docs: Theme adjustments
1 parent 5724882 commit 754a5ea

File tree

11 files changed

+117
-84
lines changed

11 files changed

+117
-84
lines changed

‎docs/src/markdown/extensions/betterem.md‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,15 @@
44

55
## Overview
66

7-
BetterEm is an extension that aims to improve emphasis (bold and italic) handling. It provides two modes that control
8-
both asterisk's and underscore's bold and italic syntax: **smart** when `smart_enable` is turned on and **normal** if
9-
`smart_enable` is turned off. `smart_enable` prevents emphasis mid-word. Since mid-word emphasis is usually
10-
undesirable for underscores, it is only enabled for underscore emphasis by default. When **smart** is enabled for
11-
either asterisks and/or underscores, it is enabled for all variants: single and double. When **smart** is enabled with
12-
the default settings, the behavior will be very similar in feel to GFM bold and italic (but not necessarily exact).
7+
BetterEm is an extension that aims to improve emphasis (bold and italic) handling.
8+
9+
BetterEm provides a **smart** which controls whether emphasis is processed mid-word or not. When `smart_enable` is
10+
enabled, mid-word emphasis is intelligently ignored. This can be applied to asterisk and underscore emphasis, but since
11+
it usually only desireable to avoid mid-word emphasis in with underscores, it is only enabled for underscores by
12+
default.
13+
14+
With the default behavior, the feel will be very similar to GFM bold and italic, within the bounds of what Python
15+
Markdown is capable of.
1316

1417
The BetterEm extension can be included in Python Markdown by using the following:
1518

‎docs/src/scss/_general.scss‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,6 @@
1717

1818
.md-typeset {
1919

20-
h4 {
21-
margin: 2.0em 0 1em;
22-
}
23-
2420
a.source-link {
2521
position: relative;
2622
top: convert.px2rem(-12px);

‎docs/src/scss/_material.scss‎

Lines changed: 62 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -9,28 +9,75 @@ html {
99
color: var(--md-primary-fg-color);
1010
}
1111

12-
// Header
13-
.md-header {
14-
border-bottom: convert.px2rem(1px) solid var(--md-accent-fg-color);
15-
}
16-
1712
.md-container .md-tabs {
18-
background-color: var(--md-accent-fg-color--transparent);
19-
box-shadow: none;
20-
2113
.md-tabs__item--active {
22-
border-bottom: none;
14+
border-bottom: convert.px2rem(2px) solid var(--md-accent-fg-color);
2315
}
2416
}
2517

26-
// Footer
27-
.md-footer {
28-
.md-footer-meta {
29-
background-color: var(--md-default-bg-color);
18+
// Navigation
19+
.md-nav--secondary {
20+
> ul {
21+
border-left: convert.px2rem(2px) solid var(--md-default-fg-color--lightest);
3022
}
3123

32-
&-meta {
33-
border-top: convert.px2rem(1px) solid var(--md-accent-fg-color);
24+
ul .md-nav__item {
25+
.md-nav__link--active {
26+
margin-left: convert.px2rem(-2px);
27+
padding-left: convert.px2rem(16px);
28+
}
29+
30+
ul .md-nav__item {
31+
.md-nav__link--active {
32+
margin-left: convert.px2rem(-14px);
33+
padding-left: convert.px2rem(28px);
34+
}
35+
36+
ul .md-nav__item {
37+
.md-nav__link--active {
38+
margin-left: convert.px2rem(-26px);
39+
padding-left: convert.px2rem(40px);
40+
}
41+
42+
ul .md-nav__item {
43+
.md-nav__link--active {
44+
margin-left: convert.px2rem(-38px);
45+
padding-left: convert.px2rem(52px);
46+
}
47+
48+
ul .md-nav__item {
49+
.md-nav__link--active {
50+
margin-left: convert.px2rem(-50px);
51+
padding-left: convert.px2rem(64px);
52+
}
53+
}
54+
}
55+
}
56+
}
57+
}
58+
59+
.md-nav__item {
60+
color: var(--md-default-fg-color--light);
61+
62+
.md-nav__link--active {
63+
color: var(--md-default-fg-color);
64+
border-left: convert.px2rem(2px) solid var(--md-accent-fg-color);
65+
border-top-left-radius: 0;
66+
border-bottom-left-radius: 0;
67+
}
68+
69+
.md-nav__link {
70+
&:focus,
71+
&:hover {
72+
color: var(--md-default-fg-color);
73+
}
74+
}
75+
}
76+
}
77+
78+
.md-nav--primary {
79+
.md-nav__item {
80+
color: var(--md-default-fg-color--light);
3481
}
3582
}
3683

@@ -43,17 +90,6 @@ html {
4390
color: var(--md-default-fg-color--light);
4491
}
4592

46-
.md-nav__item .md-nav__link--active {
47-
color: var(--md-primary-fg-color);
48-
}
49-
50-
.md-nav__link {
51-
&:focus,
52-
&:hover {
53-
color: var(--md-accent-fg-color);
54-
}
55-
}
56-
5793
.md-typeset {
5894

5995
/* Don't force capitalization of `H5` elements. */

‎docs/src/scss/palette/_colors.scss‎

Lines changed: 27 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,7 @@
3737
--md-code-hl-builtin-color: #{dracula.$alucard-cyan};
3838
--md-code-hl-class-color: #{dracula.$alucard-cyan};
3939

40-
--md-code-special-bg-color: #{color.adjust(dracula.$alucard-bg, $lightness: -5%)};
41-
--md-code-alternate-bg-color: #{color_tools.tint(dracula.$alucard-bg, 10%)};
40+
--md-code-special-bg-color: #{dracula.$alucard-highlight};
4241

4342
// List steps
4443
--md-steps-bg-color: var(--md-code-bg-color);
@@ -67,8 +66,8 @@
6766
// Default color shades
6867
--md-default-fg-color: #{color.adjust(dracula.$drac-fg, $alpha: -0.13)};
6968
--md-default-fg-color--light: #{color.adjust(dracula.$drac-fg, $alpha: -0.46)};
70-
--md-default-fg-color--lighter: #{color.adjust(dracula.$drac-fg, $alpha: -0.84)};
71-
--md-default-fg-color--lightest: #{color.adjust(dracula.$drac-fg, $alpha: -0.93)};
69+
--md-default-fg-color--lighter: #{color.adjust(dracula.$drac-fg, $alpha: -0.64)};
70+
--md-default-fg-color--lightest: #{color.adjust(dracula.$drac-fg, $alpha: -0.88)};
7271
--md-default-autocomplete-fg-color: #{color.adjust(dracula.$drac-fg, $alpha: -0.60)};
7372
--md-shadow-z2: 0 #{convert.px2rem(4px)} #{convert.px2rem(10px)} hsla(0, 0%, 0%, 0.3),
7473
0 0 #{convert.px2rem(1px)} hsla(0, 0%, 0%, 0.2);
@@ -123,8 +122,7 @@
123122
--md-code-hl-builtin-color: #{dracula.$drac-cyan};
124123
--md-code-hl-class-color: #{dracula.$drac-cyan};
125124

126-
--md-code-special-bg-color: #{color.adjust(dracula.$drac-bg, $lightness: -5%)};
127-
--md-code-alternate-bg-color: #{color_tools.tint(dracula.$drac-bg, 10%)};
125+
--md-code-special-bg-color: #{dracula.$drac-highlight};
128126

129127
// List steps
130128
--md-steps-border-color: #{color.adjust(dracula.$drac-bg, $lightness: 10%)};
@@ -137,12 +135,13 @@
137135

138136
// Progressbar colors
139137
--md-progress-stripe: var(--md-default-bg-color--lightest);
140-
--md-progress-100: #{color.adjust(dracula.$drac-green, $lightness: -10%)};
141-
--md-progress-80: #{dracula.$drac-green};
138+
139+
--md-progress-100: #{dracula.$drac-green};
140+
--md-progress-80: #{color.mix(dracula.$drac-green, dracula.$drac-yellow, $method: oklab)};
142141
--md-progress-60: #{dracula.$drac-yellow};
143142
--md-progress-40: #{dracula.$drac-orange};
144-
--md-progress-20: #{dracula.$drac-red};
145-
--md-progress-0: #{dracula.$drac-pink};
143+
--md-progress-20: #{dracula.$drac-pink};
144+
--md-progress-0: #{dracula.$drac-red};
146145

147146
// Keys colors
148147
--md-typeset-kbd-color: var(--md-default-fg-color--lightest);
@@ -181,7 +180,7 @@
181180

182181
--md-primary-code-bg-color: #{color.mix(dracula.$drac-bg, list.nth($colors, 1), 85%)};
183182
--md-primary-fg-color: hsla(#{convert.hex2hsl(list.nth($colors, 1))}, 1);
184-
--md-primary-fg-color--transparent: hsla(#{convert.hex2hsl(list.nth($colors, 1))}, 0.1);
183+
--md-primary-fg-color--transparent: hsla(#{convert.hex2hsl(list.nth($colors, 1))}, 0.2);
185184
--md-primary-fg-color--light: hsla(#{convert.hex2hsl(list.nth($colors, 2))}, 1);
186185
--md-primary-fg-color--dark: hsla(#{convert.hex2hsl(list.nth($colors, 3))}, 1);
187186
--md-primary-bg-color: var(--md-default-bg-color);
@@ -194,30 +193,30 @@
194193
// ----------------------------------------------------------------------------
195194

196195
@each $name, $color in (
197-
"red": color.adjust(dracula.$drac-red, $lightness: -5%),
198-
"pink": color.adjust(dracula.$drac-pink, $lightness: -5%),
199-
"purple": color.adjust(dracula.$drac-purple, $lightness: -5%),
200-
"deep-purple": color.adjust(dracula.$drac-purple, $lightness: -5%),
201-
"blue": color.adjust(dracula.$drac-blue, $lightness: -5%),
202-
"indigo": color.adjust(dracula.$drac-blue, $lightness: -5%),
203-
"light-blue": color.adjust(dracula.$drac-blue, $lightness: -5%),
204-
"cyan": color.adjust(dracula.$drac-cyan, $lightness: -5%),
205-
"teal": color.adjust(dracula.$drac-cyan, $lightness: -5%),
206-
"green": color.adjust(dracula.$drac-green, $lightness: -5%),
207-
"light-green": color.adjust(dracula.$drac-green, $lightness: -5%),
208-
"lime": color.adjust(dracula.$drac-green, $lightness: -5%),
209-
"yellow": color.adjust(dracula.$drac-yellow, $lightness: -5%),
210-
"amber": color.adjust(dracula.$drac-yellow, $lightness: -5%),
211-
"orange": color.adjust(dracula.$drac-orange, $lightness: -5%),
212-
"deep-orange": color.adjust(dracula.$drac-orange, $lightness: -5%)
196+
"red": dracula.$drac-red,
197+
"pink": dracula.$drac-pink,
198+
"purple": dracula.$drac-purple,
199+
"deep-purple": dracula.$drac-purple,
200+
"blue": dracula.$drac-blue,
201+
"indigo": dracula.$drac-blue,
202+
"light-blue": dracula.$drac-blue,
203+
"cyan": dracula.$drac-cyan,
204+
"teal": dracula.$drac-cyan,
205+
"green": dracula.$drac-green,
206+
"light-green": dracula.$drac-green,
207+
"lime": dracula.$drac-green,
208+
"yellow": dracula.$drac-yellow,
209+
"amber": dracula.$drac-yellow,
210+
"orange": dracula.$drac-orange,
211+
"deep-orange": dracula.$drac-orange
213212
) {
214213

215214
// Color palette
216215
[data-md-color-scheme="slate"][data-md-color-accent="#{$name}"],
217216
[data-md-color-scheme="slate"] :not([data-md-color-scheme])[data-md-color-primary="#{$name}"] {
218217
--md-code-link-accent-bg-color: #{color.mix($color, dracula.$drac-bg, 15%)};
219218
--md-accent-fg-color: hsla(#{convert.hex2hsl($color)}, 1);
220-
--md-accent-fg-color--transparent: hsla(#{convert.hex2hsl($color)}, 0.1);
219+
--md-accent-fg-color--transparent: hsla(#{convert.hex2hsl($color)}, 0.2);
221220
--md-accent-bg-color: var(--md-default-bg-color);
222221
--md-accent-bg-color--light: var(--md-default-bg-color--light);
223222
}

‎docs/src/scss/palette/_dracula.scss‎

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,20 @@
22

33
$drac-fg: #f8f8f2;
44
$drac-bg: #22212c;
5-
$drac-comment: #7470a9;
6-
$drac-highlight: hsl(245, 25%, 25%);
7-
$drac-selection: #434158;
8-
$drac-blue: hsl(210, 100%, 75%);
9-
$drac-cyan: hsl(170, 100%, 75%);
10-
$drac-green: hsl(115, 100%, 75%);
11-
$drac-orange: hsl(35, 100%, 75%);
12-
$drac-pink: hsl(330, 100%, 75%);
13-
$drac-purple: hsl(250, 100%, 75%);
14-
$drac-red: hsl(10, 100%, 75%);
15-
$drac-yellow: hsl(60, 100%, 75%);
16-
5+
$drac-comment: #6272a4;
6+
$drac-bg: hsl(231, 15%, 18%);
7+
$drac-highlight: hsl(231, 25%, 25%) ;
8+
$drac-selection: hsl(231, 15%, 30%);
9+
$drac-blue: hsl(225, 27%, 51%);
10+
$drac-cyan: hsl(191, 97%, 77%);
11+
$drac-green: hsl(135, 94%, 65%);
12+
$drac-orange: hsl(31, 100%, 71%);
13+
$drac-pink: hsl(326, 100%, 74%);
14+
$drac-purple: hsl(265, 89%, 78%);
15+
$drac-red: hsl(0, 100%, 67%);
16+
$drac-yellow: hsl(65, 92%, 76%);
1717
// Non-standard Dracula colors
1818
$drac-grey: hsl(225, 8%, 51%);
19-
2019
$drac-default-bg: color.adjust($drac-bg, $lightness: 5%);
2120

2221
// An approximation of the Alucard theme
@@ -33,5 +32,5 @@ $alucard-pink: #A3134D;
3332
$alucard-purple: #644AC9;
3433
$alucard-red: #CB3A2A;
3534
$alucard-yellow: #836E15;
36-
35+
// Non-standard Dracula colors
3736
$alucard-default-bg: color.adjust($alucard-bg, $lightness: 5%);

‎docs/src/zensical.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ nav:
114114
- License: about/license.md
115115

116116
markdown_extensions:
117-
- markdown.extensions.toc:
117+
- toc:
118118
slugify: !!python/object/apply:pymdownx.slugs.slugify {kwds: {case: lower}}
119119
permalink: ""
120120
- markdown.extensions.admonition:

‎docs/theme/assets/pymdownx-extras/extra-aaec66f9ad.css‎

Lines changed: 0 additions & 2 deletions
This file was deleted.

‎docs/theme/assets/pymdownx-extras/extra-aaec66f9ad.css.map‎

Lines changed: 0 additions & 1 deletion
This file was deleted.

‎docs/theme/assets/pymdownx-extras/extra-c7a8e25032.css‎

Lines changed: 2 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎docs/theme/assets/pymdownx-extras/extra-c7a8e25032.css.map‎

Lines changed: 1 addition & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)