Skip to content

Commit a071f0c

Browse files
committed
wip
1 parent bdc4765 commit a071f0c

20 files changed

Lines changed: 360 additions & 616 deletions

File tree

astro.config.mjs

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,16 +15,13 @@ import tailwindcss from "@tailwindcss/vite";
1515
import icon from "astro-icon";
1616
import rehypeCallouts from "rehype-callouts";
1717
import rehypeMermaid from "rehype-mermaid";
18-
import rehypeCodeGroupReact from "./src/lib/plugins/code-group/plugin";
19-
import rehypeReadMoreReact from "./src/lib/plugins/read-more/plugin";
2018
import rehypeBlogListReact from "./src/lib/plugins/blog-list/plugin";
21-
import rehypeBlock from "./src/lib/plugins/parser/plugin";
22-
import {
23-
default as remarkDirective,
24-
default as remarkReadMoreDirective,
25-
} from "./src/lib/plugins/read-more/remark-directive";
19+
import remarkBlockParser from "./src/lib/plugins/parser/plugin";
20+
import remarkDirectivePkg from "remark-directive";
21+
import remarkReadMoreDirective from "./src/lib/plugins/read-more/remark-directive";
2622
import sitemap from "@astrojs/sitemap";
2723
import { buildDocIntegration } from "./src/hooks/build-doc";
24+
import transformerMetaLabel from "./src/lib/plugins/shiki/transformer-meta-label";
2825

