From b9dee0775cda4bb29da1a5fb5b000ddcd4dc1f6e Mon Sep 17 00:00:00 2001
From: kon-foo <25391223+kon-foo@users.noreply.github.com>
Date: Mon, 26 Feb 2024 21:55:47 +0000
Subject: [PATCH] docs: Clarifications in the Explorer Docs (#938)
---
quartz/styles/base.scss | 181 ++++++++++++++++++++++++++++++++++----------
1 files changed, 138 insertions(+), 43 deletions(-)
diff --git a/quartz/styles/base.scss b/quartz/styles/base.scss
index 9e7c8f2..92798a2 100644
--- a/quartz/styles/base.scss
+++ b/quartz/styles/base.scss
@@ -1,20 +1,22 @@
+@use "./variables.scss" as *;
@use "./syntax.scss";
@use "./callouts.scss";
-@use "./custom.scss";
-@use "./variables.scss" as *;
html {
scroll-behavior: smooth;
- -webkit-text-size-adjust: none;
text-size-adjust: none;
+ overflow-x: hidden;
+ width: 100vw;
}
-body {
+body,
+section {
margin: 0;
max-width: 100%;
box-sizing: border-box;
background-color: var(--light);
font-family: var(--bodyFont);
+ color: var(--darkgray);
}
.text-highlight {
@@ -23,6 +25,11 @@
border-radius: 5px;
}
+::selection {
+ background: color-mix(in srgb, var(--tertiary) 60%, rgba(255, 255, 255, 0));
+ color: var(--darkgray);
+}
+
p,
ul,
text,
@@ -36,17 +43,22 @@
.math {
color: var(--darkgray);
fill: var(--darkgray);
+ overflow-wrap: anywhere;
+ hyphens: auto;
}
.math {
- font-size: 1.1rem;
&.math-display {
text-align: center;
}
}
+strong {
+ font-weight: $semiBoldWeight;
+}
+
a {
- font-weight: 600;
+ font-weight: $semiBoldWeight;
text-decoration: none;
transition: color 0.2s ease;
color: var(--secondary);
@@ -60,6 +72,22 @@
background-color: var(--highlight);
padding: 0 0.1rem;
border-radius: 5px;
+ line-height: 1.4rem;
+
+ &:has(> img) {
+ background-color: none;
+ border-radius: 0;
+ padding: 0;
+ }
+ }
+
+ &.external .external-icon {
+ height: 1ex;
+ margin: 0 0.15em;
+
+ > path {
+ fill: var(--dark);
+ }
}
}
@@ -79,11 +107,9 @@
.page {
@media all and (max-width: $fullPageWidth) {
- margin: 0 5vw;
- }
-
- & p {
- overflow-wrap: anywhere;
+ margin: 0 auto;
+ padding: 0 1rem;
+ max-width: $pageWidth;
}
& article {
@@ -94,11 +120,21 @@
& li:has(> input[type="checkbox"]) {
list-style-type: none;
padding-left: 0;
- margin-left: -1.4rem;
+ }
+
+ & li:has(> input[type="checkbox"]:checked) {
+ text-decoration: line-through;
+ text-decoration-color: var(--gray);
+ color: var(--gray);
}
& li > * {
- margin: 0;
+ margin-top: 0;
+ margin-bottom: 0;
+ }
+
+ p > strong {
+ color: var(--dark);
}
}
@@ -132,16 +168,18 @@
& .sidebar.left {
left: calc(calc(100vw - $pageWidth) / 2 - $sidePanelWidth);
@media all and (max-width: $fullPageWidth) {
- gap: 0rem;
+ gap: 0;
align-items: center;
}
}
& .sidebar.right {
right: calc(calc(100vw - $pageWidth) / 2 - $sidePanelWidth);
+ flex-wrap: wrap;
& > * {
@media all and (max-width: $fullPageWidth) {
flex: 1;
+ min-width: 140px;
}
}
}
@@ -158,9 +196,9 @@
& .center,
& footer {
- width: $pageWidth;
margin-left: auto;
margin-right: auto;
+ width: $pageWidth;
@media all and (max-width: $fullPageWidth) {
width: initial;
margin-left: 0;
@@ -177,8 +215,33 @@
input[type="checkbox"] {
transform: translateY(2px);
color: var(--secondary);
- border-color: var(--lightgray);
+ border: 1px solid var(--lightgray);
+ border-radius: 3px;
background-color: var(--light);
+ position: relative;
+ margin-inline-end: 0.2rem;
+ margin-inline-start: -1.4rem;
+ appearance: none;
+ width: 16px;
+ height: 16px;
+
+ &:checked {
+ border-color: var(--secondary);
+ background-color: var(--secondary);
+
+ &::after {
+ content: "";
+ position: absolute;
+ left: 4px;
+ top: 1px;
+ width: 4px;
+ height: 8px;
+ display: block;
+ border: solid var(--light);
+ border-width: 0 2px 2px 0;
+ transform: rotate(45deg);
+ }
+ }
}
blockquote {
@@ -200,11 +263,9 @@
font-weight: revert;
margin-bottom: 0;
- article > & > a {
+ article > & > a[role="anchor"] {
color: var(--dark);
- &.internal {
- background-color: transparent;
- }
+ background-color: transparent;
}
}
@@ -219,7 +280,6 @@
opacity: 0;
transition: opacity 0.2s ease;
transform: translateY(-0.1rem);
- display: inline-block;
font-family: var(--codeFont);
user-select: none;
}
@@ -232,34 +292,37 @@
// typography improvements
h1 {
font-size: 1.75rem;
- margin-top: 2.75rem;
+ margin-top: 2.25rem;
+ margin-bottom: 1rem;
}
h2 {
font-size: 1.4rem;
- opacity: 0.95;
- margin-top: 2.4rem;
+ margin-top: 1.9rem;
+ margin-bottom: 1rem;
}
h3 {
font-size: 1.12rem;
- margin-top: 2.12rem;
- opacity: 0.9;
+ margin-top: 1.62rem;
+ margin-bottom: 1rem;
}
h4,
h5,
h6 {
font-size: 1rem;
- margin-top: 2rem;
- opacity: 0.85;
+ margin-top: 1.5rem;
+ margin-bottom: 1rem;
}
-div[data-rehype-pretty-code-fragment] {
+figure[data-rehype-pretty-code-figure] {
+ margin: 0;
+ position: relative;
line-height: 1.6rem;
position: relative;
- & > div[data-rehype-pretty-code-title] {
+ & > [data-rehype-pretty-code-title] {
font-family: var(--codeFont);
font-size: 0.9rem;
padding: 0.1rem 0.5rem;
@@ -271,16 +334,17 @@
}
& > pre {
- padding: 0.5rem 0;
+ padding: 0;
}
}
pre {
font-family: var(--codeFont);
- padding: 0.5rem;
+ padding: 0 0.5rem;
border-radius: 5px;
overflow-x: auto;
border: 1px solid var(--lightgray);
+ position: relative;
&:has(> code.mermaid) {
border: none;
@@ -293,6 +357,8 @@
counter-reset: line;
counter-increment: line 0;
display: grid;
+ padding: 0.5rem 0;
+ overflow-x: scroll;
& [data-highlighted-chars] {
background-color: var(--highlight);
@@ -345,17 +411,40 @@
line-height: 1.6rem;
}
-table {
- margin: 1rem 0;
- border: 1px solid var(--gray);
- padding: 1.5rem;
- border-collapse: collapse;
+.table-container {
+ overflow-x: auto;
+
+ & > table {
+ margin: 1rem;
+ padding: 1.5rem;
+ border-collapse: collapse;
+
+ th,
+ td {
+ min-width: 75px;
+ }
+
+ & > * {
+ line-height: 2rem;
+ }
+ }
}
-td,
th {
- padding: 0.2rem 1rem;
- border: 1px solid var(--gray);
+ text-align: left;
+ padding: 0.4rem 0.7rem;
+ border-bottom: 2px solid var(--gray);
+}
+
+td {
+ padding: 0.2rem 0.7rem;
+}
+
+tr {
+ border-bottom: 1px solid var(--lightgray);
+ &:last-child {
+ border-bottom: none;
+ }
}
img {
@@ -389,15 +478,15 @@
ul.overflow,
ol.overflow {
- height: 400px;
- overflow-y: scroll;
+ max-height: 400;
+ overflow-y: auto;
// clearfix
content: "";
clear: both;
& > li:last-of-type {
- margin-bottom: 50px;
+ margin-bottom: 30px;
}
&:after {
@@ -413,3 +502,9 @@
background: linear-gradient(transparent 0px, var(--light));
}
}
+
+.transclude {
+ ul {
+ padding-left: 1rem;
+ }
+}
--
Gitblit v1.10.0