@knowcode/doc-builder 1.5.9 → 1.5.10
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/.claude/settings.local.json +2 -1
- package/CHANGELOG.md +13 -0
- package/cli.js +3 -3
- package/html/README.html +3 -3
- package/html/documentation-index.html +3 -3
- package/html/guides/authentication-guide.html +3 -3
- package/html/guides/claude-workflow-guide.html +3 -3
- package/html/guides/documentation-standards.html +3 -3
- package/html/guides/google-site-verification-guide.html +3 -3
- package/html/guides/seo-guide.html +3 -3
- package/html/guides/seo-optimization-guide.html +3 -3
- package/html/guides/troubleshooting-guide.html +3 -3
- package/html/index.html +3 -3
- package/html/sitemap.xml +15 -15
- package/html/vercel-cli-setup-guide.html +3 -3
- package/html/vercel-first-time-setup-guide.html +3 -3
- package/lib/config.js +7 -3
- package/lib/core-builder.js +14 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,19 @@ 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.10] - 2025-07-22
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
- Automatically create missing docs directory when running build, dev, or deploy commands
|
|
12
|
+
- No longer fails with "ENOENT: no such file or directory" when docs folder is missing
|
|
13
|
+
- Creates placeholder README.md in newly created docs directory
|
|
14
|
+
- Removed duplicate warning messages about missing docs directory
|
|
15
|
+
|
|
16
|
+
### Improved
|
|
17
|
+
- Better handling of empty projects - just run `doc-builder build` and it creates everything needed
|
|
18
|
+
- Cleaner console output without redundant warnings
|
|
19
|
+
- Ensures output directory exists before building
|
|
20
|
+
|
|
8
21
|
## [1.5.9] - 2025-07-22
|
|
9
22
|
|
|
10
23
|
### Added
|
package/cli.js
CHANGED
|
@@ -83,7 +83,7 @@ ${chalk.yellow('Examples:')}
|
|
|
83
83
|
const spinner = ora('Building documentation...').start();
|
|
84
84
|
|
|
85
85
|
try {
|
|
86
|
-
const config = await loadConfig(options.config || 'doc-builder.config.js', options);
|
|
86
|
+
const config = await loadConfig(options.config || 'doc-builder.config.js', { ...options, command: 'build' });
|
|
87
87
|
await build(config);
|
|
88
88
|
spinner.succeed('Documentation built successfully!');
|
|
89
89
|
} catch (error) {
|
|
@@ -112,7 +112,7 @@ ${chalk.yellow('Examples:')}
|
|
|
112
112
|
`)
|
|
113
113
|
.action(async (options) => {
|
|
114
114
|
try {
|
|
115
|
-
const config = await loadConfig(options.config, options);
|
|
115
|
+
const config = await loadConfig(options.config, { ...options, command: 'dev' });
|
|
116
116
|
await startDevServer(config, options.port);
|
|
117
117
|
} catch (error) {
|
|
118
118
|
console.error(chalk.red(error.message));
|
|
@@ -645,7 +645,7 @@ ${chalk.yellow('Troubleshooting:')}
|
|
|
645
645
|
const spinner = ora('Deploying to Vercel...').start();
|
|
646
646
|
|
|
647
647
|
try {
|
|
648
|
-
const config = await loadConfig(options.config || 'doc-builder.config.js', options);
|
|
648
|
+
const config = await loadConfig(options.config || 'doc-builder.config.js', { ...options, command: 'deploy' });
|
|
649
649
|
|
|
650
650
|
// First check if Vercel CLI is installed
|
|
651
651
|
try {
|
package/html/README.html
CHANGED
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.098Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.098Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/README.html"
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
<div class="header-actions">
|
|
97
97
|
<div class="deployment-info">
|
|
98
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
98
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
99
99
|
</div>
|
|
100
100
|
|
|
101
101
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.109Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.109Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
<div class="header-actions">
|
|
97
97
|
<div class="deployment-info">
|
|
98
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
98
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
99
99
|
</div>
|
|
100
100
|
|
|
101
101
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.111Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.111Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.114Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.114Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.118Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.118Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.126Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.126Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.130Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.130Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.137Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.137Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.141Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.141Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html"
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
|
|
102
102
|
<div class="header-actions">
|
|
103
103
|
<div class="deployment-info">
|
|
104
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
104
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
105
105
|
</div>
|
|
106
106
|
|
|
107
107
|
|
package/html/index.html
CHANGED
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.098Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.098Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/README.html"
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
<div class="header-actions">
|
|
97
97
|
<div class="deployment-info">
|
|
98
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
98
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
99
99
|
</div>
|
|
100
100
|
|
|
101
101
|
|
package/html/sitemap.xml
CHANGED
|
@@ -2,91 +2,91 @@
|
|
|
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-22T08:
|
|
5
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
11
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
17
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
23
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
29
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
35
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
41
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
47
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-22T08:
|
|
53
|
+
<lastmod>2025-07-22T08:32:13.156Z</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/seo-guide.html</loc>
|
|
59
|
-
<lastmod>2025-07-22T08:
|
|
59
|
+
<lastmod>2025-07-22T08:32:13.156Z</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-optimization-guide.html</loc>
|
|
65
|
-
<lastmod>2025-07-22T08:
|
|
65
|
+
<lastmod>2025-07-22T08:32:13.156Z</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/troubleshooting-guide.html</loc>
|
|
71
|
-
<lastmod>2025-07-22T08:
|
|
71
|
+
<lastmod>2025-07-22T08:32:13.156Z</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/index.html</loc>
|
|
77
|
-
<lastmod>2025-07-22T08:
|
|
77
|
+
<lastmod>2025-07-22T08:32:13.156Z</lastmod>
|
|
78
78
|
<changefreq>weekly</changefreq>
|
|
79
79
|
<priority>1.0</priority>
|
|
80
80
|
</url>
|
|
81
81
|
<url>
|
|
82
82
|
<loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
|
|
83
|
-
<lastmod>2025-07-22T08:
|
|
83
|
+
<lastmod>2025-07-22T08:32:13.156Z</lastmod>
|
|
84
84
|
<changefreq>monthly</changefreq>
|
|
85
85
|
<priority>0.8</priority>
|
|
86
86
|
</url>
|
|
87
87
|
<url>
|
|
88
88
|
<loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
|
|
89
|
-
<lastmod>2025-07-22T08:
|
|
89
|
+
<lastmod>2025-07-22T08:32:13.156Z</lastmod>
|
|
90
90
|
<changefreq>monthly</changefreq>
|
|
91
91
|
<priority>0.8</priority>
|
|
92
92
|
</url>
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.144Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.144Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
<div class="header-actions">
|
|
97
97
|
<div class="deployment-info">
|
|
98
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
98
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
99
99
|
</div>
|
|
100
100
|
|
|
101
101
|
|
|
@@ -61,8 +61,8 @@
|
|
|
61
61
|
"name": "Knowcode Ltd",
|
|
62
62
|
"url": "https://knowcode.tech"
|
|
63
63
|
},
|
|
64
|
-
"datePublished": "2025-07-22T08:
|
|
65
|
-
"dateModified": "2025-07-22T08:
|
|
64
|
+
"datePublished": "2025-07-22T08:32:13.147Z",
|
|
65
|
+
"dateModified": "2025-07-22T08:32:13.147Z",
|
|
66
66
|
"mainEntityOfPage": {
|
|
67
67
|
"@type": "WebPage",
|
|
68
68
|
"@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
|
|
@@ -95,7 +95,7 @@
|
|
|
95
95
|
|
|
96
96
|
<div class="header-actions">
|
|
97
97
|
<div class="deployment-info">
|
|
98
|
-
<span class="deployment-date" title="Built with doc-builder v1.5.
|
|
98
|
+
<span class="deployment-date" title="Built with doc-builder v1.5.9">Last updated: Jul 22, 2025, 08:32 AM UTC</span>
|
|
99
99
|
</div>
|
|
100
100
|
|
|
101
101
|
|
package/lib/config.js
CHANGED
|
@@ -251,11 +251,15 @@ async function loadConfig(configPath, options = {}) {
|
|
|
251
251
|
}
|
|
252
252
|
}
|
|
253
253
|
|
|
254
|
-
// Validate paths - but be lenient for
|
|
254
|
+
// Validate paths - but be lenient for commands that will create directories
|
|
255
255
|
const docsPath = path.join(process.cwd(), config.docsDir);
|
|
256
256
|
if (!fs.existsSync(docsPath)) {
|
|
257
|
-
|
|
258
|
-
|
|
257
|
+
// Only show warning for commands that don't auto-create the directory
|
|
258
|
+
// The build command will create it automatically
|
|
259
|
+
if (!options || !['build', 'dev', 'deploy'].includes(options.command)) {
|
|
260
|
+
console.warn(chalk.yellow(`Warning: Documentation directory not found: ${config.docsDir}`));
|
|
261
|
+
console.log(chalk.gray(`Create it with: mkdir ${config.docsDir} && echo "# Documentation" > ${config.docsDir}/README.md`));
|
|
262
|
+
}
|
|
259
263
|
// Don't throw error - let commands handle missing directories appropriately
|
|
260
264
|
}
|
|
261
265
|
|
package/lib/core-builder.js
CHANGED
|
@@ -672,6 +672,9 @@ async function buildDocumentation(config) {
|
|
|
672
672
|
const packageJson = require('../package.json');
|
|
673
673
|
console.log(chalk.blue(`📦 Using @knowcode/doc-builder v${packageJson.version}`));
|
|
674
674
|
|
|
675
|
+
// Ensure output directory exists
|
|
676
|
+
await fs.ensureDir(outputDir);
|
|
677
|
+
|
|
675
678
|
// Check and create placeholder README.md if missing
|
|
676
679
|
console.log(chalk.blue('📋 Checking documentation structure...'));
|
|
677
680
|
const readmeGenerated = await createPlaceholderReadme(docsDir, config);
|
|
@@ -867,6 +870,17 @@ async function buildDocumentation(config) {
|
|
|
867
870
|
|
|
868
871
|
// Create placeholder README.md if missing
|
|
869
872
|
async function createPlaceholderReadme(docsDir, config) {
|
|
873
|
+
// Create docs directory if it doesn't exist
|
|
874
|
+
if (!fs.existsSync(docsDir)) {
|
|
875
|
+
try {
|
|
876
|
+
await fs.ensureDir(docsDir);
|
|
877
|
+
console.log(chalk.yellow(`📁 Created missing docs directory: ${docsDir}`));
|
|
878
|
+
} catch (error) {
|
|
879
|
+
console.error(chalk.red(`Error creating docs directory: ${error.message}`));
|
|
880
|
+
throw error;
|
|
881
|
+
}
|
|
882
|
+
}
|
|
883
|
+
|
|
870
884
|
const readmePath = path.join(docsDir, 'README.md');
|
|
871
885
|
const indexPath = path.join(docsDir, 'index.md');
|
|
872
886
|
|