@@ -4,51 +4,25 @@ SHELL = bash
4
4
PUBLISHTAG = $(shell node scripts/publish-tag.js)
5
5
BRANCH = $(shell git rev-parse --abbrev-ref HEAD)
6
6
7
- markdowns = $(shell find doc -name '* .md' | grep -v 'index') README.md
7
+ markdowns = $(shell find docs -name '* .md' | grep -v 'index') README.md
8
8
9
- html_docdeps = html/dochead.html \
10
- html/docfoot.html \
11
- scripts/doc-build.sh \
12
- package.json
13
-
14
- cli_mandocs = $(shell find doc/cli -name '* .md' \
9
+ cli_mandocs = $(shell find docs/content/cli-commands -name '* .md' \
15
10
|sed 's|.md|.1|g' \
16
- |sed 's|doc/ cli/|man/man1/|g' ) \
11
+ |sed 's|docs/content/ cli-commands /|man/man1/|g' ) \
17
12
man/man1/npm-README.1 \
18
13
man/man1/npx.1
19
14
20
- files_mandocs = $(shell find doc/files -name '* .md' \
15
+ files_mandocs = $(shell find docs/content/configuring-npm -name '* .md' \
21
16
|sed 's|.md|.5|g' \
22
- |sed 's|doc/files/|man/man5/|g' ) \
23
- man/man5/npm-json.5 \
24
- man/man5/npm-global.5
17
+ |sed 's|docs/content/configuring-npm/|man/man5/|g' ) \
25
18
26
- misc_mandocs = $(shell find doc/misc -name '* .md' \
19
+ misc_mandocs = $(shell find docs/content/using-npm -name '* .md' \
27
20
|sed 's|.md|.7|g' \
28
- |sed 's|doc/misc/|man/man7/|g' ) \
29
- man/man7/npm-index.7
30
-
31
- cli_htmldocs = $(shell find doc/cli -name '* .md' \
32
- |sed 's|.md|.html|g' \
33
- |sed 's|doc/cli/|html/doc/cli/|g' ) \
34
- html/doc/README.html
35
-
36
- files_htmldocs = $(shell find doc/files -name '* .md' \
37
- |sed 's|.md|.html|g' \
38
- |sed 's|doc/files/|html/doc/files/|g' ) \
39
- html/doc/files/npm-json.html \
40
- html/doc/files/npm-global.html
41
-
42
- misc_htmldocs = $(shell find doc/misc -name '* .md' \
43
- |sed 's|.md|.html|g' \
44
- |sed 's|doc/misc/|html/doc/misc/|g' ) \
45
- html/doc/index.html
21
+ |sed 's|docs/content/using-npm/|man/man7/|g' ) \
46
22
47
23
mandocs = $(cli_mandocs ) $(files_mandocs ) $(misc_mandocs )
48
24
49
- htmldocs = $(cli_htmldocs ) $(files_htmldocs ) $(misc_htmldocs )
50
-
51
- all : doc
25
+ all : docs
52
26
53
27
latest :
54
28
@echo " Installing latest published npm"
@@ -65,88 +39,67 @@ dev: install
65
39
link : uninstall
66
40
node bin/npm-cli.js link -f
67
41
68
- clean : markedclean marked-manclean doc -clean
42
+ clean : markedclean marked-manclean docs -clean
69
43
rm -rf npmrc
70
44
node bin/npm-cli.js cache clean --force
71
45
72
46
uninstall :
73
47
node bin/npm-cli.js rm npm -g -f
74
48
75
- doc : $(mandocs ) $(htmldocs )
49
+ mandocs : $(mandocs )
50
+
51
+ htmldocs :
52
+ cd docs && node ../bin/npm-cli.js install && \
53
+ node ../bin/npm-cli.js run build:static echo>&2 && \
54
+ rm -rf node_modules .cache public/* js public/* json public/404* public/page-data public/manifest*
55
+
56
+ docs : mandocs htmldocs
76
57
77
58
markedclean :
78
59
rm -rf node_modules/marked node_modules/.bin/marked .building_marked
79
60
80
61
marked-manclean :
81
62
rm -rf node_modules/marked-man node_modules/.bin/marked-man .building_marked-man
82
63
83
- docclean : doc -clean
84
- doc -clean :
64
+ docsclean : docs -clean
65
+ docs -clean :
85
66
rm -rf \
86
67
.building_marked \
87
68
.building_marked-man \
88
- html/doc \
89
- man
69
+ man \
70
+ docs/node_modules \
71
+ docs/public \
72
+ docs/.cache
90
73
91
74
# # build-time tools for the documentation
92
75
build-doc-tools := node_modules/.bin/marked \
93
76
node_modules/.bin/marked-man
94
77
95
78
# use `npm install marked-man` for this to work.
96
- man/man1/npm-README.1 : README.md scripts/doc -build.sh package.json $(build-doc-tools )
79
+ man/man1/npm-README.1 : README.md scripts/docs -build.js package.json $(build-doc-tools )
97
80
@[ -d man/man1 ] || mkdir -p man/man1
98
- scripts/doc -build.sh $< $@
81
+ node scripts/docs -build.js $< $@
99
82
100
- man/man1/% .1 : doc/ cli/% .md scripts/doc -build.sh package.json $(build-doc-tools )
83
+ man/man1/% .1 : docs/content/ cli-commands /% .md scripts/docs -build.js package.json $(build-doc-tools )
101
84
@[ -d man/man1 ] || mkdir -p man/man1
102
- scripts/doc -build.sh $< $@
85
+ node scripts/docs -build.js $< $@
103
86
104
87
man/man1/npx.1 : node_modules/libnpx/libnpx.1
105
88
cat $< | sed s/libnpx/npx/ > $@
106
89
107
90
man/man5/npm-json.5 : man/man5/package.json.5
108
91
cp $< $@
109
92
110
- man/man5/npm-global.5 : man/man5/npm- folders.5
93
+ man/man5/npm-global.5 : man/man5/folders.5
111
94
cp $< $@
112
95
113
- man/man5/% .5 : doc/files/ % .md scripts/doc -build.sh package.json $(build-doc-tools )
96
+ man/man5/% .5 : docs/content/configuring-npm/ % .md scripts/docs -build.js package.json $(build-doc-tools )
114
97
@[ -d man/man5 ] || mkdir -p man/man5
115
- scripts/doc-build.sh $< $@
116
-
117
- doc/misc/npm-index.md : scripts/index-build.js package.json $(build-doc-tools )
118
- node scripts/index-build.js > $@
98
+ node scripts/docs-build.js $< $@
119
99
120
- html/doc/index.html : doc/misc/npm-index.md $(html_docdeps ) $(build-doc-tools )
121
- @[ -d html/doc ] || mkdir -p html/doc
122
- scripts/doc-build.sh $< $@
123
-
124
- man/man7/% .7 : doc/misc/% .md scripts/doc-build.sh package.json $(build-doc-tools )
100
+ man/man7/% .7 : docs/content/using-npm/% .md scripts/docs-build.js package.json $(build-doc-tools )
125
101
@[ -d man/man7 ] || mkdir -p man/man7
126
- scripts/doc-build.sh $< $@
127
-
128
- html/doc/README.html : README.md $(html_docdeps ) $(build-doc-tools )
129
- @[ -d html/doc ] || mkdir -p html/doc
130
- scripts/doc-build.sh $< $@
131
-
132
- html/doc/cli/% .html : doc/cli/% .md $(html_docdeps ) $(build-doc-tools )
133
- @[ -d html/doc/cli ] || mkdir -p html/doc/cli
134
- scripts/doc-build.sh $< $@
135
-
136
- html/doc/files/npm-json.html : html/doc/files/package.json.html
137
- cp $< $@
138
-
139
- html/doc/files/npm-global.html : html/doc/files/npm-folders.html
140
- cp $< $@
141
-
142
- html/doc/files/% .html : doc/files/% .md $(html_docdeps ) $(build-doc-tools )
143
- @[ -d html/doc/files ] || mkdir -p html/doc/files
144
- scripts/doc-build.sh $< $@
145
-
146
- html/doc/misc/% .html : doc/misc/% .md $(html_docdeps ) $(build-doc-tools )
147
- @[ -d html/doc/misc ] || mkdir -p html/doc/misc
148
- scripts/doc-build.sh $< $@
149
-
102
+ node scripts/docs-build.js $< $@
150
103
151
104
marked : node_modules/.bin/marked
152
105
@@ -158,11 +111,7 @@ marked-man: node_modules/.bin/marked-man
158
111
node_modules/.bin/marked-man :
159
112
node bin/npm-cli.js install marked-man --no-global --no-timing --no-save
160
113
161
- doc : man
162
-
163
- man : $(cli_docs )
164
-
165
- test : doc
114
+ test : docs
166
115
node bin/npm-cli.js test
167
116
168
117
tag :
@@ -174,17 +123,17 @@ ls-ok:
174
123
gitclean :
175
124
git clean -fd
176
125
177
- publish : gitclean ls-ok link doc -clean doc
126
+ publish : gitclean ls-ok link docs -clean docs
178
127
@git push origin :v$(shell node bin/npm-cli.js --no-timing -v) 2>&1 || true
179
128
git push origin $(BRANCH ) && \
180
129
git push origin --tags && \
181
130
node bin/npm-cli.js publish --tag=$(PUBLISHTAG )
182
131
183
- release : gitclean ls-ok markedclean marked-manclean doc -clean doc
132
+ release : gitclean ls-ok markedclean marked-manclean docs -clean doc
184
133
node bin/npm-cli.js prune --production --no-save
185
134
@bash scripts/release.sh
186
135
187
136
sandwich :
188
137
@[ $$ (whoami) = " root" ] && (echo " ok" ; echo " ham" > sandwich) || (echo " make it yourself" && exit 13)
189
138
190
- .PHONY : all latest install dev link doc clean uninstall test man doc -clean docclean release ls-ok realclean
139
+ .PHONY : all latest install dev link doc clean uninstall test man docs -clean docclean release ls-ok realclean
0 commit comments