@knowcode/doc-builder 1.5.14 → 1.5.15

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.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,17 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.5.15] - 2025-07-22
9
+
10
+ ### Fixed
11
+ - Improved Phosphor icon vertical alignment using more aggressive CSS positioning
12
+ - Icons now use `vertical-align: text-top` with `top: 0.2em` offset for better x-height alignment
13
+ - Reduced line-height to 0.8 to prevent icons from affecting line spacing
14
+
15
+ ### Changed
16
+ - Enhanced icon CSS to ensure proper alignment across different text contexts
17
+ - Icons now properly align with the text baseline in all scenarios
18
+
8
19
  ## [1.5.14] - 2025-07-22
9
20
 
10
21
  ### Fixed
package/README.md CHANGED
@@ -2,17 +2,28 @@
2
2
 
3
3
  Beautiful documentation with the least effort possible. A zero-configuration documentation builder that transforms markdown files into stunning static sites.
4
4
 
5
- 🔗 **[View Live Example](https://doc-builder-delta.vercel.app)** - See what your documentation will look like!
5
+ <div align="center">
6
6
 
7
- ## TL:DR
7
+ 🔗 **[View Live Example](https://doc-builder-delta.vercel.app)** | 📦 **[NPM Package](https://www.npmjs.com/package/@knowcode/doc-builder)** | 📚 **[Documentation](https://doc-builder-delta.vercel.app)**
8
8
 
9
- ```
9
+ ### Quick Start
10
+ ```bash
10
11
  npx @knowcode/doc-builder deploy
11
12
  ```
12
13
 
13
- ## Why This Project Exists
14
+ </div>
15
+
16
+ ---
14
17
 
15
- The main premise of @knowcode/doc-builder is simple: **create beautiful documentation with the least effort possible**. We believe great documentation shouldn't require complex setup, configuration files, or deployment headaches. Just write markdown, run one command, and get a professional documentation site live on the web.
18
+ ## 🎯 Core Value Proposition
19
+
20
+ | **Problem** | **Solution** |
21
+ |------------|-------------|
22
+ | Complex documentation setup | Zero configuration needed |
23
+ | Deployment headaches | One-command Vercel deployment |
24
+ | Expensive hosting | Free tier with Vercel |
25
+ | Ugly default themes | Beautiful Notion-inspired design |
26
+ | Manual navigation | Auto-generated from folder structure |
16
27
 
17
28
  ## What It Does
18
29
 
@@ -38,51 +49,76 @@ We chose Vercel as our deployment platform because of their **generous free tier
38
49
 
39
50
  This aligns perfectly with our mission: beautiful documentation should be accessible to everyone, without worrying about hosting costs or complex server management.
40
51
 
41
- ## Features
52
+ ## Features
53
+
54
+ <table>
55
+ <tr>
56
+ <td width="50%">
42
57
 
43
- - 🚀 **Zero Configuration** - Works out of the box with sensible defaults
44
- - 📝 **Markdown Support** - Write docs in markdown with full GitHub Flavored Markdown support
45
- - 🎨 **Beautiful Default Theme** - Clean, responsive design inspired by Notion
46
- - 🔐 **Optional Authentication** - Password-protect your documentation
47
- - 📊 **Mermaid Diagrams** - Built-in support for diagrams and charts
48
- - 🌙 **Dark Mode** - Automatic dark mode support
49
- - 🔄 **Live Reload** - Development server with hot reloading
50
- - ☁️ **Vercel Integration** - One-command deployment to Vercel
51
- - 🔍 **SEO Optimized** - Meta tags, Open Graph, Twitter Cards, and structured data
52
- - ✅ **Google Site Verification** - Easy Google Search Console verification with CLI command
53
- - 📝 **Front Matter SEO** - Per-page titles, descriptions, and keywords with YAML front matter
54
- - 🎯 **SEO Analysis** - Built-in `seo-check` command to optimize your content
55
- - 📦 **Self-Contained** - No configuration or setup required
56
- - 🤖 **Claude Code Ready** - Optimized for AI-generated documentation workflows
58
+ ### 🛠️ Core Features
59
+ - 🚀 **Zero Configuration** - Works out of the box
60
+ - 📝 **Markdown Support** - Full GitHub Flavored Markdown
61
+ - 🎨 **Beautiful Theme** - Notion-inspired design
62
+ - 🔄 **Live Reload** - Hot reloading dev server
63
+ - 📦 **Self-Contained** - No setup required
64
+ - 🤖 **Claude Code Ready** - AI-optimized workflows
57
65
 
58
- ## Quick Start
66
+ </td>
67
+ <td width="50%">
59
68
 
60
- No installation needed! Just run:
69
+ ### 🎯 Advanced Features
70
+ - 🔍 **SEO Optimized** - Meta tags & structured data
71
+ - 🔐 **Authentication** - Password protection
72
+ - 📊 **Mermaid Diagrams** - Built-in diagram support
73
+ - 🌙 **Dark Mode** - Automatic theme switching
74
+ - ☁️ **Vercel Deploy** - One-command deployment
75
+ - ✅ **Google Verification** - Search Console ready
61
76
 
77
+ </td>
78
+ </tr>
79
+ </table>
80
+
81
+ ## 🚀 Getting Started
82
+
83
+ <table>
84
+ <tr>
85
+ <td width="50%">
86
+
87
+ ### Option 1: NPX (No Installation)
62
88
  ```bash
63
- # Build and deploy to Vercel
89
+ # Deploy to Vercel
64
90
  npx @knowcode/doc-builder deploy
65
91
 
66
- # Other available commands:
67
- npx @knowcode/doc-builder build # Build HTML files only
68
- npx @knowcode/doc-builder dev # Start development server
69
- npx @knowcode/doc-builder # Show help (default behavior)
70
- ```
92
+ # Build static HTML
93
+ npx @knowcode/doc-builder build
94
+
95
+ # Development server
96
+ npx @knowcode/doc-builder dev
71
97
 
72
- ## Installation (Optional)
98
+ # Show help
99
+ npx @knowcode/doc-builder
100
+ ```
101
+ *Perfect for trying it out!*
73
102
 
74
- For faster execution and offline use:
103
+ </td>
104
+ <td width="50%">
75
105
 
106
+ ### Option 2: NPM Install
76
107
  ```bash
108
+ # Install as dev dependency
77
109
  npm install --save-dev @knowcode/doc-builder
78
- ```
79
110
 
80
- Then use shorter commands:
81
- ```bash
111
+ # Use shorter commands
112
+ doc-builder deploy
82
113
  doc-builder build
83
114
  doc-builder dev
84
- doc-builder deploy
115
+ doc-builder --help
85
116
  ```
117
+ *Better for regular use & offline access*
118
+
119
+ </td>
120
+ </tr>
121
+ </table>
86
122
 
87
123
  ## First-Time Vercel Deployment
88
124
 
@@ -137,132 +173,116 @@ module.exports = {
137
173
  };
138
174
  ```
139
175
 
140
- ## Commands
141
-
142
- ### set-production-url
143
- Set a custom production URL to display after deployment:
144
- ```bash
145
- # Set your custom production URL
146
- npx @knowcode/doc-builder set-production-url doc-builder-delta.vercel.app
147
-
148
- # Or with full protocol
149
- npx @knowcode/doc-builder set-production-url https://my-custom-domain.com
150
- ```
151
-
152
- This is useful when you have a custom domain or Vercel alias that differs from the auto-detected URL.
153
-
154
- ### google-verify
155
-
156
- Add Google site verification meta tag for Google Search Console:
157
-
158
- ```bash
159
- # Add your verification code
160
- npx @knowcode/doc-builder google-verify YOUR_VERIFICATION_CODE
161
-
162
- # Example
163
- npx @knowcode/doc-builder google-verify FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ
164
- ```
165
-
166
- This adds the verification meta tag to all generated HTML pages, allowing you to verify ownership in Google Search Console. See the [Google Site Verification Guide](docs/guides/google-site-verification-guide.md) for complete details.
176
+ ## 📋 Commands Overview
167
177
 
168
- ### seo-check
178
+ <table>
179
+ <tr>
180
+ <td width="33%">
169
181
 
170
- Analyze and optimize your documentation's SEO:
171
-
172
- ```bash
173
- # Check all pages for SEO issues
174
- npx @knowcode/doc-builder seo-check
182
+ ### 🏗️ Core Commands
183
+ | Command | Purpose |
184
+ |---------|---------|
185
+ | `build` | Generate static HTML |
186
+ | `dev` | Start dev server |
187
+ | `deploy` | Deploy to Vercel |
188
+ | `init` | Initialize project |
175
189
 
176
- # Check a specific page
177
- npx @knowcode/doc-builder seo-check docs/guide.md
190
+ </td>
191
+ <td width="33%">
178
192
 
179
- # Future: Auto-fix common issues
180
- npx @knowcode/doc-builder seo-check --fix
181
- ```
193
+ ### 🔍 SEO Commands
194
+ | Command | Purpose |
195
+ |---------|---------|
196
+ | `seo-check` | Analyze SEO |
197
+ | `setup-seo` | Configure SEO |
198
+ | `google-verify` | Add verification |
182
199
 
183
- This command analyzes:
184
- - Title length and optimization (50-60 characters)
185
- - Meta descriptions (140-160 characters)
186
- - Keywords usage and relevance
187
- - Front matter SEO fields
188
- - Content quality signals
200
+ </td>
201
+ <td width="33%">
189
202
 
190
- See the [SEO Optimization Guide](docs/guides/seo-optimization-guide.md) for best practices.
203
+ ### ⚙️ Config Commands
204
+ | Command | Purpose |
205
+ |---------|---------|
206
+ | `set-production-url` | Set custom URL |
207
+ | `reset-vercel` | Clear settings |
191
208
 
192
- ### setup-seo
193
- Interactive SEO configuration wizard:
194
- ```bash
195
- # Configure all SEO settings
196
- npx @knowcode/doc-builder setup-seo
197
- ```
209
+ </td>
210
+ </tr>
211
+ </table>
198
212
 
199
- This wizard helps you set up:
200
- - Site URL and author information
201
- - Social media meta tags (Open Graph, Twitter Cards)
202
- - Structured data (JSON-LD)
203
- - Automatic sitemap and robots.txt generation
213
+ ### 📌 Command Details
204
214
 
205
- See the [SEO Guide](docs/guides/seo-guide.md) for complete details.
215
+ <details>
216
+ <summary><b>🏗️ build</b> - Generate static HTML files</summary>
206
217
 
207
- ### build (defaults will work just fine)
208
- Build the documentation site to static HTML:
209
218
  ```bash
210
219
  doc-builder build [options]
211
220
 
212
221
  Options:
213
222
  -c, --config <path> Path to config file (default: "doc-builder.config.js")
214
- -i, --input <dir> Input directory containing markdown files (default: docs)
215
- -o, --output <dir> Output directory for HTML files (default: html)
216
- --preset <preset> Use a preset configuration (available: cybersolstice)
217
- --legacy Use legacy mode for backward compatibility
218
- --no-auth Disable authentication even if configured
219
- --no-changelog Disable automatic changelog generation
223
+ -i, --input <dir> Input directory (default: docs)
224
+ -o, --output <dir> Output directory (default: html)
225
+ --preset <preset> Use a preset configuration
226
+ --no-auth Disable authentication
227
+ --no-changelog Disable changelog generation
220
228
 
221
229
  Examples:
222
- doc-builder build # Build with defaults
230
+ doc-builder build # Build with defaults
223
231
  doc-builder build --input docs --output dist
224
- doc-builder build --preset notion-inspired # Use Notion-inspired preset
225
- doc-builder build --config my-config.js # Use custom config
232
+ doc-builder build --preset notion-inspired
226
233
  ```
234
+ </details>
235
+
236
+ <details>
237
+ <summary><b>☁️ deploy</b> - Deploy to Vercel</summary>
227
238
 
228
- ### deploy
229
- Deploy documentation to Vercel (requires Vercel CLI):
230
239
  ```bash
231
240
  doc-builder deploy [options]
232
241
 
233
242
  Options:
234
- -c, --config <path> Path to config file (default: "doc-builder.config.js")
235
- --no-prod Deploy as preview instead of production
236
- --force Force deployment without confirmation
237
- --production-url <url> Override production URL for this deployment
243
+ -c, --config <path> Path to config file
244
+ --no-prod Deploy as preview
245
+ --force Force without confirmation
246
+ --production-url <url> Override production URL
238
247
 
239
248
  Examples:
240
- doc-builder deploy # Deploy to production
241
- doc-builder deploy --no-prod # Deploy as preview only
242
- doc-builder deploy --production-url my-docs.vercel.app # Use custom URL display
243
-
244
- First-time setup:
245
- The tool will guide you through:
246
- 1. Installing Vercel CLI (if needed)
247
- 2. Creating a new Vercel project
248
- 3. Configuring deployment settings
249
-
250
- Important: After deployment, disable Vercel Authentication in project settings for public docs.
249
+ doc-builder deploy # Deploy to production
250
+ doc-builder deploy --no-prod # Deploy as preview
251
+ doc-builder deploy --production-url my-docs.vercel.app
251
252
  ```
253
+ </details>
254
+
255
+ <details>
256
+ <summary><b>🔍 seo-check</b> - Analyze SEO optimization</summary>
252
257
 
253
- ### init
254
- Initialize doc-builder in your project:
255
258
  ```bash
256
- doc-builder init [options]
259
+ doc-builder seo-check [file]
257
260
 
258
- Options:
259
- --config Create configuration file
260
- --example Create example documentation structure
261
+ Analyzes:
262
+ Title length (50-60 chars)
263
+ Meta descriptions (140-160 chars)
264
+ • Keywords usage
265
+ • Front matter SEO fields
266
+ • Content quality signals
267
+
268
+ Examples:
269
+ doc-builder seo-check # Check all pages
270
+ doc-builder seo-check docs/guide.md # Check specific page
271
+ ```
272
+ </details>
273
+
274
+ <details>
275
+ <summary><b>✅ google-verify</b> - Add Google verification</summary>
276
+
277
+ ```bash
278
+ doc-builder google-verify <code>
261
279
 
262
280
  Examples:
263
- doc-builder init --config # Create doc-builder.config.js
264
- doc-builder init --example # Create example docs folder
281
+ doc-builder google-verify YOUR_VERIFICATION_CODE
282
+ doc-builder google-verify FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ
265
283
  ```
284
+ </details>
285
+
266
286
 
267
287
  ## Project Structure
268
288
 
@@ -322,107 +342,153 @@ When using Claude Code to generate documentation, it typically follows these pat
322
342
  - **Review Generated Content**: Always review AI-generated documentation for accuracy
323
343
  - **Maintain CLAUDE.md**: Keep project-specific instructions in a CLAUDE.md file for consistent documentation style
324
344
 
325
- ## Troubleshooting
345
+ ## 🔧 Troubleshooting
346
+
347
+ <table>
348
+ <tr>
349
+ <td width="50%">
350
+
351
+ ### 🐛 Common Issues
352
+
353
+ **"Command not found" error**
354
+ ```bash
355
+ # Check Node.js version
356
+ node --version # Need 14+
357
+
358
+ # Use full package name
359
+ npx @knowcode/doc-builder
360
+ ```
361
+
362
+ **"No markdown files found"**
363
+ - Docs in `docs/` folder?
364
+ - Files have `.md` extension?
365
+ - Try: `--input ./my-docs`
366
+
367
+ **Vercel deployment fails**
368
+ ```bash
369
+ # Reset Vercel settings
370
+ npx @knowcode/doc-builder reset-vercel
326
371
 
327
- ### NPX Cache Issues
372
+ # Install Vercel CLI
373
+ npm install -g vercel
374
+ ```
375
+
376
+ </td>
377
+ <td width="50%">
328
378
 
329
- The npx command caches packages to speed up subsequent runs. However, this can sometimes cause you to run an older version even after updating.
379
+ ### ⚠️ NPX Cache Issues
330
380
 
331
381
  **Symptoms:**
332
- - Running `npx @knowcode/doc-builder` shows an old version number
333
- - New features aren't available despite updating
334
- - Changes don't appear after publishing a new version
382
+ - Old version runs despite update
383
+ - New features unavailable
384
+ - Wrong version number shown
335
385
 
336
- **Solution:**
386
+ **Solutions:**
337
387
  ```bash
338
- # Clear the npx cache
388
+ # Clear NPX cache
339
389
  npx clear-npx-cache
340
390
 
341
- # Force the latest version
391
+ # Force latest version
342
392
  npx @knowcode/doc-builder@latest
343
393
 
344
- # Or specify an exact version
345
- npx @knowcode/doc-builder@1.4.22
394
+ # Use specific version
395
+ npx @knowcode/doc-builder@1.5.14
346
396
  ```
347
397
 
348
398
  **Prevention:**
349
- - Always use `@latest` when you want the newest version
350
- - Clear cache periodically when developing/testing new versions
351
- - Use `npm install` for projects where you need a specific version
399
+ - Always use `@latest` for newest
400
+ - Clear cache when testing
401
+ - Use `npm install` for projects
352
402
 
353
- ### Other Common Issues
403
+ </td>
404
+ </tr>
405
+ </table>
354
406
 
355
- **"Command not found" error**
356
- - Ensure Node.js 14+ is installed: `node --version`
357
- - Try with full package name: `npx @knowcode/doc-builder`
407
+ ### 🔗 Production URL Issues
358
408
 
359
- **Build fails with "No markdown files found"**
360
- - Check that your docs are in the `docs/` folder (or specified input directory)
361
- - Ensure files have `.md` extension
362
- - Use `--input` flag to specify a different directory
409
+ <details>
410
+ <summary>Wrong URL displayed after deployment?</summary>
363
411
 
364
- **Vercel deployment fails**
365
- - Run `npx @knowcode/doc-builder reset-vercel` to clear settings
366
- - Ensure Vercel CLI is installed: `npm install -g vercel`
367
- - Check that the `html/` directory was created by build command
368
-
369
- **Wrong production URL displayed**
370
- - The deployment may show a deployment-specific URL instead of your custom domain
371
- - Solution 1: Set production URL in config:
372
- ```javascript
373
- // doc-builder.config.js
374
- module.exports = {
375
- productionUrl: 'https://my-docs.vercel.app',
376
- // ... other config
377
- };
378
- ```
379
- - Solution 2: Use command to set it:
380
- ```bash
381
- npx @knowcode/doc-builder set-production-url my-docs.vercel.app
382
- ```
383
- - Solution 3: Override for a single deployment:
384
- ```bash
385
- npx @knowcode/doc-builder deploy --production-url my-docs.vercel.app
386
- ```
387
-
388
- ## Using in Other Projects
389
-
390
- ### Option 1: NPM Link (Development)
391
-
392
- While developing the doc-builder:
412
+ **Option 1: Config File**
413
+ ```javascript
414
+ // doc-builder.config.js
415
+ module.exports = {
416
+ productionUrl: 'https://my-docs.vercel.app'
417
+ };
418
+ ```
419
+
420
+ **Option 2: CLI Command**
421
+ ```bash
422
+ npx @knowcode/doc-builder set-production-url my-docs.vercel.app
423
+ ```
424
+
425
+ **Option 3: Deploy Override**
426
+ ```bash
427
+ npx @knowcode/doc-builder deploy --production-url my-docs.vercel.app
428
+ ```
429
+ </details>
430
+
431
+ ## 🔗 Integration Options
393
432
 
433
+ <table>
434
+ <tr>
435
+ <td width="33%">
436
+
437
+ ### NPM Link (Dev)
394
438
  ```bash
395
- # In doc-builder directory
439
+ # In doc-builder dir
396
440
  npm link
397
441
 
398
- # In your other project
442
+ # In your project
399
443
  npm link @knowcode/doc-builder
400
444
  ```
445
+ *For local development*
401
446
 
402
- ### Option 2: File Reference
403
-
404
- In your project's `package.json`:
447
+ </td>
448
+ <td width="33%">
405
449
 
450
+ ### File Reference
406
451
  ```json
407
452
  {
408
453
  "devDependencies": {
409
- "@knowcode/doc-builder": "file:../path/to/doc-builder"
454
+ "@knowcode/doc-builder":
455
+ "file:../path/to/doc-builder"
410
456
  }
411
457
  }
412
458
  ```
459
+ *For monorepos*
413
460
 
414
- ### Option 3: Git Repository
415
-
416
- Once published:
461
+ </td>
462
+ <td width="33%">
417
463
 
464
+ ### Git Repository
418
465
  ```json
419
466
  {
420
467
  "devDependencies": {
421
- "@knowcode/doc-builder": "git+https://github.com/knowcode/doc-builder.git"
468
+ "@knowcode/doc-builder":
469
+ "git+https://github.com/
470
+ knowcode/doc-builder.git"
422
471
  }
423
472
  }
424
473
  ```
474
+ *For private repos*
475
+
476
+ </td>
477
+ </tr>
478
+ </table>
479
+
480
+ ## 📄 License
481
+
482
+ MIT License - See [LICENSE](LICENSE) file for details
483
+
484
+ ---
485
+
486
+ <div align="center">
487
+
488
+ ### Quick Links
489
+
490
+ [**NPM Package**](https://www.npmjs.com/package/@knowcode/doc-builder) | [**Live Demo**](https://doc-builder-delta.vercel.app) | [**Report Issues**](https://github.com/knowcode/doc-builder/issues) | [**Changelog**](CHANGELOG.md)
425
491
 
426
- ## License
492
+ Made with ❤️ by the @knowcode team
427
493
 
428
- MIT
494
+ </div>
@@ -1905,31 +1905,55 @@ tr:hover {
1905
1905
  /* Phosphor Icons Alignment */
1906
1906
  .ph {
1907
1907
  display: inline-block;
1908
- vertical-align: middle;
1909
- line-height: 1;
1908
+ vertical-align: text-top;
1909
+ line-height: 0.8;
1910
1910
  position: relative;
1911
- top: -0.05em; /* Fine-tune vertical centering */
1911
+ top: 0.2em; /* Push down to align with x-height of text */
1912
1912
  }
1913
1913
 
1914
- /* Ensure icons in headings are properly sized */
1914
+ /* Ensure icons in headings are properly aligned */
1915
1915
  h1 .ph, h2 .ph, h3 .ph, h4 .ph, h5 .ph, h6 .ph {
1916
- vertical-align: baseline;
1917
- top: -0.1em;
1916
+ font-size: 0.85em; /* Slightly smaller in headings */
1917
+ line-height: 0.8;
1918
+ top: 0.15em;
1918
1919
  }
1919
1920
 
1920
1921
  /* Icons in lists need special handling */
1921
1922
  li .ph {
1922
- margin-right: 0.2em;
1923
+ margin-right: 0.3em;
1924
+ font-size: 1.05em;
1925
+ line-height: 0.85;
1926
+ top: 0.15em;
1923
1927
  }
1924
1928
 
1925
1929
  /* Icons in tables */
1926
1930
  td .ph, th .ph {
1927
- vertical-align: middle;
1931
+ line-height: 0.8;
1932
+ top: 0.2em;
1928
1933
  }
1929
1934
 
1930
1935
  /* Icons in navigation */
1931
1936
  .nav-item .ph,
1932
1937
  .nav-title .ph {
1933
1938
  vertical-align: middle;
1939
+ line-height: 1;
1934
1940
  top: 0; /* Navigation items are flex, so no adjustment needed */
1941
+ }
1942
+
1943
+ /* Icon size adjustments for better visual balance */
1944
+ .content p .ph {
1945
+ font-size: 1.05em; /* Slightly larger than text for visual balance */
1946
+ }
1947
+
1948
+ /* Special handling for inline code with icons */
1949
+ code .ph {
1950
+ font-size: 0.9em;
1951
+ vertical-align: middle;
1952
+ line-height: 1;
1953
+ top: 0;
1954
+ }
1955
+
1956
+ /* Additional fine-tuning for specific contexts */
1957
+ .content-inner .ph {
1958
+ transform: translateY(0.05em); /* Very slight additional adjustment */
1935
1959
  }
package/html/README.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:51.999Z",
66
- "dateModified": "2025-07-22T11:08:51.999Z",
65
+ "datePublished": "2025-07-22T11:15:59.515Z",
66
+ "dateModified": "2025-07-22T11:15:59.515Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -1905,26 +1905,29 @@ tr:hover {
1905
1905
  /* Phosphor Icons Alignment */
1906
1906
  .ph {
1907
1907
  display: inline-block;
1908
- vertical-align: middle;
1908
+ vertical-align: text-bottom;
1909
1909
  line-height: 1;
1910
1910
  position: relative;
1911
- top: -0.05em; /* Fine-tune vertical centering */
1911
+ top: 0.125em; /* Move down to align with text baseline */
1912
1912
  }
1913
1913
 
1914
- /* Ensure icons in headings are properly sized */
1914
+ /* Ensure icons in headings are properly aligned */
1915
1915
  h1 .ph, h2 .ph, h3 .ph, h4 .ph, h5 .ph, h6 .ph {
1916
+ font-size: 0.9em; /* Slightly smaller in headings */
1916
1917
  vertical-align: baseline;
1917
- top: -0.1em;
1918
+ top: 0.1em;
1918
1919
  }
1919
1920
 
1920
1921
  /* Icons in lists need special handling */
1921
1922
  li .ph {
1922
- margin-right: 0.2em;
1923
+ margin-right: 0.3em;
1924
+ top: 0.1em;
1923
1925
  }
1924
1926
 
1925
1927
  /* Icons in tables */
1926
1928
  td .ph, th .ph {
1927
- vertical-align: middle;
1929
+ vertical-align: text-bottom;
1930
+ top: 0.125em;
1928
1931
  }
1929
1932
 
1930
1933
  /* Icons in navigation */
@@ -1932,4 +1935,17 @@ td .ph, th .ph {
1932
1935
  .nav-title .ph {
1933
1936
  vertical-align: middle;
1934
1937
  top: 0; /* Navigation items are flex, so no adjustment needed */
1938
+ }
1939
+
1940
+ /* Icon size adjustments for better visual balance */
1941
+ .content p .ph,
1942
+ .content li .ph {
1943
+ font-size: 1.1em; /* Slightly larger than text for visual balance */
1944
+ }
1945
+
1946
+ /* Special handling for inline code with icons */
1947
+ code .ph {
1948
+ font-size: 0.9em;
1949
+ vertical-align: baseline;
1950
+ top: 0;
1935
1951
  }
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.109Z",
66
- "dateModified": "2025-07-22T11:08:52.109Z",
65
+ "datePublished": "2025-07-22T11:15:59.526Z",
66
+ "dateModified": "2025-07-22T11:15:59.526Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.112Z",
66
- "dateModified": "2025-07-22T11:08:52.112Z",
65
+ "datePublished": "2025-07-22T11:15:59.535Z",
66
+ "dateModified": "2025-07-22T11:15:59.535Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.114Z",
66
- "dateModified": "2025-07-22T11:08:52.114Z",
65
+ "datePublished": "2025-07-22T11:15:59.545Z",
66
+ "dateModified": "2025-07-22T11:15:59.545Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.118Z",
66
- "dateModified": "2025-07-22T11:08:52.118Z",
65
+ "datePublished": "2025-07-22T11:15:59.549Z",
66
+ "dateModified": "2025-07-22T11:15:59.549Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.124Z",
66
- "dateModified": "2025-07-22T11:08:52.124Z",
65
+ "datePublished": "2025-07-22T11:15:59.564Z",
66
+ "dateModified": "2025-07-22T11:15:59.564Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.127Z",
66
- "dateModified": "2025-07-22T11:08:52.127Z",
65
+ "datePublished": "2025-07-22T11:15:59.570Z",
66
+ "dateModified": "2025-07-22T11:15:59.570Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.130Z",
66
- "dateModified": "2025-07-22T11:08:52.130Z",
65
+ "datePublished": "2025-07-22T11:15:59.575Z",
66
+ "dateModified": "2025-07-22T11:15:59.575Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.136Z",
66
- "dateModified": "2025-07-22T11:08:52.136Z",
65
+ "datePublished": "2025-07-22T11:15:59.583Z",
66
+ "dateModified": "2025-07-22T11:15:59.583Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.140Z",
66
- "dateModified": "2025-07-22T11:08:52.140Z",
65
+ "datePublished": "2025-07-22T11:15:59.590Z",
66
+ "dateModified": "2025-07-22T11:15:59.590Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
@@ -102,7 +102,7 @@
102
102
 
103
103
  <div class="header-actions">
104
104
  <div class="deployment-info">
105
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
105
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
106
106
  </div>
107
107
 
108
108
 
package/html/index.html CHANGED
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:51.999Z",
66
- "dateModified": "2025-07-22T11:08:51.999Z",
65
+ "datePublished": "2025-07-22T11:15:59.515Z",
66
+ "dateModified": "2025-07-22T11:15:59.515Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/html/sitemap.xml CHANGED
@@ -2,97 +2,97 @@
2
2
  <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
3
3
  <url>
4
4
  <loc>https://doc-builder-delta.vercel.app/404.html</loc>
5
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
5
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
6
6
  <changefreq>monthly</changefreq>
7
7
  <priority>0.6</priority>
8
8
  </url>
9
9
  <url>
10
10
  <loc>https://doc-builder-delta.vercel.app/README.html</loc>
11
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
11
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
12
12
  <changefreq>monthly</changefreq>
13
13
  <priority>0.6</priority>
14
14
  </url>
15
15
  <url>
16
16
  <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
17
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
17
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
18
18
  <changefreq>monthly</changefreq>
19
19
  <priority>0.8</priority>
20
20
  </url>
21
21
  <url>
22
22
  <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
23
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
23
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
24
24
  <changefreq>monthly</changefreq>
25
25
  <priority>0.6</priority>
26
26
  </url>
27
27
  <url>
28
28
  <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
29
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
29
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
30
30
  <changefreq>monthly</changefreq>
31
31
  <priority>0.8</priority>
32
32
  </url>
33
33
  <url>
34
34
  <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
35
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
35
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
36
36
  <changefreq>monthly</changefreq>
37
37
  <priority>0.8</priority>
38
38
  </url>
39
39
  <url>
40
40
  <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
41
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
41
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
42
42
  <changefreq>monthly</changefreq>
43
43
  <priority>0.8</priority>
44
44
  </url>
45
45
  <url>
46
46
  <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
47
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
47
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
48
48
  <changefreq>monthly</changefreq>
49
49
  <priority>0.8</priority>
50
50
  </url>
51
51
  <url>
52
52
  <loc>https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html</loc>
53
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
53
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
54
54
  <changefreq>monthly</changefreq>
55
55
  <priority>0.8</priority>
56
56
  </url>
57
57
  <url>
58
58
  <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
59
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
59
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
60
60
  <changefreq>monthly</changefreq>
61
61
  <priority>0.8</priority>
62
62
  </url>
63
63
  <url>
64
64
  <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
65
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
65
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
66
66
  <changefreq>monthly</changefreq>
67
67
  <priority>0.8</priority>
68
68
  </url>
69
69
  <url>
70
70
  <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
71
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
71
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
72
72
  <changefreq>monthly</changefreq>
73
73
  <priority>0.8</priority>
74
74
  </url>
75
75
  <url>
76
76
  <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
77
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
77
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
78
78
  <changefreq>monthly</changefreq>
79
79
  <priority>0.8</priority>
80
80
  </url>
81
81
  <url>
82
82
  <loc>https://doc-builder-delta.vercel.app/index.html</loc>
83
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
83
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
84
84
  <changefreq>weekly</changefreq>
85
85
  <priority>1.0</priority>
86
86
  </url>
87
87
  <url>
88
88
  <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
89
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
89
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
90
90
  <changefreq>monthly</changefreq>
91
91
  <priority>0.8</priority>
92
92
  </url>
93
93
  <url>
94
94
  <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
95
- <lastmod>2025-07-22T11:08:52.151Z</lastmod>
95
+ <lastmod>2025-07-22T11:15:59.635Z</lastmod>
96
96
  <changefreq>monthly</changefreq>
97
97
  <priority>0.8</priority>
98
98
  </url>
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.142Z",
66
- "dateModified": "2025-07-22T11:08:52.142Z",
65
+ "datePublished": "2025-07-22T11:15:59.593Z",
66
+ "dateModified": "2025-07-22T11:15:59.593Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
100
100
  </div>
101
101
 
102
102
 
@@ -62,8 +62,8 @@
62
62
  "name": "Knowcode Ltd",
63
63
  "url": "https://knowcode.tech"
64
64
  },
65
- "datePublished": "2025-07-22T11:08:52.144Z",
66
- "dateModified": "2025-07-22T11:08:52.144Z",
65
+ "datePublished": "2025-07-22T11:15:59.605Z",
66
+ "dateModified": "2025-07-22T11:15:59.605Z",
67
67
  "mainEntityOfPage": {
68
68
  "@type": "WebPage",
69
69
  "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -96,7 +96,7 @@
96
96
 
97
97
  <div class="header-actions">
98
98
  <div class="deployment-info">
99
- <span class="deployment-date" title="Built with doc-builder v1.5.13">Last updated: Jul 22, 2025, 11:08 AM UTC</span>
99
+ <span class="deployment-date" title="Built with doc-builder v1.5.14">Last updated: Jul 22, 2025, 11:15 AM UTC</span>
100
100
  </div>
101
101
 
102
102
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@knowcode/doc-builder",
3
- "version": "1.5.14",
3
+ "version": "1.5.15",
4
4
  "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
5
5
  "main": "index.js",
6
6
  "bin": {