ssqch 0.11.0 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundled/completions/bash +67 -9
- package/bundled/completions/elvish +24 -4
- package/bundled/completions/fish +37 -25
- package/bundled/completions/powershell +26 -4
- package/bundled/completions/zsh +45 -10
- package/bundled/docs/agents.md +2 -2
- package/bundled/docs/build-summary.md +1 -1
- package/bundled/docs/comparing-builds.md +7 -4
- package/bundled/docs/configuring.md +7 -12
- package/bundled/docs/deploying.md +1 -1
- package/bundled/docs/field-guide.md +4 -4
- package/bundled/docs/github-pages.md +2 -1
- 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 +11 -13
- package/bundled/docs/nav.yml +6 -1
- package/bundled/docs/netlify.md +4 -2
- package/bundled/docs/patrol.md +48 -0
- package/bundled/docs/plugins.md +6 -4
- package/bundled/docs/robots.md +72 -0
- package/bundled/docs/seo.md +2 -38
- package/bundled/docs/serving-markdown.md +142 -0
- package/bundled/docs/template-languages.md +2 -1
- package/bundled/docs/templates.md +2 -1
- package/bundled/docs/trailheads/from-component-frameworks.md +9 -10
- 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 +142 -0
- package/bundled/docs/trailheads.md +5 -5
- package/bundled/docs/where-values-come-from.md +5 -5
- package/bundled/docs/writing-plugins.md +69 -0
- package/bundled/ssqch.d.ts +150 -34
- 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 +13 -11
- package/lib/chunk-25WERNDD.js +112 -0
- package/lib/{chunk-H5K2ZE7B.js → chunk-2BJFGKOE.js} +13 -5
- package/lib/chunk-2FKYWYAB.js +268 -0
- package/lib/{chunk-LJOURBYT.js → chunk-3ZTRIO6O.js} +21 -19
- package/lib/{chunk-IOBC665M.js → chunk-4AZFCSGJ.js} +5 -3
- package/lib/{chunk-HWW5NCVJ.js → chunk-4Q6WMTER.js} +1 -1
- package/lib/{chunk-V2FSMOFX.js → chunk-55WXDGO4.js} +3 -3
- package/lib/{chunk-ZR3JYLFB.js → chunk-6FY77I4M.js} +331 -58
- package/lib/{chunk-JC54PHIT.js → chunk-6OUCRDYI.js} +514 -141
- package/lib/{chunk-ERAIEV3O.js → chunk-6U5VIQVY.js} +9 -7
- package/lib/{chunk-Z5OP43HU.js → chunk-7U5GWTEH.js} +455 -94
- package/lib/{chunk-CMJ7X5WW.js → chunk-AIJNG6MJ.js} +3 -2
- package/lib/{chunk-3K237XAX.js → chunk-C2Q7JKFI.js} +12 -10
- package/lib/{chunk-GS5B3CBW.js → chunk-DDV6JEC2.js} +1 -1
- package/lib/{chunk-A75EVUJX.js → chunk-DFJFHULZ.js} +47 -20
- package/lib/{chunk-KZZS4W2V.js → chunk-ENWDM2RW.js} +45 -42
- package/lib/{chunk-I3HYKEEW.js → chunk-ER72RPD6.js} +3 -3
- package/lib/chunk-F3JPNFCZ.js +23 -0
- package/lib/{chunk-B5E27PLU.js → chunk-FENJHLNM.js} +6 -3
- package/lib/{chunk-UU43WIZG.js → chunk-FJML7INB.js} +4 -2
- package/lib/{chunk-KCF2Z6N7.js → chunk-FQZDUDFK.js} +5 -3
- package/lib/{chunk-GJNIQAIH.js → chunk-GSNRAGKQ.js} +13 -6
- package/lib/{chunk-443ZQLVX.js → chunk-GU7BBYWB.js} +5 -4
- package/lib/{chunk-X2GAVYV2.js → chunk-HDKU6LRI.js} +110 -748
- package/lib/chunk-J3C2LEW7.js +121 -0
- package/lib/{chunk-XS4EJSEK.js → chunk-K5WZ2VYK.js} +7 -5
- package/lib/{chunk-3HZZY3Y7.js → chunk-OOKBXQAY.js} +7 -6
- package/lib/chunk-P2WS4RM4.js +707 -0
- package/lib/{chunk-RBNPBTDP.js → chunk-SNQOHNXE.js} +1 -1
- package/lib/{chunk-HFSWUTXX.js → chunk-SPIFZBIW.js} +1 -1
- package/lib/{chunk-QLUTNR37.js → chunk-T5IUI7W7.js} +12 -11
- package/lib/{chunk-ZINLHOX4.js → chunk-TGSVSG2G.js} +3 -2
- package/lib/{chunk-2L3HR67O.js → chunk-U2KEMVXO.js} +24 -16
- package/lib/{chunk-RYIWYWRQ.js → chunk-UHRBPZ4A.js} +7 -5
- package/lib/{chunk-2QTJTEBV.js → chunk-ULCT3PAV.js} +1 -1
- package/lib/{chunk-FCM3NYFR.js → chunk-UZNUS7RP.js} +12 -9
- package/lib/{chunk-GLJQ4C76.js → chunk-V3G2QGL3.js} +13 -106
- package/lib/{chunk-Z44IAMNG.js → chunk-VILOEVK7.js} +60 -28
- package/lib/chunk-VJWQSYEG.js +119 -0
- package/lib/{chunk-5ELAUHRL.js → chunk-WGAIE3DD.js} +23 -19
- package/lib/{chunk-OQGXZYZS.js → chunk-WUCRAV36.js} +13 -7
- package/lib/{chunk-RZYAIX2R.js → chunk-XYAWJTHM.js} +11 -10
- package/lib/{chunk-OSBEH67S.js → chunk-YA23NDMW.js} +5 -3
- package/lib/{chunk-AIMEXBTK.js → chunk-YNJNMQWU.js} +37 -142
- package/lib/{chunk-QJ5ZFTML.js → chunk-ZMG25MXF.js} +20 -18
- package/lib/cli.js +72 -35
- package/lib/elements.js +13 -11
- 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 +12 -11
- package/lib/links.js +13 -11
- package/lib/llms.js +613 -0
- package/lib/minify.js +14 -12
- package/lib/redirects.js +13 -11
- package/lib/robots.js +87 -0
- package/lib/rss.js +24 -13
- package/lib/sass.js +12 -11
- package/lib/sitemap.js +23 -18
- package/lib/ssqch.js +6 -5
- package/lib/vue.js +400 -0
- package/package.json +29 -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 +51 -31
- package/types/llms.d.ts +27 -0
- package/types/robots.d.ts +13 -0
- package/types/sass.d.ts +1 -1
- package/types/sitemap.d.ts +2 -2
- package/types/vue.d.ts +17 -0
- package/wasm/markdown.wasm +0 -0
- package/lib/chunk-RVXGUMFI.js +0 -21
- /package/lib/{chunk-ZR3JYLFB.js.LEGAL.txt → chunk-6FY77I4M.js.LEGAL.txt} +0 -0
- /package/lib/{chunk-AIMEXBTK.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
|
|
@@ -251,7 +257,7 @@ _ssqch() {
|
|
|
251
257
|
return 0
|
|
252
258
|
;;
|
|
253
259
|
ssqch__subcmd__diff)
|
|
254
|
-
opts="-o -q -v -h --exact --ungrouped --ignore --only --exclude --lines --format --root --output --base --offline --env --quiet --verbose --help"
|
|
260
|
+
opts="-o -q -v -h --exact --ungrouped --text --ignore --only --exclude --lines --format --root --output --base --offline --env --quiet --verbose --help"
|
|
255
261
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
256
262
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
257
263
|
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)'
|
|
@@ -135,6 +136,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
135
136
|
cand --only 'Only compare files matching this glob, like ''**/*.html'' (repeatable)'
|
|
136
137
|
cand --exclude 'Leave out files matching this glob, like ''img/**'' (repeatable)'
|
|
137
138
|
cand --ungrouped 'List each file with all its changes, without grouping the ones shared by several files'
|
|
139
|
+
cand --text 'Compare the article text of each page, word by word, and say how much of it matches'
|
|
138
140
|
cand --lines 'Changed lines to show for each file (0 for all)'
|
|
139
141
|
cand --format 'text or json'
|
|
140
142
|
cand --root 'Project root (defaults to the current directory)'
|
|
@@ -167,6 +169,21 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
167
169
|
cand -h 'Print help'
|
|
168
170
|
cand --help 'Print help'
|
|
169
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
|
+
}
|
|
170
187
|
&'ssqch;init'= {
|
|
171
188
|
cand --starter 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)'
|
|
172
189
|
cand --engine 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs'
|
|
@@ -257,10 +274,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
257
274
|
cand build 'Build the site (default)'
|
|
258
275
|
cand serve 'Build, serve, watch for changes and live-reload the browser'
|
|
259
276
|
cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
|
|
260
|
-
cand
|
|
277
|
+
cand trace 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value'
|
|
261
278
|
cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
262
279
|
cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
|
|
263
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'
|
|
264
282
|
cand init 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
265
283
|
cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
266
284
|
cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
|
|
@@ -275,7 +293,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
275
293
|
}
|
|
276
294
|
&'ssqch;help;new'= {
|
|
277
295
|
}
|
|
278
|
-
&'ssqch;help;
|
|
296
|
+
&'ssqch;help;trace'= {
|
|
279
297
|
}
|
|
280
298
|
&'ssqch;help;completions'= {
|
|
281
299
|
}
|
|
@@ -283,6 +301,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
283
301
|
}
|
|
284
302
|
&'ssqch;help;footprint'= {
|
|
285
303
|
}
|
|
304
|
+
&'ssqch;help;patrol'= {
|
|
305
|
+
}
|
|
286
306
|
&'ssqch;help;init'= {
|
|
287
307
|
}
|
|
288
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
|
|
@@ -103,6 +104,7 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l ignore -d 'Leave ou
|
|
|
103
104
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l only -d 'Only compare files matching this glob, like \'**/*.html\' (repeatable)' -r
|
|
104
105
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l exclude -d 'Leave out files matching this glob, like \'img/**\' (repeatable)' -r
|
|
105
106
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l ungrouped -d 'List each file with all its changes, without grouping the ones shared by several files'
|
|
107
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l text -d 'Compare the article text of each page, word by word, and say how much of it matches'
|
|
106
108
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l lines -d 'Changed lines to show for each file (0 for all)' -r
|
|
107
109
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l format -d 'text or json' -r
|
|
108
110
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
@@ -116,14 +118,23 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s v -l verbose -d 'Al
|
|
|
116
118
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s h -l help -d 'Print help'
|
|
117
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
|
|
118
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
|
|
119
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
|
|
120
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
|
|
121
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
|
|
122
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
|
|
123
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'
|
|
124
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'
|
|
125
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'
|
|
126
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'
|
|
127
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
|
|
128
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
|
|
129
140
|
complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
@@ -179,17 +190,18 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -l offline -d 'Don\'t
|
|
|
179
190
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s q -l quiet -d 'Print only warnings and errors'
|
|
180
191
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
181
192
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s h -l help -d 'Print help'
|
|
182
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new
|
|
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
|
|
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)')
|
|
@@ -144,6 +145,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
144
145
|
[CompletionResult]::new('--only', '--only', [CompletionResultType]::ParameterName, 'Only compare files matching this glob, like ''**/*.html'' (repeatable)')
|
|
145
146
|
[CompletionResult]::new('--exclude', '--exclude', [CompletionResultType]::ParameterName, 'Leave out files matching this glob, like ''img/**'' (repeatable)')
|
|
146
147
|
[CompletionResult]::new('--ungrouped', '--ungrouped', [CompletionResultType]::ParameterName, 'List each file with all its changes, without grouping the ones shared by several files')
|
|
148
|
+
[CompletionResult]::new('--text', '--text', [CompletionResultType]::ParameterName, 'Compare the article text of each page, word by word, and say how much of it matches')
|
|
147
149
|
[CompletionResult]::new('--lines', '--lines', [CompletionResultType]::ParameterName, 'Changed lines to show for each file (0 for all)')
|
|
148
150
|
[CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
|
|
149
151
|
[CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
|
|
@@ -178,6 +180,22 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
178
180
|
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
179
181
|
break
|
|
180
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
|
+
}
|
|
181
199
|
'ssqch;init' {
|
|
182
200
|
[CompletionResult]::new('--starter', '--starter', [CompletionResultType]::ParameterName, 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)')
|
|
183
201
|
[CompletionResult]::new('--engine', '--engine', [CompletionResultType]::ParameterName, 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs')
|
|
@@ -274,10 +292,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
274
292
|
[CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
|
|
275
293
|
[CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
|
|
276
294
|
[CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
|
|
277
|
-
[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')
|
|
278
296
|
[CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
|
|
279
297
|
[CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
|
|
280
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')
|
|
281
300
|
[CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
|
|
282
301
|
[CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
|
|
283
302
|
[CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
|
|
@@ -296,7 +315,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
296
315
|
'ssqch;help;new' {
|
|
297
316
|
break
|
|
298
317
|
}
|
|
299
|
-
'ssqch;help;
|
|
318
|
+
'ssqch;help;trace' {
|
|
300
319
|
break
|
|
301
320
|
}
|
|
302
321
|
'ssqch;help;completions' {
|
|
@@ -308,6 +327,9 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
308
327
|
'ssqch;help;footprint' {
|
|
309
328
|
break
|
|
310
329
|
}
|
|
330
|
+
'ssqch;help;patrol' {
|
|
331
|
+
break
|
|
332
|
+
}
|
|
311
333
|
'ssqch;help;init' {
|
|
312
334
|
break
|
|
313
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' \
|
|
@@ -140,6 +140,7 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
140
140
|
'*--only=[Only compare files matching this glob, like '\''**/*.html'\'' (repeatable)]:GLOB:_default' \
|
|
141
141
|
'*--exclude=[Leave out files matching this glob, like '\''img/**'\'' (repeatable)]:GLOB:_default' \
|
|
142
142
|
'--ungrouped[List each file with all its changes, without grouping the ones shared by several files]' \
|
|
143
|
+
'--text[Compare the article text of each page, word by word, and say how much of it matches]' \
|
|
143
144
|
'--lines=[Changed lines to show for each file (0 for all)]:LINES:_default' \
|
|
144
145
|
'--format=[text or json]:FORMAT:_default' \
|
|
145
146
|
'--root=[Project root (defaults to the current directory)]:ROOT:_files' \
|
|
@@ -178,6 +179,24 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
178
179
|
'::dir -- The build folder (default\: the site'\''s output folder):_files' \
|
|
179
180
|
&& ret=0
|
|
180
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
|
+
;;
|
|
181
200
|
(init)
|
|
182
201
|
_arguments "${_arguments_options[@]}" : \
|
|
183
202
|
'--starter=[What to start with\: site (a small blog) or docs (documentation with a sidebar, tabs and search)]:NAME:_default' \
|
|
@@ -304,7 +323,7 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
304
323
|
_arguments "${_arguments_options[@]}" : \
|
|
305
324
|
&& ret=0
|
|
306
325
|
;;
|
|
307
|
-
(
|
|
326
|
+
(trace)
|
|
308
327
|
_arguments "${_arguments_options[@]}" : \
|
|
309
328
|
&& ret=0
|
|
310
329
|
;;
|
|
@@ -320,6 +339,10 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
320
339
|
_arguments "${_arguments_options[@]}" : \
|
|
321
340
|
&& ret=0
|
|
322
341
|
;;
|
|
342
|
+
(patrol)
|
|
343
|
+
_arguments "${_arguments_options[@]}" : \
|
|
344
|
+
&& ret=0
|
|
345
|
+
;;
|
|
323
346
|
(init)
|
|
324
347
|
_arguments "${_arguments_options[@]}" : \
|
|
325
348
|
&& ret=0
|
|
@@ -359,10 +382,11 @@ _ssqch_commands() {
|
|
|
359
382
|
'build:Build the site (default)' \
|
|
360
383
|
'serve:Build, serve, watch for changes and live-reload the browser' \
|
|
361
384
|
'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
|
|
362
|
-
'
|
|
385
|
+
'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
|
|
363
386
|
'completions:Print a completion script for your shell, so Tab finishes commands and options' \
|
|
364
387
|
'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
|
|
365
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' \
|
|
366
390
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
367
391
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
368
392
|
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
@@ -403,16 +427,22 @@ _ssqch__subcmd__footprint_commands() {
|
|
|
403
427
|
local commands; commands=()
|
|
404
428
|
_describe -t commands 'ssqch footprint commands' commands "$@"
|
|
405
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
|
+
}
|
|
406
435
|
(( $+functions[_ssqch__subcmd__help_commands] )) ||
|
|
407
436
|
_ssqch__subcmd__help_commands() {
|
|
408
437
|
local commands; commands=(
|
|
409
438
|
'build:Build the site (default)' \
|
|
410
439
|
'serve:Build, serve, watch for changes and live-reload the browser' \
|
|
411
440
|
'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
|
|
412
|
-
'
|
|
441
|
+
'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
|
|
413
442
|
'completions:Print a completion script for your shell, so Tab finishes commands and options' \
|
|
414
443
|
'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
|
|
415
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' \
|
|
416
446
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
417
447
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
418
448
|
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
@@ -453,6 +483,11 @@ _ssqch__subcmd__help__subcmd__footprint_commands() {
|
|
|
453
483
|
local commands; commands=()
|
|
454
484
|
_describe -t commands 'ssqch help footprint commands' commands "$@"
|
|
455
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
|
+
}
|
|
456
491
|
(( $+functions[_ssqch__subcmd__help__subcmd__help_commands] )) ||
|
|
457
492
|
_ssqch__subcmd__help__subcmd__help_commands() {
|
|
458
493
|
local commands; commands=()
|
|
@@ -468,10 +503,10 @@ _ssqch__subcmd__help__subcmd__init_commands() {
|
|
|
468
503
|
local commands; commands=()
|
|
469
504
|
_describe -t commands 'ssqch help init commands' commands "$@"
|
|
470
505
|
}
|
|
471
|
-
(( $+functions[
|
|
472
|
-
|
|
506
|
+
(( $+functions[_ssqch__subcmd__help__subcmd__trace_commands] )) ||
|
|
507
|
+
_ssqch__subcmd__help__subcmd__trace_commands() {
|
|
473
508
|
local commands; commands=()
|
|
474
|
-
_describe -t commands 'ssqch help
|
|
509
|
+
_describe -t commands 'ssqch help trace commands' commands "$@"
|
|
475
510
|
}
|
|
476
511
|
(( $+functions[_ssqch__subcmd__help__subcmd__new_commands] )) ||
|
|
477
512
|
_ssqch__subcmd__help__subcmd__new_commands() {
|
|
@@ -503,10 +538,10 @@ _ssqch__subcmd__init_commands() {
|
|
|
503
538
|
local commands; commands=()
|
|
504
539
|
_describe -t commands 'ssqch init commands' commands "$@"
|
|
505
540
|
}
|
|
506
|
-
(( $+functions[
|
|
507
|
-
|
|
541
|
+
(( $+functions[_ssqch__subcmd__trace_commands] )) ||
|
|
542
|
+
_ssqch__subcmd__trace_commands() {
|
|
508
543
|
local commands; commands=()
|
|
509
|
-
_describe -t commands 'ssqch
|
|
544
|
+
_describe -t commands 'ssqch trace commands' commands "$@"
|
|
510
545
|
}
|
|
511
546
|
(( $+functions[_ssqch__subcmd__new_commands] )) ||
|
|
512
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`.
|