ssqch 0.12.0 → 0.13.1
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/bundled/completions/bash +66 -8
- package/bundled/completions/elvish +23 -4
- package/bundled/completions/fish +36 -25
- package/bundled/completions/powershell +25 -4
- package/bundled/completions/zsh +44 -10
- package/bundled/docs/agents.md +2 -2
- package/bundled/docs/build-summary.md +1 -1
- package/bundled/docs/comparing-builds.md +2 -2
- package/bundled/docs/configuring.md +3 -6
- package/bundled/docs/deploying.md +1 -1
- package/bundled/docs/field-guide.md +4 -4
- package/bundled/docs/github-pages.md +1 -0
- package/bundled/docs/index.md +1 -1
- package/bundled/docs/install.md +1 -1
- package/bundled/docs/known-gaps.md +1 -1
- package/bundled/docs/markdown.md +8 -12
- package/bundled/docs/nav.yml +5 -1
- package/bundled/docs/netlify.md +4 -2
- package/bundled/docs/patrol.md +48 -0
- package/bundled/docs/plugins.md +6 -6
- package/bundled/docs/robots.md +85 -0
- package/bundled/docs/seo.md +2 -38
- package/bundled/docs/serving-markdown.md +142 -0
- package/bundled/docs/template-languages.md +1 -1
- package/bundled/docs/templates.md +1 -1
- package/bundled/docs/trailheads/from-hugo.md +5 -3
- package/bundled/docs/trailheads/from-jekyll.md +54 -13
- package/bundled/docs/trailheads/from-mkdocs.md +15 -12
- package/bundled/docs/trailheads/from-vitepress.md +13 -11
- package/bundled/docs/trailheads.md +3 -3
- package/bundled/docs/where-values-come-from.md +5 -5
- package/bundled/docs/writing-plugins.md +69 -0
- package/bundled/ssqch.d.ts +118 -44
- package/bundled/starter/engines/index.edge +1 -0
- package/bundled/starter/engines/index.ejs +1 -0
- package/bundled/starter/engines/index.hbs +1 -0
- package/bundled/starter/engines/index.liquid +1 -0
- package/bundled/starter/engines/layout.edge +7 -0
- package/bundled/starter/engines/layout.ejs +4 -0
- package/bundled/starter/engines/layout.hbs +4 -0
- package/bundled/starter/engines/layout.liquid +4 -0
- package/bundled/starter/src/_data/site.json +1 -0
- package/bundled/starter/src/_includes/layout.jinja +4 -0
- package/bundled/starter/src/index.jinja +1 -0
- package/bundled/starter/ssqch.config.js +14 -1
- package/bundled/starter-docs/engines/edge/base.edge +7 -0
- package/bundled/starter-docs/engines/edge/doc.edge +4 -0
- package/bundled/starter-docs/engines/ejs/base.ejs +4 -0
- package/bundled/starter-docs/engines/ejs/doc.ejs +4 -0
- package/bundled/starter-docs/engines/hbs/base.hbs +4 -0
- package/bundled/starter-docs/engines/hbs/doc.hbs +3 -0
- package/bundled/starter-docs/engines/liquid/base.liquid +4 -0
- package/bundled/starter-docs/engines/liquid/doc.liquid +4 -0
- package/bundled/starter-docs/src/_data/site.json +1 -0
- package/bundled/starter-docs/src/_includes/base.jinja +4 -0
- package/bundled/starter-docs/src/_includes/doc.jinja +4 -0
- package/bundled/starter-docs/src/assets/docs.css +4 -0
- package/bundled/starter-docs/src/assets/docs.js +17 -0
- package/bundled/starter-docs/ssqch.config.js +14 -1
- package/lib/assets.js +9 -9
- package/lib/chunk-25WERNDD.js +112 -0
- package/lib/{chunk-4ZMNLWE4.js → chunk-2BJFGKOE.js} +2 -2
- package/lib/{chunk-M2BBE2C3.js → chunk-3ZTRIO6O.js} +18 -17
- package/lib/{chunk-57HLSKZS.js → chunk-4AZFCSGJ.js} +2 -2
- package/lib/{chunk-ULQHJ4TS.js → chunk-55WXDGO4.js} +3 -3
- package/lib/{chunk-JX43SJHU.js → chunk-6FY77I4M.js} +24 -22
- package/lib/{chunk-RY3KLUQ3.js → chunk-6OUCRDYI.js} +267 -202
- package/lib/{chunk-EVFNYUTR.js → chunk-6U5VIQVY.js} +5 -5
- package/lib/{chunk-N3IZ44XY.js → chunk-7U5GWTEH.js} +88 -54
- package/lib/{chunk-VTYQ3JKL.js → chunk-AIJNG6MJ.js} +2 -2
- package/lib/{chunk-IIBZPHAW.js → chunk-C2Q7JKFI.js} +8 -8
- package/lib/{chunk-6CSH757V.js → chunk-DFJFHULZ.js} +33 -8
- package/lib/{chunk-XVV7JJK7.js → chunk-ENWDM2RW.js} +40 -39
- package/lib/{chunk-JUALMFW3.js → chunk-ER72RPD6.js} +1 -1
- package/lib/{chunk-RFREB3SI.js → chunk-F3JPNFCZ.js} +7 -7
- package/lib/{chunk-LLOA3QXV.js → chunk-FENJHLNM.js} +3 -2
- package/lib/{chunk-UU43WIZG.js → chunk-FJML7INB.js} +4 -2
- package/lib/{chunk-IZCF4UH3.js → chunk-FQZDUDFK.js} +1 -1
- package/lib/chunk-GM5SHCTU.js +272 -0
- package/lib/{chunk-GVHQ37JE.js → chunk-GSNRAGKQ.js} +10 -5
- package/lib/{chunk-L2IY4P6O.js → chunk-GU7BBYWB.js} +3 -3
- package/lib/{chunk-RGYJQYW3.js → chunk-HDKU6LRI.js} +32 -5
- package/lib/{chunk-IQUGLVZY.js → chunk-K5WZ2VYK.js} +4 -4
- package/lib/{chunk-JVT5ZRRH.js → chunk-OOKBXQAY.js} +5 -5
- package/lib/{chunk-MOLTDO5A.js → chunk-SNQOHNXE.js} +1 -1
- package/lib/{chunk-Z3XH4KWX.js → chunk-SPIFZBIW.js} +1 -1
- package/lib/{chunk-FNNXRVSU.js → chunk-T5IUI7W7.js} +10 -10
- package/lib/{chunk-5HEZ3WUQ.js → chunk-TGSVSG2G.js} +2 -2
- package/lib/{chunk-3GROJ3TY.js → chunk-U2KEMVXO.js} +24 -17
- package/lib/{chunk-4B3N44SN.js → chunk-UHRBPZ4A.js} +3 -3
- package/lib/{chunk-GWWA5Y3X.js → chunk-ULCT3PAV.js} +1 -1
- package/lib/{chunk-7RGEWDLF.js → chunk-UZNUS7RP.js} +10 -8
- package/lib/{chunk-DZ5F5XSI.js → chunk-V3G2QGL3.js} +10 -105
- package/lib/{chunk-DOHOKUGB.js → chunk-VILOEVK7.js} +50 -26
- package/lib/{chunk-DXMDXHV7.js → chunk-WGAIE3DD.js} +15 -14
- package/lib/{chunk-G3RFQDKO.js → chunk-WUCRAV36.js} +8 -6
- package/lib/{chunk-52ROOMBZ.js → chunk-XYAWJTHM.js} +9 -9
- package/lib/{chunk-L3K7MMFC.js → chunk-YA23NDMW.js} +2 -2
- package/lib/{chunk-R7PBREXL.js → chunk-YNJNMQWU.js} +8 -5
- package/lib/{chunk-AK7ZKSZP.js → chunk-ZMG25MXF.js} +17 -16
- package/lib/cli.js +56 -34
- package/lib/elements.js +9 -9
- package/lib/from-hugo.js +36 -0
- package/lib/from-jekyll.js +41 -0
- package/lib/from-mkdocs.js +49 -0
- package/lib/from-vitepress.js +49 -0
- package/lib/image.js +10 -10
- package/lib/links.js +9 -9
- package/lib/llms.js +619 -54
- package/lib/minify.js +10 -10
- package/lib/redirects.js +9 -9
- package/lib/robots.js +87 -0
- package/lib/rss.js +22 -12
- package/lib/sass.js +10 -10
- package/lib/sitemap.js +22 -33
- package/lib/ssqch.js +5 -5
- package/lib/vue.js +14 -13
- package/package.json +21 -1
- package/types/from-hugo.d.ts +5 -0
- package/types/from-jekyll.d.ts +11 -0
- package/types/from-mkdocs.d.ts +11 -0
- package/types/from-vitepress.d.ts +5 -0
- package/types/index.d.ts +45 -29
- package/types/llms.d.ts +18 -8
- package/types/robots.d.ts +13 -0
- package/types/sass.d.ts +1 -1
- package/types/sitemap.d.ts +3 -5
- package/wasm/markdown.wasm +0 -0
- /package/lib/{chunk-JX43SJHU.js.LEGAL.txt → chunk-6FY77I4M.js.LEGAL.txt} +0 -0
- /package/lib/{chunk-R7PBREXL.js.LEGAL.txt → chunk-YNJNMQWU.js.LEGAL.txt} +0 -0
package/bundled/completions/bash
CHANGED
|
@@ -34,6 +34,9 @@ _ssqch() {
|
|
|
34
34
|
ssqch,footprint)
|
|
35
35
|
cmd="ssqch__subcmd__footprint"
|
|
36
36
|
;;
|
|
37
|
+
ssqch,patrol)
|
|
38
|
+
cmd="ssqch__subcmd__patrol"
|
|
39
|
+
;;
|
|
37
40
|
ssqch,help)
|
|
38
41
|
cmd="ssqch__subcmd__help"
|
|
39
42
|
;;
|
|
@@ -46,8 +49,8 @@ _ssqch() {
|
|
|
46
49
|
ssqch,init)
|
|
47
50
|
cmd="ssqch__subcmd__init"
|
|
48
51
|
;;
|
|
49
|
-
ssqch,
|
|
50
|
-
cmd="
|
|
52
|
+
ssqch,trace)
|
|
53
|
+
cmd="ssqch__subcmd__trace"
|
|
51
54
|
;;
|
|
52
55
|
ssqch,new)
|
|
53
56
|
cmd="ssqch__subcmd__new"
|
|
@@ -76,6 +79,9 @@ _ssqch() {
|
|
|
76
79
|
ssqch__subcmd__help,footprint)
|
|
77
80
|
cmd="ssqch__subcmd__help__subcmd__footprint"
|
|
78
81
|
;;
|
|
82
|
+
ssqch__subcmd__help,patrol)
|
|
83
|
+
cmd="ssqch__subcmd__help__subcmd__patrol"
|
|
84
|
+
;;
|
|
79
85
|
ssqch__subcmd__help,help)
|
|
80
86
|
cmd="ssqch__subcmd__help__subcmd__help"
|
|
81
87
|
;;
|
|
@@ -88,8 +94,8 @@ _ssqch() {
|
|
|
88
94
|
ssqch__subcmd__help,init)
|
|
89
95
|
cmd="ssqch__subcmd__help__subcmd__init"
|
|
90
96
|
;;
|
|
91
|
-
ssqch__subcmd__help,
|
|
92
|
-
cmd="
|
|
97
|
+
ssqch__subcmd__help,trace)
|
|
98
|
+
cmd="ssqch__subcmd__help__subcmd__trace"
|
|
93
99
|
;;
|
|
94
100
|
ssqch__subcmd__help,new)
|
|
95
101
|
cmd="ssqch__subcmd__help__subcmd__new"
|
|
@@ -107,7 +113,7 @@ _ssqch() {
|
|
|
107
113
|
|
|
108
114
|
case "${cmd}" in
|
|
109
115
|
ssqch)
|
|
110
|
-
opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new
|
|
116
|
+
opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help"
|
|
111
117
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then
|
|
112
118
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
113
119
|
return 0
|
|
@@ -388,8 +394,46 @@ _ssqch() {
|
|
|
388
394
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
389
395
|
return 0
|
|
390
396
|
;;
|
|
397
|
+
ssqch__subcmd__patrol)
|
|
398
|
+
opts="-o -q -v -h --format --root --output --base --offline --env --quiet --verbose --help"
|
|
399
|
+
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
400
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
401
|
+
return 0
|
|
402
|
+
fi
|
|
403
|
+
case "${prev}" in
|
|
404
|
+
--format)
|
|
405
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
406
|
+
return 0
|
|
407
|
+
;;
|
|
408
|
+
--root)
|
|
409
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
410
|
+
return 0
|
|
411
|
+
;;
|
|
412
|
+
--output)
|
|
413
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
414
|
+
return 0
|
|
415
|
+
;;
|
|
416
|
+
-o)
|
|
417
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
418
|
+
return 0
|
|
419
|
+
;;
|
|
420
|
+
--base)
|
|
421
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
422
|
+
return 0
|
|
423
|
+
;;
|
|
424
|
+
--env)
|
|
425
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
426
|
+
return 0
|
|
427
|
+
;;
|
|
428
|
+
*)
|
|
429
|
+
COMPREPLY=()
|
|
430
|
+
;;
|
|
431
|
+
esac
|
|
432
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
433
|
+
return 0
|
|
434
|
+
;;
|
|
391
435
|
ssqch__subcmd__help)
|
|
392
|
-
opts="build serve new
|
|
436
|
+
opts="build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help"
|
|
393
437
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
394
438
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
395
439
|
return 0
|
|
@@ -486,6 +530,20 @@ _ssqch() {
|
|
|
486
530
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
487
531
|
return 0
|
|
488
532
|
;;
|
|
533
|
+
ssqch__subcmd__help__subcmd__patrol)
|
|
534
|
+
opts=""
|
|
535
|
+
if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
|
|
536
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
537
|
+
return 0
|
|
538
|
+
fi
|
|
539
|
+
case "${prev}" in
|
|
540
|
+
*)
|
|
541
|
+
COMPREPLY=()
|
|
542
|
+
;;
|
|
543
|
+
esac
|
|
544
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
545
|
+
return 0
|
|
546
|
+
;;
|
|
489
547
|
ssqch__subcmd__help__subcmd__help)
|
|
490
548
|
opts=""
|
|
491
549
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
|
|
@@ -542,7 +600,7 @@ _ssqch() {
|
|
|
542
600
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
543
601
|
return 0
|
|
544
602
|
;;
|
|
545
|
-
|
|
603
|
+
ssqch__subcmd__help__subcmd__trace)
|
|
546
604
|
opts=""
|
|
547
605
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
|
|
548
606
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
@@ -696,7 +754,7 @@ _ssqch() {
|
|
|
696
754
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
697
755
|
return 0
|
|
698
756
|
;;
|
|
699
|
-
|
|
757
|
+
ssqch__subcmd__trace)
|
|
700
758
|
opts="-o -q -v -h --field --format --root --output --base --offline --env --quiet --verbose --help"
|
|
701
759
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
702
760
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
@@ -35,10 +35,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
35
35
|
cand build 'Build the site (default)'
|
|
36
36
|
cand serve 'Build, serve, watch for changes and live-reload the browser'
|
|
37
37
|
cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
|
|
38
|
-
cand
|
|
38
|
+
cand trace 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value'
|
|
39
39
|
cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
40
40
|
cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
|
|
41
41
|
cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
42
|
+
cand patrol 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
|
|
42
43
|
cand init 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
43
44
|
cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
44
45
|
cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
|
|
@@ -100,7 +101,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
100
101
|
cand -h 'Print help'
|
|
101
102
|
cand --help 'Print help'
|
|
102
103
|
}
|
|
103
|
-
&'ssqch;
|
|
104
|
+
&'ssqch;trace'= {
|
|
104
105
|
cand --field 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)'
|
|
105
106
|
cand --format 'text or json'
|
|
106
107
|
cand --root 'Project root (defaults to the current directory)'
|
|
@@ -168,6 +169,21 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
168
169
|
cand -h 'Print help'
|
|
169
170
|
cand --help 'Print help'
|
|
170
171
|
}
|
|
172
|
+
&'ssqch;patrol'= {
|
|
173
|
+
cand --format 'text or json'
|
|
174
|
+
cand --root 'Project root (defaults to the current directory)'
|
|
175
|
+
cand -o 'Override the output directory (relative to the root)'
|
|
176
|
+
cand --output 'Override the output directory (relative to the root)'
|
|
177
|
+
cand --base 'Serve the site under a path, like /repo/ (overrides the config''s `base`)'
|
|
178
|
+
cand --env 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)'
|
|
179
|
+
cand --offline 'Don''t use the network: `fetch()` answers from the copies its `cache` option saved'
|
|
180
|
+
cand -q 'Print only warnings and errors'
|
|
181
|
+
cand --quiet 'Print only warnings and errors'
|
|
182
|
+
cand -v 'Also list the slowest images to encode'
|
|
183
|
+
cand --verbose 'Also list the slowest images to encode'
|
|
184
|
+
cand -h 'Print help'
|
|
185
|
+
cand --help 'Print help'
|
|
186
|
+
}
|
|
171
187
|
&'ssqch;init'= {
|
|
172
188
|
cand --starter 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)'
|
|
173
189
|
cand --engine 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs'
|
|
@@ -258,10 +274,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
258
274
|
cand build 'Build the site (default)'
|
|
259
275
|
cand serve 'Build, serve, watch for changes and live-reload the browser'
|
|
260
276
|
cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
|
|
261
|
-
cand
|
|
277
|
+
cand trace 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value'
|
|
262
278
|
cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
263
279
|
cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
|
|
264
280
|
cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
281
|
+
cand patrol 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
|
|
265
282
|
cand init 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
266
283
|
cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
267
284
|
cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
|
|
@@ -276,7 +293,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
276
293
|
}
|
|
277
294
|
&'ssqch;help;new'= {
|
|
278
295
|
}
|
|
279
|
-
&'ssqch;help;
|
|
296
|
+
&'ssqch;help;trace'= {
|
|
280
297
|
}
|
|
281
298
|
&'ssqch;help;completions'= {
|
|
282
299
|
}
|
|
@@ -284,6 +301,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
284
301
|
}
|
|
285
302
|
&'ssqch;help;footprint'= {
|
|
286
303
|
}
|
|
304
|
+
&'ssqch;help;patrol'= {
|
|
305
|
+
}
|
|
287
306
|
&'ssqch;help;init'= {
|
|
288
307
|
}
|
|
289
308
|
&'ssqch;help;types'= {
|
package/bundled/completions/fish
CHANGED
|
@@ -36,10 +36,11 @@ complete -c ssqch -n "__fish_ssqch_needs_command" -s V -l version -d 'Print vers
|
|
|
36
36
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "build" -d 'Build the site (default)'
|
|
37
37
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
|
|
38
38
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
|
|
39
|
-
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "
|
|
39
|
+
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "trace" -d 'Follow a page\'s tracks: where it comes from, and which level of the data cascade set each value'
|
|
40
40
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
41
41
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
|
|
42
42
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
43
|
+
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "patrol" -d 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
|
|
43
44
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
44
45
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
45
46
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
|
|
@@ -81,16 +82,16 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand new" -l offline -d 'Don\'t u
|
|
|
81
82
|
complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s q -l quiet -d 'Print only warnings and errors'
|
|
82
83
|
complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
83
84
|
complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s h -l help -d 'Print help'
|
|
84
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
85
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
86
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
87
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
88
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
89
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
90
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
91
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
92
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
93
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
85
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l field -d 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)' -r
|
|
86
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l format -d 'text or json' -r
|
|
87
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
88
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
|
|
89
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
|
|
90
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
|
|
91
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
|
|
92
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s q -l quiet -d 'Print only warnings and errors'
|
|
93
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
94
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s h -l help -d 'Print help'
|
|
94
95
|
complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
95
96
|
complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
|
|
96
97
|
complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
|
|
@@ -117,14 +118,23 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s v -l verbose -d 'Al
|
|
|
117
118
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s h -l help -d 'Print help'
|
|
118
119
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l top -d 'How many of the heaviest pages and files to list (0 for none)' -r
|
|
119
120
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l format -d 'text or json' -r
|
|
121
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l format -d 'text or json' -r
|
|
120
122
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
123
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
121
124
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
|
|
125
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
|
|
122
126
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
|
|
127
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
|
|
123
128
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
|
|
129
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
|
|
124
130
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
|
|
131
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
|
|
125
132
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s q -l quiet -d 'Print only warnings and errors'
|
|
133
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s q -l quiet -d 'Print only warnings and errors'
|
|
126
134
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
135
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
127
136
|
complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s h -l help -d 'Print help'
|
|
137
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s h -l help -d 'Print help'
|
|
128
138
|
complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l starter -d 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)' -r
|
|
129
139
|
complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l engine -d 'The template language for the starter\'s layouts and templates: jinja, njk, edge, liquid, hbs or ejs' -r
|
|
130
140
|
complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
@@ -180,17 +190,18 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -l offline -d 'Don\'t
|
|
|
180
190
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s q -l quiet -d 'Print only warnings and errors'
|
|
181
191
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
182
192
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s h -l help -d 'Print help'
|
|
183
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
184
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
185
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
186
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
187
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
188
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
189
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
190
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
191
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
192
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
193
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
194
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
195
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
196
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
193
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "build" -d 'Build the site (default)'
|
|
194
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
|
|
195
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
|
|
196
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "trace" -d 'Follow a page\'s tracks: where it comes from, and which level of the data cascade set each value'
|
|
197
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
198
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
|
|
199
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
200
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "patrol" -d 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
|
|
201
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
202
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
203
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
|
|
204
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "scout" -d 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
|
|
205
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
|
|
206
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
|
|
207
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
|
|
@@ -38,10 +38,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
38
38
|
[CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
|
|
39
39
|
[CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
|
|
40
40
|
[CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
|
|
41
|
-
[CompletionResult]::new('
|
|
41
|
+
[CompletionResult]::new('trace', 'trace', [CompletionResultType]::ParameterValue, 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value')
|
|
42
42
|
[CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
|
|
43
43
|
[CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
|
|
44
44
|
[CompletionResult]::new('footprint', 'footprint', [CompletionResultType]::ParameterValue, 'Show how much a build weighs: its files by kind, and the heaviest pages and files')
|
|
45
|
+
[CompletionResult]::new('patrol', 'patrol', [CompletionResultType]::ParameterValue, 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions')
|
|
45
46
|
[CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
|
|
46
47
|
[CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
|
|
47
48
|
[CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
|
|
@@ -107,7 +108,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
107
108
|
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
108
109
|
break
|
|
109
110
|
}
|
|
110
|
-
'ssqch;
|
|
111
|
+
'ssqch;trace' {
|
|
111
112
|
[CompletionResult]::new('--field', '--field', [CompletionResultType]::ParameterName, 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)')
|
|
112
113
|
[CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
|
|
113
114
|
[CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
|
|
@@ -179,6 +180,22 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
179
180
|
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
180
181
|
break
|
|
181
182
|
}
|
|
183
|
+
'ssqch;patrol' {
|
|
184
|
+
[CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
|
|
185
|
+
[CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
|
|
186
|
+
[CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Override the output directory (relative to the root)')
|
|
187
|
+
[CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Override the output directory (relative to the root)')
|
|
188
|
+
[CompletionResult]::new('--base', '--base', [CompletionResultType]::ParameterName, 'Serve the site under a path, like /repo/ (overrides the config''s `base`)')
|
|
189
|
+
[CompletionResult]::new('--env', '--env', [CompletionResultType]::ParameterName, 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)')
|
|
190
|
+
[CompletionResult]::new('--offline', '--offline', [CompletionResultType]::ParameterName, 'Don''t use the network: `fetch()` answers from the copies its `cache` option saved')
|
|
191
|
+
[CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
|
|
192
|
+
[CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
|
|
193
|
+
[CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Also list the slowest images to encode')
|
|
194
|
+
[CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Also list the slowest images to encode')
|
|
195
|
+
[CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
|
|
196
|
+
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
197
|
+
break
|
|
198
|
+
}
|
|
182
199
|
'ssqch;init' {
|
|
183
200
|
[CompletionResult]::new('--starter', '--starter', [CompletionResultType]::ParameterName, 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)')
|
|
184
201
|
[CompletionResult]::new('--engine', '--engine', [CompletionResultType]::ParameterName, 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs')
|
|
@@ -275,10 +292,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
275
292
|
[CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
|
|
276
293
|
[CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
|
|
277
294
|
[CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
|
|
278
|
-
[CompletionResult]::new('
|
|
295
|
+
[CompletionResult]::new('trace', 'trace', [CompletionResultType]::ParameterValue, 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value')
|
|
279
296
|
[CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
|
|
280
297
|
[CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
|
|
281
298
|
[CompletionResult]::new('footprint', 'footprint', [CompletionResultType]::ParameterValue, 'Show how much a build weighs: its files by kind, and the heaviest pages and files')
|
|
299
|
+
[CompletionResult]::new('patrol', 'patrol', [CompletionResultType]::ParameterValue, 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions')
|
|
282
300
|
[CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
|
|
283
301
|
[CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
|
|
284
302
|
[CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
|
|
@@ -297,7 +315,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
297
315
|
'ssqch;help;new' {
|
|
298
316
|
break
|
|
299
317
|
}
|
|
300
|
-
'ssqch;help;
|
|
318
|
+
'ssqch;help;trace' {
|
|
301
319
|
break
|
|
302
320
|
}
|
|
303
321
|
'ssqch;help;completions' {
|
|
@@ -309,6 +327,9 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
309
327
|
'ssqch;help;footprint' {
|
|
310
328
|
break
|
|
311
329
|
}
|
|
330
|
+
'ssqch;help;patrol' {
|
|
331
|
+
break
|
|
332
|
+
}
|
|
312
333
|
'ssqch;help;init' {
|
|
313
334
|
break
|
|
314
335
|
}
|
package/bundled/completions/zsh
CHANGED
|
@@ -98,7 +98,7 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
98
98
|
':path -- The new file, from the input folder (posts/pine-cones.md), or a folder, with --title:_default' \
|
|
99
99
|
&& ret=0
|
|
100
100
|
;;
|
|
101
|
-
(
|
|
101
|
+
(trace)
|
|
102
102
|
_arguments "${_arguments_options[@]}" : \
|
|
103
103
|
'--field=[One field of its data, in full, with every level that set it (a dotted path reaches inside\: hero.alt)]:NAME:_default' \
|
|
104
104
|
'--format=[text or json]:FORMAT:_default' \
|
|
@@ -179,6 +179,24 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
179
179
|
'::dir -- The build folder (default\: the site'\''s output folder):_files' \
|
|
180
180
|
&& ret=0
|
|
181
181
|
;;
|
|
182
|
+
(patrol)
|
|
183
|
+
_arguments "${_arguments_options[@]}" : \
|
|
184
|
+
'--format=[text or json]:FORMAT:_default' \
|
|
185
|
+
'--root=[Project root (defaults to the current directory)]:ROOT:_files' \
|
|
186
|
+
'-o+[Override the output directory (relative to the root)]:OUTPUT:_files' \
|
|
187
|
+
'--output=[Override the output directory (relative to the root)]:OUTPUT:_files' \
|
|
188
|
+
'--base=[Serve the site under a path, like /repo/ (overrides the config'\''s \`base\`)]:BASE:_default' \
|
|
189
|
+
'--env=[development or production (default\: \$SSQCH_ENV, \$NODE_ENV, then production for \`build\` and development for \`serve\`)]:ENV:_default' \
|
|
190
|
+
'--offline[Don'\''t use the network\: \`fetch()\` answers from the copies its \`cache\` option saved]' \
|
|
191
|
+
'-q[Print only warnings and errors]' \
|
|
192
|
+
'--quiet[Print only warnings and errors]' \
|
|
193
|
+
'-v[Also list the slowest images to encode]' \
|
|
194
|
+
'--verbose[Also list the slowest images to encode]' \
|
|
195
|
+
'-h[Print help]' \
|
|
196
|
+
'--help[Print help]' \
|
|
197
|
+
'::dir -- The build folder (default\: the site'\''s output folder):_files' \
|
|
198
|
+
&& ret=0
|
|
199
|
+
;;
|
|
182
200
|
(init)
|
|
183
201
|
_arguments "${_arguments_options[@]}" : \
|
|
184
202
|
'--starter=[What to start with\: site (a small blog) or docs (documentation with a sidebar, tabs and search)]:NAME:_default' \
|
|
@@ -305,7 +323,7 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
305
323
|
_arguments "${_arguments_options[@]}" : \
|
|
306
324
|
&& ret=0
|
|
307
325
|
;;
|
|
308
|
-
(
|
|
326
|
+
(trace)
|
|
309
327
|
_arguments "${_arguments_options[@]}" : \
|
|
310
328
|
&& ret=0
|
|
311
329
|
;;
|
|
@@ -321,6 +339,10 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
321
339
|
_arguments "${_arguments_options[@]}" : \
|
|
322
340
|
&& ret=0
|
|
323
341
|
;;
|
|
342
|
+
(patrol)
|
|
343
|
+
_arguments "${_arguments_options[@]}" : \
|
|
344
|
+
&& ret=0
|
|
345
|
+
;;
|
|
324
346
|
(init)
|
|
325
347
|
_arguments "${_arguments_options[@]}" : \
|
|
326
348
|
&& ret=0
|
|
@@ -360,10 +382,11 @@ _ssqch_commands() {
|
|
|
360
382
|
'build:Build the site (default)' \
|
|
361
383
|
'serve:Build, serve, watch for changes and live-reload the browser' \
|
|
362
384
|
'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
|
|
363
|
-
'
|
|
385
|
+
'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
|
|
364
386
|
'completions:Print a completion script for your shell, so Tab finishes commands and options' \
|
|
365
387
|
'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
|
|
366
388
|
'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
|
|
389
|
+
'patrol:Check a build for what agents and crawlers read\: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions' \
|
|
367
390
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
368
391
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
369
392
|
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
@@ -404,16 +427,22 @@ _ssqch__subcmd__footprint_commands() {
|
|
|
404
427
|
local commands; commands=()
|
|
405
428
|
_describe -t commands 'ssqch footprint commands' commands "$@"
|
|
406
429
|
}
|
|
430
|
+
(( $+functions[_ssqch__subcmd__patrol_commands] )) ||
|
|
431
|
+
_ssqch__subcmd__patrol_commands() {
|
|
432
|
+
local commands; commands=()
|
|
433
|
+
_describe -t commands 'ssqch patrol commands' commands "$@"
|
|
434
|
+
}
|
|
407
435
|
(( $+functions[_ssqch__subcmd__help_commands] )) ||
|
|
408
436
|
_ssqch__subcmd__help_commands() {
|
|
409
437
|
local commands; commands=(
|
|
410
438
|
'build:Build the site (default)' \
|
|
411
439
|
'serve:Build, serve, watch for changes and live-reload the browser' \
|
|
412
440
|
'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
|
|
413
|
-
'
|
|
441
|
+
'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
|
|
414
442
|
'completions:Print a completion script for your shell, so Tab finishes commands and options' \
|
|
415
443
|
'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
|
|
416
444
|
'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
|
|
445
|
+
'patrol:Check a build for what agents and crawlers read\: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions' \
|
|
417
446
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
418
447
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
419
448
|
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
@@ -454,6 +483,11 @@ _ssqch__subcmd__help__subcmd__footprint_commands() {
|
|
|
454
483
|
local commands; commands=()
|
|
455
484
|
_describe -t commands 'ssqch help footprint commands' commands "$@"
|
|
456
485
|
}
|
|
486
|
+
(( $+functions[_ssqch__subcmd__help__subcmd__patrol_commands] )) ||
|
|
487
|
+
_ssqch__subcmd__help__subcmd__patrol_commands() {
|
|
488
|
+
local commands; commands=()
|
|
489
|
+
_describe -t commands 'ssqch help patrol commands' commands "$@"
|
|
490
|
+
}
|
|
457
491
|
(( $+functions[_ssqch__subcmd__help__subcmd__help_commands] )) ||
|
|
458
492
|
_ssqch__subcmd__help__subcmd__help_commands() {
|
|
459
493
|
local commands; commands=()
|
|
@@ -469,10 +503,10 @@ _ssqch__subcmd__help__subcmd__init_commands() {
|
|
|
469
503
|
local commands; commands=()
|
|
470
504
|
_describe -t commands 'ssqch help init commands' commands "$@"
|
|
471
505
|
}
|
|
472
|
-
(( $+functions[
|
|
473
|
-
|
|
506
|
+
(( $+functions[_ssqch__subcmd__help__subcmd__trace_commands] )) ||
|
|
507
|
+
_ssqch__subcmd__help__subcmd__trace_commands() {
|
|
474
508
|
local commands; commands=()
|
|
475
|
-
_describe -t commands 'ssqch help
|
|
509
|
+
_describe -t commands 'ssqch help trace commands' commands "$@"
|
|
476
510
|
}
|
|
477
511
|
(( $+functions[_ssqch__subcmd__help__subcmd__new_commands] )) ||
|
|
478
512
|
_ssqch__subcmd__help__subcmd__new_commands() {
|
|
@@ -504,10 +538,10 @@ _ssqch__subcmd__init_commands() {
|
|
|
504
538
|
local commands; commands=()
|
|
505
539
|
_describe -t commands 'ssqch init commands' commands "$@"
|
|
506
540
|
}
|
|
507
|
-
(( $+functions[
|
|
508
|
-
|
|
541
|
+
(( $+functions[_ssqch__subcmd__trace_commands] )) ||
|
|
542
|
+
_ssqch__subcmd__trace_commands() {
|
|
509
543
|
local commands; commands=()
|
|
510
|
-
_describe -t commands 'ssqch
|
|
544
|
+
_describe -t commands 'ssqch trace commands' commands "$@"
|
|
511
545
|
}
|
|
512
546
|
(( $+functions[_ssqch__subcmd__new_commands] )) ||
|
|
513
547
|
_ssqch__subcmd__new_commands() {
|
package/bundled/docs/agents.md
CHANGED
|
@@ -67,7 +67,7 @@ ssqch serve --port 0 --ready-file .cache/ready.json &
|
|
|
67
67
|
|
|
68
68
|
`ok` is whether that first build worked (the server keeps running either way, and rebuilds when a file changes). The file is deleted when the server starts, so one from an earlier run never counts, and it's written again when a changed config loads, since `output` and `base` can change with it.
|
|
69
69
|
|
|
70
|
-
The other commands with JSON are [`ssqch
|
|
70
|
+
The other commands with JSON are [`ssqch trace --format json`](where-values-come-from.md) (where a page's data came from) and [`ssqch diff --format json`](comparing-builds.md) (what a change did to the output; it exits with 0, 1 or 2 like `diff`).
|
|
71
71
|
|
|
72
72
|
## Moving a site with an agent
|
|
73
73
|
|
|
@@ -76,6 +76,6 @@ Every move from another generator so far ran the same loop: build the old site,
|
|
|
76
76
|
1. **Reference builds you can trust.** `ssqch baseline "<old build command>"` builds the old site with its own generator three times, each in a fresh copy with every file's time pinned and `TZ=UTC`, into `.cache/ssqch/baseline/ref-1` to `-3`, and names what changes by itself (the build's time, ids from `Math.random()`): pin it, or note an `--ignore` pattern for it, before anything else. After the move's first commit, build the commit before it: `--commit <rev>`. When builds vary, run more of them (`--runs 20`): the summary counts how many builds agree on each file and names the one most like the others, and `.cache/ssqch/baseline/ref-common` has each file's most common version, which is the one to compare with. A commit that needs a fix to build at all takes `--patch fix.patch`; a tool that won't follow a link out of its folder (Hugo's `js.Build`) takes `--copy-installs` (a `hugo` command gets it by itself). Watch the first build's warnings: GitHub Pages' placeholder `github.com/pages/...` URLs mean the reference build is wrong on every page.
|
|
77
77
|
2. **What the move takes.** `ssqch scout` finds the old generator and lists what the site uses that needs doing, each with its file and line and ssqch's way to do it (or "not in ssqch yet"), with the `ssqch baseline` command for step 1; `--format json` has it as data. `--write-draft` writes the config draft and the other new files, and `--patch move.patch` writes the mechanical edits as a patch to read and `git apply`. Run it again at any point to see what's left. `ssqch docs --from <generator>` has that generator's words with ssqch's for each, and its trailhead.
|
|
78
78
|
3. **A build that works.** Build into an empty folder (files an earlier build left count as differences): `rm -rf dist && TZ=UTC ssqch build --format json`, until `ok` is true. Each error has a `code`, a `file` and a `line`.
|
|
79
|
-
4. **The biggest group first.** `ssqch diff .cache/ssqch/baseline/ref-1 dist --format json --lines 0` lists the changes on more than one file as `groups`, the most files first. One cause (a filter that formats dates another way, a layout that lost a `<meta>`) is often hundreds of pages, and fixing it shows what's under it. Each change on a page says which heading it's under (`@ under #its-id`, or `at` in the JSON), to find it in the source, and the notes call out what moves a reader: a changed `<title>`, canonical link or redirect, ids that links point at, and a feed's entries. Build and compare again after each fix. What browsers read the same (attribute order, quotes, entities, `<br/>`), fingerprints and image ids don't count, so what's left is a real difference.
|
|
79
|
+
4. **The biggest group first.** `ssqch diff .cache/ssqch/baseline/ref-1 dist --format json --lines 0` lists the changes on more than one file as `groups`, the most files first. One cause (a filter that formats dates another way, a layout that lost a `<meta>`) is often hundreds of pages, and fixing it shows what's under it. Each change on a page says which heading it's under (`@ under #its-id`, or `at` in the JSON), to find it in the source, and the notes call out what moves a reader: a changed `<title>`, canonical link or redirect, ids that links point at, and a feed's entries. Build and compare again after each fix. What browsers read the same (attribute order, quotes, entities, percent-encoding in URLs, `<br/>`), fingerprints and image ids don't count, so what's left is a real difference.
|
|
80
80
|
5. **Done is a decision.** Stop at `No differences`, or when what's left is on purpose: write each one down with why (an `--ignore` pattern with a comment, or a line in the move's notes). `ssqch diff --exact` shows the bytes that still differ, such as a minifier's.
|
|
81
81
|
6. **Then ssqch's own features,** one at a time (its Markdown, highlighting, minifying, `toc()`), with a diff after each, so every change in the output has one cause.
|
|
@@ -13,7 +13,7 @@ Built in 110 ms (production)
|
|
|
13
13
|
Time setup 1.11 ms, data 1.31 ms, read 32.3 ms, paginate 2.81 ms, render 7.56 ms, write 55.9 ms, copy 193 µs, after 9.21 ms
|
|
14
14
|
```
|
|
15
15
|
|
|
16
|
-
- **The first line** is `First confirmed
|
|
16
|
+
- **The first line** is `First confirmed sighting. Built in ...` for a site's first build (there's no `.cache/ssqch/output-files.json` yet), which is every build on a CI machine that doesn't keep `.cache`.
|
|
17
17
|
- **Pages** also says what's different from the last build to that folder: `(2 new, 1 gone)` when a page appeared or stopped being written (a post you added, a permalink you changed), and `(3 changed)` in `ssqch serve`, which leaves a page alone when it comes out the same.
|
|
18
18
|
- **Drafts** is in production builds that left `draft: true` pages out: `Drafts 3 unconfirmed (built in development only)`, or `3 left out` when the report's themed line is another one.
|
|
19
19
|
- **Removed** is the stale files `leaveNoTrace` deleted: `Removed 2 stale files, left no trace`, or just `2 stale files`.
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: "Comparing two builds"
|
|
2
|
+
title: "Has the stump moved? Comparing two builds"
|
|
3
3
|
description: "A build that succeeds isn't proof that an upgrade, a refactor or a migration left the site alone."
|
|
4
4
|
---
|
|
5
5
|
<img align="right" src="../../../docs/assets/stickers/footprint.svg" alt="" width="96">
|
|
@@ -15,7 +15,7 @@ ssqch diff dist-before dist
|
|
|
15
15
|
|
|
16
16
|
```text
|
|
17
17
|
Comparing dist-before with dist
|
|
18
|
-
Ignoring asset fingerprints, image ids, integrity hashes, the generator's version, Vue's and Astro's scope ids and fragment markers, whitespace between tags, and how tags are written where browsers read them the same (attribute order, quotes, entities, `<br/>`) (--exact compares bytes).
|
|
18
|
+
Ignoring asset fingerprints, image ids, integrity hashes, the generator's version, Vue's and Astro's scope ids and fragment markers, whitespace between tags, and how tags are written where browsers read them the same (attribute order, quotes, entities, percent-encoding in URLs, `<br/>`) (--exact compares bytes).
|
|
19
19
|
|
|
20
20
|
Added (1)
|
|
21
21
|
+ /trails/cedar/
|