2926
export default defineConfig({
3027
site: "https://example.com",
@@ -45,15 +42,19 @@ export default defineConfig({
4542
transformerNotationFocus(),
4643
transformerNotationErrorLevel(),
4744
transformerMetaHighlight(),
45+
transformerMetaLabel(),
4846
],
4947
},
5048
syntaxHighlight: {
5149
type: "shiki",
5250
excludeLangs: ["mermaid"],
5351
},
54-
remarkPlugins: [remarkDirective, remarkReadMoreDirective],
52+
remarkPlugins: [
53+
remarkDirectivePkg,
54+
remarkBlockParser,
55+
remarkReadMoreDirective,
56+
],
5557
rehypePlugins: [
56-
rehypeBlock,
5758
rehypeMermaid,
5859
[
5960
rehypeCallouts,
@@ -65,8 +66,6 @@ export default defineConfig({
6566
},
6667
},
6768
],
68-
rehypeCodeGroupReact,
69-
rehypeReadMoreReact,
7069
rehypeBlogListReact,
7170
],
7271
},

content/docs/documentation/foundamentals/components/card.mdx

Lines changed: 35 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -10,26 +10,27 @@ icon: lucide:grid-2x2
1010
This component allows you to group text elements while providing visual impact.
1111

1212
```
13-
:::card-group
14-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
13+
::::card-group
14+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
1515
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
1616
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
1717
:::
18-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
18+
19+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
1920
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
2021
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
2122
:::
22-
:::
23+
::::
2324
```
2425

25-
:::card-group {cols=2}
26-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
26+
::::card-group{cols=2}
27+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
2728
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
2829
:::
29-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
30+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
3031
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
3132
:::
32-
:::
33+
::::
3334

3435
---
3536

@@ -43,57 +44,57 @@ You can customize the number of elements per line by setting the `cols` prop.
4344
> Default card per line was fixed to 2
4445
4546
```
46-
:::card-group {cols=4}
47-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
47+
::::card-group{cols=4}
48+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
4849
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
4950
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
5051
:::
51-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
52+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
5253
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
5354
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
5455
:::
55-
:::
56+
::::
5657
```
5758

58-
:::card-group {cols=4}
59-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
59+
::::card-group{cols=4}
60+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
6061
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
6162
:::
62-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
63+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
6364
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
6465
:::
65-
:::
66+
::::
6667

6768
If the elements cannot be aligned horizontally, they will be moved to the next line.
6869

6970
```
70-
:::card-group {cols=2}
71-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
71+
::::card-group{cols=2}
72+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
7273
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
7374
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
7475
:::
75-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
76+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
7677
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
7778
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
7879
:::
79-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
80+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
8081
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
8182
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
8283
:::
83-
:::
84+
::::
8485
```
8586

86-
:::card-group {cols=2}
87-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
87+
::::card-group{cols=2}
88+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
8889
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
8990
:::
90-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
91+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
9192
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
9293
:::
93-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
94+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
9495
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
9596
:::
96-
:::
97+
::::
9798

9899
### Card item
99100

@@ -106,23 +107,23 @@ Vous pouvez personaliser chacune de vos cartes en utilisant les props suivantes
106107
> The cards use the [`iconify`](https://icon-sets.iconify.design/) library to display icons.
107108
108109
```
109-
:::card-group
110-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
110+
::::card-group
111+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
111112
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
112113
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
113114
:::
114-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:user"}
115+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:user"}
115116
Lorem ipsum dolor sit amet, consectetur adipiscing elit,
116117
sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
117118
:::
118-
:::
119+
::::
119120
```
120121

121-
:::card-group {cols=2}
122-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:bell"}
122+
::::card-group{cols=2}
123+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:bell"}
123124
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
124125
:::
125-
:::card {label="Lorem ipsum dolor sit amet", icon="lucide:user"}
126+
:::card{label="Lorem ipsum dolor sit amet" icon="lucide:user"}
126127
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
127128
:::
128-
:::
129+
::::

content/docs/documentation/foundamentals/components/code-block.mdx

Lines changed: 23 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -110,39 +110,44 @@ impl User {
110110

111111
## Group code blocks
112112

113-
Group code blocks can be done with the `:::codegroup labels=[...labels]` syntax.
114-
115113
> [!warning] This is a **collapsible** callout
116114
> Only code blocks can be used in a group.
117115
118-
:::codegroup labels=[Without labels, With labels]
116+
:::codegroup
119117

120-
```
121-
:::codegroup auto
122-
// Code block without labels
123-
:::
118+
```rs [foo]
119+
pub struct User {
120+
pub firstname: String,
121+
pub lastname: String,
122+
}
124123
```
125124

126-
```
127-
:::codegroup labels=[first,, third]
128-
// First code block (named)
129-
// Second code block
130-
// Third code block (named)
131-
:::
125+
```rs [bar]
126+
pub struct User {
127+
pub firstname: String,
128+
pub lastname: String,
129+
}
130+
131+
impl User {
132+
pub fn new(firstname: String, lastname: String) -> Self {
133+
Self { firstname, lastname }
134+
}
135+
}
132136
```
133137

134138
:::
135139

136-
:::codegroup labels=[struct, impl]
140+
````md
141+
:::codegroup
137142

138-
```rust
143+
```rs [foo]
139144
pub struct User {
140-
pub firstname: String, // [!code highlight]
145+
pub firstname: String,
141146
pub lastname: String,
142147
}
143148
```
144149

145-
```rust
150+
```rs [bar]
146151
pub struct User {
147152
pub firstname: String,
148153
pub lastname: String,
@@ -156,3 +161,4 @@ impl User {
156161
```
157162

158163
:::
164+
````

content/docs/documentation/foundamentals/components/markdown.mdx

Lines changed: 3 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ Markdown is a lightweight markup language that you can use to add formatting ele
1313

1414
You can create ordered and unordered lists:
1515

16-
:::codegroup labels=[Ordered, Unordered]
16+
:::codegroup
1717

18-
```mdx
18+
```mdx [ordered]
1919
1. First item
2020
2. Second item
2121
3. Third item
2222
```
2323

24-
```mdx
24+
```mdx [unordered]
2525
- First item
2626
- Second item
2727
- Third item
@@ -73,19 +73,3 @@ You can create tables using the `|` syntax:
7373
| -------- | -------- | -------- |
7474
| Cell 1 | Cell 2 | Cell 3 |
7575
| Cell 4 | Cell 5 | Cell 6 |
76-
77-
## Read More
78-
79-
You can add a read more link using the `:read-more` syntax:
80-
81-
:::codegroup labels=[Base, With title]
82-
83-
```mdx
84-
dd
85-
```
86-
87-
```mdx
88-
ff
89-
```
90-
91-
:::

content/index.mdx

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -150,12 +150,9 @@ import { Badge } from "@/components/ui/badge";
150150
Follow our blog for updates and news
151151
</h2>
152152
<p class="mt-2 max-w-lg text-pretty text-2xl font-semibold tracking-tight text-muted-foreground">
153-
Learn more about our latest developments.
154-
We share tips and tricks to help you succeed.og posts and follow us
153+
Learn more about our latest developments. We share tips and tricks to
154+
help you succeed.og posts and follow us
155155
</p>
156156
</div>
157157
</div>
158-
159-
:::blog-list
160-
161158
</div>

explainer.config.ts

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
import CardGroup from "@/components/content/card-group/card-group.astro";
2+
import Card from "@/components/content/card-group/card.astro";
3+
import CodeGroup from "@/components/content/code-group/code-group.astro";
14
import { defineExplainerConfig } from "@/utils";
25

36
export default defineExplainerConfig({
@@ -38,4 +41,12 @@ export default defineExplainerConfig({
3841
href: "/blog",
3942
},
4043
],
44+
content: {
45+
components: {
46+
"card-group": CardGroup,
47+
card: Card,
48+
codegroup: CodeGroup,
49+
"code-group": CodeGroup,
50+
},
51+
},
4152
});

src/assets/css/markdown.css

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -220,11 +220,11 @@ h6 {
220220
border-spacing: 0;
221221
border-style: hidden;
222222
border-radius: 0.5rem !important;
223-
border: 1px solid var(--color-border-tab);
223+
border: 1px solid var(--color-border) !important;
224224
}
225225

226226
thead {
227-
border: 1px solid var(--color-border-tab);
227+
border: 1px solid var(--color-border);
228228
border-radius: 0.5rem !important;
229229
background-color: var(--tab-container);
230230
}
@@ -234,23 +234,23 @@ h6 {
234234
padding: 0.75rem 1rem;
235235
font-size: 0.875rem;
236236
text-align: left;
237-
border-right: 1px solid var(--ui-border-muted);
238-
border-bottom: 1px solid var(--ui-border-muted);
239-
border-top: 1px solid var(--ui-border-muted);
237+
border-right: 1px solid var(--ui-border);
238+
border-bottom: 1px solid var(--ui-border);
239+
border-top: 1px solid var(--ui-border);
240240
}
241241

242242
tbody tr {
243-
border: 1px solid var(--color-border-tab);
243+
border: 1px solid var(--color-border);
244244
}
245245

246246
tbody td {
247247
padding: 0.75rem 1rem;
248248
font-size: 0.875rem;
249249
text-align: left;
250250
vertical-align: top;
251-
border-right: 1px solid var(--ui-border-muted);
252-
border-bottom: 1px solid var(--ui-border-muted);
253-
border-left: 1px solid var(--ui-border-muted);
251+
border-right: 1px solid var(--ui-border);
252+
border-bottom: 1px solid var(--ui-border);
253+
border-left: 1px solid var(--ui-border);
254254
}
255255

256256
img {
@@ -295,7 +295,7 @@ html.dark .prose > .astro-code {
295295
border-radius: 0.5rem;
296296
font-size: 0.875rem;
297297
position: relative;
298-
border: 1px solid var(--color-border-tab) !important;
298+
border: 1px solid var(--color-border) !important;
299299

300300
.line {
301301
padding-left: 1.5rem !important;

0 commit comments

Comments
 (0)