docyard 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.rubocop.yml +5 -1
- data/CHANGELOG.md +34 -1
- data/lib/docyard/build/asset_bundler.rb +22 -7
- data/lib/docyard/build/file_copier.rb +49 -27
- data/lib/docyard/build/sitemap_generator.rb +6 -6
- data/lib/docyard/build/static_generator.rb +82 -50
- data/lib/docyard/builder.rb +20 -10
- data/lib/docyard/cli.rb +6 -3
- data/lib/docyard/components/aliases.rb +29 -0
- data/lib/docyard/components/processors/callout_processor.rb +124 -0
- data/lib/docyard/components/processors/code_block_diff_preprocessor.rb +106 -0
- data/lib/docyard/components/processors/code_block_focus_preprocessor.rb +79 -0
- data/lib/docyard/components/processors/code_block_options_preprocessor.rb +78 -0
- data/lib/docyard/components/processors/code_block_processor.rb +175 -0
- data/lib/docyard/components/processors/code_snippet_import_preprocessor.rb +127 -0
- data/lib/docyard/components/processors/heading_anchor_processor.rb +39 -0
- data/lib/docyard/components/processors/icon_processor.rb +53 -0
- data/lib/docyard/components/processors/table_of_contents_processor.rb +68 -0
- data/lib/docyard/components/processors/table_wrapper_processor.rb +22 -0
- data/lib/docyard/components/processors/tabs_processor.rb +48 -0
- data/lib/docyard/components/support/code_block/feature_extractor.rb +117 -0
- data/lib/docyard/components/support/code_block/icon_detector.rb +44 -0
- data/lib/docyard/components/support/code_block/line_parser.rb +84 -0
- data/lib/docyard/components/support/code_block/line_wrapper.rb +50 -0
- data/lib/docyard/components/support/code_block/patterns.rb +55 -0
- data/lib/docyard/components/support/code_detector.rb +61 -0
- data/lib/docyard/components/support/tabs/icon_detector.rb +62 -0
- data/lib/docyard/components/support/tabs/parser.rb +195 -0
- data/lib/docyard/components/support/tabs/range_finder.rb +46 -0
- data/lib/docyard/config/branding_resolver.rb +183 -0
- data/lib/docyard/{constants.rb → config/constants.rb} +7 -4
- data/lib/docyard/config/validator.rb +122 -99
- data/lib/docyard/config.rb +38 -36
- data/lib/docyard/initializer.rb +15 -76
- data/lib/docyard/navigation/breadcrumb_builder.rb +133 -0
- data/lib/docyard/{prev_next_builder.rb → navigation/prev_next_builder.rb} +6 -3
- data/lib/docyard/navigation/sidebar/children_discoverer.rb +51 -0
- data/lib/docyard/navigation/sidebar/config_parser.rb +208 -0
- data/lib/docyard/navigation/sidebar/file_resolver.rb +78 -0
- data/lib/docyard/{sidebar → navigation/sidebar}/file_system_scanner.rb +2 -1
- data/lib/docyard/navigation/sidebar/item.rb +96 -0
- data/lib/docyard/navigation/sidebar/local_config_loader.rb +51 -0
- data/lib/docyard/navigation/sidebar/metadata_extractor.rb +69 -0
- data/lib/docyard/navigation/sidebar/metadata_reader.rb +47 -0
- data/lib/docyard/navigation/sidebar/path_prefixer.rb +34 -0
- data/lib/docyard/navigation/sidebar/renderer.rb +144 -0
- data/lib/docyard/navigation/sidebar/sorter.rb +21 -0
- data/lib/docyard/navigation/sidebar/tree_builder.rb +139 -0
- data/lib/docyard/navigation/sidebar/tree_filter.rb +55 -0
- data/lib/docyard/navigation/sidebar_builder.rb +159 -0
- data/lib/docyard/rendering/icon_helpers.rb +13 -0
- data/lib/docyard/{icons → rendering/icons}/phosphor.rb +26 -1
- data/lib/docyard/{markdown.rb → rendering/markdown.rb} +19 -13
- data/lib/docyard/rendering/renderer.rb +163 -0
- data/lib/docyard/rendering/template_resolver.rb +172 -0
- data/lib/docyard/routing/fallback_resolver.rb +92 -0
- data/lib/docyard/search/build_indexer.rb +74 -0
- data/lib/docyard/search/dev_indexer.rb +155 -0
- data/lib/docyard/search/pagefind_support.rb +33 -0
- data/lib/docyard/{asset_handler.rb → server/asset_handler.rb} +24 -19
- data/lib/docyard/{server.rb → server/dev_server.rb} +32 -9
- data/lib/docyard/server/pagefind_handler.rb +63 -0
- data/lib/docyard/{preview_server.rb → server/preview_server.rb} +2 -2
- data/lib/docyard/server/rack_application.rb +192 -0
- data/lib/docyard/server/resolution_result.rb +29 -0
- data/lib/docyard/{router.rb → server/router.rb} +4 -4
- data/lib/docyard/templates/assets/css/code.css +18 -51
- data/lib/docyard/templates/assets/css/components/breadcrumbs.css +143 -0
- data/lib/docyard/templates/assets/css/components/callout.css +67 -67
- data/lib/docyard/templates/assets/css/components/code-block.css +180 -282
- data/lib/docyard/templates/assets/css/components/heading-anchor.css +28 -15
- data/lib/docyard/templates/assets/css/components/icon.css +0 -1
- data/lib/docyard/templates/assets/css/components/logo.css +0 -2
- data/lib/docyard/templates/assets/css/components/nav-menu.css +237 -0
- data/lib/docyard/templates/assets/css/components/navigation.css +186 -167
- data/lib/docyard/templates/assets/css/components/prev-next.css +76 -47
- data/lib/docyard/templates/assets/css/components/search.css +561 -0
- data/lib/docyard/templates/assets/css/components/tab-bar.css +163 -0
- data/lib/docyard/templates/assets/css/components/table-of-contents.css +127 -114
- data/lib/docyard/templates/assets/css/components/tabs.css +119 -160
- data/lib/docyard/templates/assets/css/components/theme-toggle.css +48 -44
- data/lib/docyard/templates/assets/css/landing.css +815 -0
- data/lib/docyard/templates/assets/css/layout.css +503 -87
- data/lib/docyard/templates/assets/css/main.css +1 -3
- data/lib/docyard/templates/assets/css/markdown.css +111 -93
- data/lib/docyard/templates/assets/css/reset.css +0 -3
- data/lib/docyard/templates/assets/css/typography.css +43 -41
- data/lib/docyard/templates/assets/css/variables.css +268 -208
- data/lib/docyard/templates/assets/favicon.svg +7 -8
- data/lib/docyard/templates/assets/fonts/Inter-Variable.ttf +0 -0
- data/lib/docyard/templates/assets/js/components/code-block.js +24 -42
- data/lib/docyard/templates/assets/js/components/heading-anchor.js +26 -24
- data/lib/docyard/templates/assets/js/components/navigation.js +181 -70
- data/lib/docyard/templates/assets/js/components/search.js +610 -0
- data/lib/docyard/templates/assets/js/components/sidebar-toggle.js +29 -0
- data/lib/docyard/templates/assets/js/components/tab-navigation.js +145 -0
- data/lib/docyard/templates/assets/js/components/table-of-contents.js +153 -66
- data/lib/docyard/templates/assets/js/components/tabs.js +31 -69
- data/lib/docyard/templates/assets/js/theme.js +0 -3
- data/lib/docyard/templates/assets/logo-dark.svg +8 -2
- data/lib/docyard/templates/assets/logo.svg +7 -4
- data/lib/docyard/templates/config/docyard.yml.erb +37 -34
- data/lib/docyard/templates/errors/404.html.erb +1 -1
- data/lib/docyard/templates/errors/500.html.erb +1 -1
- data/lib/docyard/templates/layouts/default.html.erb +19 -56
- data/lib/docyard/templates/layouts/splash.html.erb +176 -0
- data/lib/docyard/templates/partials/_breadcrumbs.html.erb +24 -0
- data/lib/docyard/templates/partials/_code_block.html.erb +6 -4
- data/lib/docyard/templates/partials/_doc_footer.html.erb +25 -0
- data/lib/docyard/templates/partials/_features.html.erb +15 -0
- data/lib/docyard/templates/partials/_footer.html.erb +42 -0
- data/lib/docyard/templates/partials/_head.html.erb +22 -0
- data/lib/docyard/templates/partials/_header.html.erb +49 -0
- data/lib/docyard/templates/partials/_heading_anchor.html.erb +3 -1
- data/lib/docyard/templates/partials/_hero.html.erb +27 -0
- data/lib/docyard/templates/partials/_nav_group.html.erb +25 -11
- data/lib/docyard/templates/partials/_nav_leaf.html.erb +1 -1
- data/lib/docyard/templates/partials/_nav_menu.html.erb +42 -0
- data/lib/docyard/templates/partials/_nav_nested_section.html.erb +11 -0
- data/lib/docyard/templates/partials/_nav_section.html.erb +1 -1
- data/lib/docyard/templates/partials/_prev_next.html.erb +9 -3
- data/lib/docyard/templates/partials/_scripts.html.erb +7 -0
- data/lib/docyard/templates/partials/_search_modal.html.erb +41 -0
- data/lib/docyard/templates/partials/_search_trigger.html.erb +18 -0
- data/lib/docyard/templates/partials/_sidebar.html.erb +21 -4
- data/lib/docyard/templates/partials/_tab_bar.html.erb +25 -0
- data/lib/docyard/templates/partials/_table_of_contents.html.erb +12 -12
- data/lib/docyard/templates/partials/_table_of_contents_toggle.html.erb +1 -3
- data/lib/docyard/templates/partials/_tabs.html.erb +2 -2
- data/lib/docyard/templates/partials/_theme_toggle.html.erb +2 -11
- data/lib/docyard/utils/html_helpers.rb +14 -0
- data/lib/docyard/utils/path_resolver.rb +2 -1
- data/lib/docyard/utils/url_helpers.rb +20 -0
- data/lib/docyard/version.rb +1 -1
- data/lib/docyard.rb +22 -15
- metadata +89 -50
- data/lib/docyard/components/callout_processor.rb +0 -121
- data/lib/docyard/components/code_block_diff_preprocessor.rb +0 -104
- data/lib/docyard/components/code_block_feature_extractor.rb +0 -113
- data/lib/docyard/components/code_block_focus_preprocessor.rb +0 -77
- data/lib/docyard/components/code_block_icon_detector.rb +0 -40
- data/lib/docyard/components/code_block_line_wrapper.rb +0 -46
- data/lib/docyard/components/code_block_options_preprocessor.rb +0 -76
- data/lib/docyard/components/code_block_patterns.rb +0 -51
- data/lib/docyard/components/code_block_processor.rb +0 -176
- data/lib/docyard/components/code_detector.rb +0 -59
- data/lib/docyard/components/code_line_parser.rb +0 -80
- data/lib/docyard/components/code_snippet_import_preprocessor.rb +0 -125
- data/lib/docyard/components/heading_anchor_processor.rb +0 -34
- data/lib/docyard/components/icon_detector.rb +0 -57
- data/lib/docyard/components/icon_processor.rb +0 -51
- data/lib/docyard/components/table_of_contents_processor.rb +0 -64
- data/lib/docyard/components/table_wrapper_processor.rb +0 -18
- data/lib/docyard/components/tabs_parser.rb +0 -191
- data/lib/docyard/components/tabs_processor.rb +0 -44
- data/lib/docyard/components/tabs_range_finder.rb +0 -42
- data/lib/docyard/rack_application.rb +0 -172
- data/lib/docyard/renderer.rb +0 -120
- data/lib/docyard/routing/resolution_result.rb +0 -31
- data/lib/docyard/sidebar/config_parser.rb +0 -180
- data/lib/docyard/sidebar/item.rb +0 -58
- data/lib/docyard/sidebar/renderer.rb +0 -137
- data/lib/docyard/sidebar/tree_builder.rb +0 -59
- data/lib/docyard/sidebar_builder.rb +0 -102
- data/lib/docyard/templates/markdown/getting-started/installation.md.erb +0 -77
- data/lib/docyard/templates/markdown/guides/configuration.md.erb +0 -202
- data/lib/docyard/templates/markdown/guides/markdown-features.md.erb +0 -247
- data/lib/docyard/templates/markdown/index.md.erb +0 -82
- /data/lib/docyard/{sidebar → navigation/sidebar}/title_extractor.rb +0 -0
- /data/lib/docyard/{icons → rendering/icons}/LICENSE.phosphor +0 -0
- /data/lib/docyard/{icons → rendering/icons}/file_types.rb +0 -0
- /data/lib/docyard/{icons.rb → rendering/icons.rb} +0 -0
- /data/lib/docyard/{language_mapping.rb → rendering/language_mapping.rb} +0 -0
- /data/lib/docyard/{file_watcher.rb → server/file_watcher.rb} +0 -0
- /data/lib/docyard/{errors.rb → utils/errors.rb} +0 -0
- /data/lib/docyard/{logging.rb → utils/logging.rb} +0 -0
|
@@ -1,247 +0,0 @@
|
|
|
1
|
-
# Markdown Features
|
|
2
|
-
|
|
3
|
-
Docyard supports GitHub Flavored Markdown (GFM) plus powerful custom components.
|
|
4
|
-
|
|
5
|
-
## Basic Formatting
|
|
6
|
-
|
|
7
|
-
Use standard markdown syntax for formatting:
|
|
8
|
-
|
|
9
|
-
**Bold text** with `**bold**` or `__bold__`
|
|
10
|
-
|
|
11
|
-
*Italic text* with `*italic*` or `_italic_`
|
|
12
|
-
|
|
13
|
-
`Inline code` with \`backticks\`
|
|
14
|
-
|
|
15
|
-
~~Strikethrough~~ with `~~text~~`
|
|
16
|
-
|
|
17
|
-
## Headings
|
|
18
|
-
|
|
19
|
-
```markdown
|
|
20
|
-
# H1 Heading
|
|
21
|
-
## H2 Heading
|
|
22
|
-
### H3 Heading
|
|
23
|
-
#### H4 Heading
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## Lists
|
|
27
|
-
|
|
28
|
-
Unordered lists:
|
|
29
|
-
|
|
30
|
-
- Item one
|
|
31
|
-
- Item two
|
|
32
|
-
- Nested item
|
|
33
|
-
- Another nested item
|
|
34
|
-
- Item three
|
|
35
|
-
|
|
36
|
-
Ordered lists:
|
|
37
|
-
|
|
38
|
-
1. First step
|
|
39
|
-
2. Second step
|
|
40
|
-
3. Third step
|
|
41
|
-
|
|
42
|
-
Task lists:
|
|
43
|
-
|
|
44
|
-
- [x] Completed task
|
|
45
|
-
- [ ] Pending task
|
|
46
|
-
- [ ] Another pending task
|
|
47
|
-
|
|
48
|
-
## Code Blocks
|
|
49
|
-
|
|
50
|
-
Syntax highlighting for 100+ languages powered by Rouge:
|
|
51
|
-
|
|
52
|
-
```javascript
|
|
53
|
-
function greet(name) {
|
|
54
|
-
return `Hello, ${name}!`;
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
console.log(greet('World'));
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
```python
|
|
61
|
-
def greet(name):
|
|
62
|
-
return f"Hello, {name}!"
|
|
63
|
-
|
|
64
|
-
print(greet('World'))
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
```ruby
|
|
68
|
-
def greet(name)
|
|
69
|
-
"Hello, #{name}!"
|
|
70
|
-
end
|
|
71
|
-
|
|
72
|
-
puts greet('World')
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Each code block includes a copy button for easy copying.
|
|
76
|
-
|
|
77
|
-
## Tables
|
|
78
|
-
|
|
79
|
-
Create responsive tables with GFM syntax:
|
|
80
|
-
|
|
81
|
-
| Feature | Supported | Notes |
|
|
82
|
-
|---------|-----------|-------|
|
|
83
|
-
| Syntax highlighting | ✓ | 100+ languages |
|
|
84
|
-
| Hot reload | ✓ | Instant updates |
|
|
85
|
-
| Dark mode | ✓ | Auto-switching |
|
|
86
|
-
| Mobile responsive | ✓ | Works everywhere |
|
|
87
|
-
|
|
88
|
-
Tables automatically wrap on mobile devices.
|
|
89
|
-
|
|
90
|
-
## Blockquotes
|
|
91
|
-
|
|
92
|
-
> Standard blockquote for citations or highlights.
|
|
93
|
-
>
|
|
94
|
-
> Supports multiple paragraphs.
|
|
95
|
-
|
|
96
|
-
## Links
|
|
97
|
-
|
|
98
|
-
[Link to a page](../getting-started/installation)
|
|
99
|
-
|
|
100
|
-
[External link](https://github.com)
|
|
101
|
-
|
|
102
|
-
## Callouts
|
|
103
|
-
|
|
104
|
-
Use callouts to highlight important information:
|
|
105
|
-
|
|
106
|
-
::: note
|
|
107
|
-
Informational content that provides additional context.
|
|
108
|
-
:::
|
|
109
|
-
|
|
110
|
-
::: tip Best Practice
|
|
111
|
-
Helpful advice or recommendations for users.
|
|
112
|
-
:::
|
|
113
|
-
|
|
114
|
-
::: important
|
|
115
|
-
Critical information that requires special attention.
|
|
116
|
-
:::
|
|
117
|
-
|
|
118
|
-
::: warning
|
|
119
|
-
Caution about potential issues or things to watch out for.
|
|
120
|
-
:::
|
|
121
|
-
|
|
122
|
-
::: danger
|
|
123
|
-
Severe warnings about dangerous operations or critical issues.
|
|
124
|
-
:::
|
|
125
|
-
|
|
126
|
-
### Custom Titles
|
|
127
|
-
|
|
128
|
-
::: tip Performance Optimization
|
|
129
|
-
You can customize the title of any callout type.
|
|
130
|
-
:::
|
|
131
|
-
|
|
132
|
-
### Rich Content
|
|
133
|
-
|
|
134
|
-
::: important Key Requirements
|
|
135
|
-
Callouts support all markdown features:
|
|
136
|
-
|
|
137
|
-
- **Lists** and formatting
|
|
138
|
-
- `Code snippets`
|
|
139
|
-
- [Links](/)
|
|
140
|
-
- Code blocks with syntax highlighting
|
|
141
|
-
|
|
142
|
-
```ruby
|
|
143
|
-
def example
|
|
144
|
-
puts "Code works inside callouts!"
|
|
145
|
-
end
|
|
146
|
-
```
|
|
147
|
-
:::
|
|
148
|
-
|
|
149
|
-
## Tabs
|
|
150
|
-
|
|
151
|
-
Display multiple code examples or options in tabs:
|
|
152
|
-
|
|
153
|
-
:::tabs
|
|
154
|
-
== JavaScript
|
|
155
|
-
```javascript
|
|
156
|
-
const config = {
|
|
157
|
-
apiUrl: 'https://api.example.com',
|
|
158
|
-
timeout: 5000
|
|
159
|
-
};
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
== TypeScript
|
|
163
|
-
```typescript
|
|
164
|
-
interface Config {
|
|
165
|
-
apiUrl: string;
|
|
166
|
-
timeout: number;
|
|
167
|
-
}
|
|
168
|
-
|
|
169
|
-
const config: Config = {
|
|
170
|
-
apiUrl: 'https://api.example.com',
|
|
171
|
-
timeout: 5000
|
|
172
|
-
};
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
== Ruby
|
|
176
|
-
```ruby
|
|
177
|
-
config = {
|
|
178
|
-
api_url: 'https://api.example.com',
|
|
179
|
-
timeout: 5000
|
|
180
|
-
}
|
|
181
|
-
```
|
|
182
|
-
:::
|
|
183
|
-
|
|
184
|
-
### Package Manager Tabs
|
|
185
|
-
|
|
186
|
-
Perfect for installation instructions:
|
|
187
|
-
|
|
188
|
-
:::tabs
|
|
189
|
-
== npm
|
|
190
|
-
```bash
|
|
191
|
-
npm install your-package
|
|
192
|
-
```
|
|
193
|
-
|
|
194
|
-
== yarn
|
|
195
|
-
```bash
|
|
196
|
-
yarn add your-package
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
== pnpm
|
|
200
|
-
```bash
|
|
201
|
-
pnpm add your-package
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
== bun
|
|
205
|
-
```bash
|
|
206
|
-
bun add your-package
|
|
207
|
-
```
|
|
208
|
-
:::
|
|
209
|
-
|
|
210
|
-
Tabs automatically detect package managers and display appropriate icons.
|
|
211
|
-
|
|
212
|
-
## Icons
|
|
213
|
-
|
|
214
|
-
Use inline icons from [Phosphor Icons](https://phosphoricons.com):
|
|
215
|
-
|
|
216
|
-
:rocket-launch: :check: :warning: :heart: :star: :code: :book-open: :gear:
|
|
217
|
-
|
|
218
|
-
Just wrap the icon name in colons:
|
|
219
|
-
|
|
220
|
-
```markdown
|
|
221
|
-
:rocket-launch: :check: :warning:
|
|
222
|
-
```
|
|
223
|
-
|
|
224
|
-
Browse all available icons at [phosphoricons.com](https://phosphoricons.com).
|
|
225
|
-
|
|
226
|
-
## Horizontal Rules
|
|
227
|
-
|
|
228
|
-
Use three or more dashes, asterisks, or underscores:
|
|
229
|
-
|
|
230
|
-
---
|
|
231
|
-
|
|
232
|
-
## Best Practices
|
|
233
|
-
|
|
234
|
-
::: tip Writing Great Documentation
|
|
235
|
-
1. **Use headings hierarchically** - Don't skip levels (H1 → H3)
|
|
236
|
-
2. **Add code examples** - Show, don't just tell
|
|
237
|
-
3. **Use callouts sparingly** - Highlight only important information
|
|
238
|
-
4. **Keep it concise** - Respect your readers' time
|
|
239
|
-
5. **Link related pages** - Help users navigate your docs
|
|
240
|
-
:::
|
|
241
|
-
|
|
242
|
-
## Next Steps
|
|
243
|
-
|
|
244
|
-
::: note
|
|
245
|
-
- Learn how to [customize your site](configuration)
|
|
246
|
-
- Explore the [installation guide](../getting-started/installation)
|
|
247
|
-
:::
|
|
@@ -1,82 +0,0 @@
|
|
|
1
|
-
# Welcome to Your Documentation
|
|
2
|
-
|
|
3
|
-
This is your documentation homepage. Docyard transforms your Markdown files into beautiful, searchable documentation.
|
|
4
|
-
|
|
5
|
-
## Quick Example
|
|
6
|
-
|
|
7
|
-
Here's what you can do with Docyard:
|
|
8
|
-
|
|
9
|
-
### Code Blocks with Syntax Highlighting
|
|
10
|
-
|
|
11
|
-
```ruby
|
|
12
|
-
class User
|
|
13
|
-
attr_reader :name, :email
|
|
14
|
-
|
|
15
|
-
def initialize(name, email)
|
|
16
|
-
@name = name
|
|
17
|
-
@email = email
|
|
18
|
-
end
|
|
19
|
-
|
|
20
|
-
def greet
|
|
21
|
-
"Hello, #{name}!"
|
|
22
|
-
end
|
|
23
|
-
end
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
### Callouts for Important Information
|
|
27
|
-
|
|
28
|
-
::: tip Pro Tip
|
|
29
|
-
Use callouts to highlight important information. Available types: `note`, `tip`, `important`, `warning`, and `danger`.
|
|
30
|
-
:::
|
|
31
|
-
|
|
32
|
-
::: warning
|
|
33
|
-
Make sure to read the [Configuration Guide](guides/configuration) before deploying to production.
|
|
34
|
-
:::
|
|
35
|
-
|
|
36
|
-
### Tabs for Multiple Options
|
|
37
|
-
|
|
38
|
-
Show installation instructions for different package managers:
|
|
39
|
-
|
|
40
|
-
:::tabs
|
|
41
|
-
== npm
|
|
42
|
-
```bash
|
|
43
|
-
npm install your-package
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
== yarn
|
|
47
|
-
```bash
|
|
48
|
-
yarn add your-package
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
== pnpm
|
|
52
|
-
```bash
|
|
53
|
-
pnpm add your-package
|
|
54
|
-
```
|
|
55
|
-
:::
|
|
56
|
-
|
|
57
|
-
### Icons
|
|
58
|
-
|
|
59
|
-
Use inline icons from [Phosphor Icons](https://phosphoricons.com): :rocket-launch: :check: :warning: :heart:
|
|
60
|
-
|
|
61
|
-
## Getting Started
|
|
62
|
-
|
|
63
|
-
::: note Next Steps
|
|
64
|
-
1. Edit the files in `docs/` to create your documentation
|
|
65
|
-
2. Run `docyard serve` to preview changes in real-time
|
|
66
|
-
3. Customize `docyard.yml` to configure branding and navigation
|
|
67
|
-
4. Run `docyard build` when ready to deploy
|
|
68
|
-
:::
|
|
69
|
-
|
|
70
|
-
## Documentation Structure
|
|
71
|
-
|
|
72
|
-
| Section | Description |
|
|
73
|
-
|---------|-------------|
|
|
74
|
-
| [Installation](getting-started/installation) | Get up and running quickly |
|
|
75
|
-
| [Markdown Features](guides/markdown-features) | Learn about all supported features |
|
|
76
|
-
| [Configuration](guides/configuration) | Customize appearance and navigation |
|
|
77
|
-
|
|
78
|
-
## Need Help?
|
|
79
|
-
|
|
80
|
-
- Check out the [Markdown Features](guides/markdown-features) guide
|
|
81
|
-
- Learn about [customization options](guides/configuration)
|
|
82
|
-
- Explore the sidebar to see all available pages
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|