Replace tricks with mods (fixes #88)
This commit is contained in:
daudix
100
content/mods/index.md
Normal file
100
content/mods/index.md
Normal file
@ -0,0 +1,100 @@
|
||||
+++
|
||||
title = "Mods"
|
||||
[extra]
|
||||
toc = true
|
||||
+++
|
||||
|
||||
Mods enhance/change some Duckquill visuals. They are updated alongside Duckquill to ensure that you don't need to manually update them every release.
|
||||
|
||||
To enable these mods, you need to paste provided Sass to [appropriate file](@/_index.md#custom-styles), e.g `sass/mods.scss` under your website, then enable it in `config.toml`:
|
||||
|
||||
```toml
|
||||
[extra]
|
||||
styles = ["mods.css"]
|
||||
```
|
||||
|
||||
## Background Image
|
||||
|
||||
Want to set some nice image as a background? We got you covered:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@import "../themes/duckquill/sass/_variables.scss";
|
||||
|
||||
@include theme-variables using ($theme) {
|
||||
@if $theme == "dark" {
|
||||
--bg-overlay: linear-gradient(rgb(0 0 0 / 0.9), rgb(0 0 0 / 0.9));
|
||||
}
|
||||
|
||||
@else {
|
||||
--bg-overlay: linear-gradient(rgb(255 255 255 / 0.8), rgb(255 255 255 / 0.8));
|
||||
}
|
||||
}
|
||||
|
||||
body {
|
||||
background: var(--bg-overlay), center / cover no-repeat fixed url("https://images.unsplash.com/photo-1523712999610-f77fbcfc3843");
|
||||
}
|
||||
```
|
||||
|
||||
Most of the time contrast should be okay, but what if it's not? Simply adjust the opacity of `--bg-overlay` based on your needs.
|
||||
|
||||
## Classic Navbar
|
||||
|
||||
You can make navbar have more traditional look by using the `classic-nav` mod:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/classic-nav";
|
||||
```
|
||||
|
||||
Or you can make it sticked to top but not full-width with the `sticked-nav` mod:
|
||||
|
||||
{% alert(note=true) %}
|
||||
Not compatible with the `classic-nav` mod.
|
||||
{% end %}
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/sticked-nav";
|
||||
```
|
||||
|
||||
## Classic Strikethrough
|
||||
|
||||
The default strikethrough style is too much? It can be fixed using the `classic-del` mod:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/classic-del";
|
||||
```
|
||||
|
||||
## Modern Headings
|
||||
|
||||
Default headings might not fit your taste, that's understandable. They can be ~~made boring~~ fixed with the `modern-headings` mod:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/modern-headings";
|
||||
```
|
||||
|
||||
## Modern Horizontal Rule
|
||||
|
||||
Don't like that fancy horizontal rule? Make it more modern with the `modern-hr` mod:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/modern-hr";
|
||||
```
|
||||
|
||||
## No Edge Highlight
|
||||
|
||||
Hate the skeuomorphic edge highlight on all semi-transparent elements? Let's get rid of it using the `no-edge-highlight` mod:
|
||||
|
||||
```scss
|
||||
@use "../themes/duckquill/sass/mods/no-edge-highlight";
|
||||
```
|
||||
@ -1,190 +0,0 @@
|
||||
+++
|
||||
title = "Tricks"
|
||||
[extra]
|
||||
toc = true
|
||||
+++
|
||||
|
||||
Several lesser known Duckquill thingies.
|
||||
|
||||
<small>If you have some, please consider sharing them here.</small>
|
||||
|
||||
## Styling
|
||||
|
||||
Duckquill is pretty easy to restyle with just a few lines of SCSS in the [appropriate location](@/_index.md#custom-styles). Let's see some examples.
|
||||
|
||||
### Navbar
|
||||
|
||||
You can make navbar have more traditional look:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
#site-nav {
|
||||
margin-block-start: 0;
|
||||
inset-block-start: 0;
|
||||
box-shadow: var(--shadow-glass);
|
||||
border-radius: 0;
|
||||
width: 100%;
|
||||
max-width: 100%;
|
||||
|
||||
nav,
|
||||
#search-container {
|
||||
margin: 0 auto;
|
||||
width: min(var(--container-width), 90%);
|
||||
}
|
||||
|
||||
nav ul li {
|
||||
a,
|
||||
summary,
|
||||
&#search button,
|
||||
&#language-switcher details summary,
|
||||
&#theme-switcher details summary {
|
||||
border-radius: var(--rounded-corner);
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
#home {
|
||||
margin-inline-end: auto;
|
||||
}
|
||||
|
||||
.divider {
|
||||
display: none;
|
||||
}
|
||||
|
||||
#search-container {
|
||||
#search-bar {
|
||||
border-radius: var(--rounded-corner);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Or you can make it sticked to top but not full-width:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
#site-nav {
|
||||
margin-block-start: 0;
|
||||
inset-block-start: 0;
|
||||
box-shadow: var(--shadow-glass);
|
||||
border-radius: 0 0 calc(var(--rounded-corner) + 0.5rem) calc(var(--rounded-corner) + 0.5rem);
|
||||
|
||||
nav ul li {
|
||||
a,
|
||||
summary,
|
||||
&#search button,
|
||||
&#language-switcher details summary,
|
||||
&#theme-switcher details summary {
|
||||
border-radius: var(--rounded-corner);
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
#search-container {
|
||||
#search-bar {
|
||||
border-radius: var(--rounded-corner);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Headings
|
||||
|
||||
Default headings might not fit your taste, that's understandable. Good thing is that we can ~~make them boring~~ fix them:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
h1,
|
||||
h2,
|
||||
h3,
|
||||
h4,
|
||||
h5,
|
||||
h6 {
|
||||
font-weight: bold;
|
||||
font-family: var(--font-system-ui)
|
||||
}
|
||||
|
||||
h1 {
|
||||
font-weight: 900;
|
||||
}
|
||||
```
|
||||
|
||||
### Strikethrough
|
||||
|
||||
The default strikethrough style is too much? Let's sort this out:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
del {
|
||||
box-shadow: none;
|
||||
border-radius: 0;
|
||||
background-color: transparent;
|
||||
padding: 0;
|
||||
color: inherit;
|
||||
}
|
||||
```
|
||||
|
||||
### Edge Highlights
|
||||
|
||||
Hate the skeuomorphic edge highlight on all semi-transparent elements? Let's get rid of them:
|
||||
|
||||
```scss
|
||||
@import "../themes/duckquill/sass/_variables.scss";
|
||||
|
||||
@include theme-variables using ($theme) {
|
||||
@if $theme == "light" {
|
||||
--edge-highlight: 0 0 0 transparent;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Horizontal Rules
|
||||
|
||||
Don't like that fancy horizontal rule? Let's make it more modern:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
hr {
|
||||
box-shadow: var(--edge-highlight);
|
||||
border: none;
|
||||
border-radius: 999px;
|
||||
background-color: var(--fg-muted-2);
|
||||
width: 50%;
|
||||
height: 0.25rem;
|
||||
|
||||
&::after {
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Background Image
|
||||
|
||||
Want to set some nice image as a background? We got you covered:
|
||||
|
||||
|
||||
|
||||
```scss
|
||||
@import "../themes/duckquill/sass/_variables.scss";
|
||||
|
||||
@include theme-variables using ($theme) {
|
||||
@if $theme == "dark" {
|
||||
--bg-overlay: linear-gradient(rgb(0 0 0 / 0.9), rgb(0 0 0 / 0.9));
|
||||
}
|
||||
|
||||
@else {
|
||||
--bg-overlay: linear-gradient(rgb(255 255 255 / 0.8), rgb(255 255 255 / 0.8));
|
||||
}
|
||||
}
|
||||
|
||||
body {
|
||||
background: var(--bg-overlay), center / cover no-repeat fixed url("https://images.unsplash.com/photo-1523712999610-f77fbcfc3843");
|
||||
}
|
||||
```
|
||||
|
||||
Most of the time contrast should be okay, but what if it's not? Simply adjust the opacity of `--bg-overlay` based on your needs.
|
||||
Reference in New Issue
Block a user