ssqch 0.10.1 → 0.11.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 +61 -15
- package/bundled/completions/elvish +27 -12
- package/bundled/completions/fish +35 -23
- package/bundled/completions/powershell +29 -12
- package/bundled/completions/zsh +39 -19
- package/bundled/docs/agents.md +11 -0
- package/bundled/docs/comparing-builds.md +37 -5
- package/bundled/docs/configuring.md +30 -5
- package/bundled/docs/field-guide.md +1 -1
- package/bundled/docs/github-pages.md +1 -1
- package/bundled/docs/index.md +1 -1
- package/bundled/docs/known-gaps.md +1 -1
- package/bundled/docs/markdown.md +63 -5
- package/bundled/docs/multilingual.md +20 -3
- package/bundled/docs/nav.yml +1 -0
- package/bundled/docs/netlify.md +2 -2
- package/bundled/docs/plugins.md +4 -4
- package/bundled/docs/seo.md +39 -1
- package/bundled/docs/template-languages.md +6 -4
- package/bundled/docs/templates.md +3 -3
- package/bundled/docs/trailheads/from-eleventy.md +25 -13
- package/bundled/docs/trailheads/from-hugo.md +103 -0
- package/bundled/docs/trailheads/from-jekyll.md +49 -15
- package/bundled/docs/trailheads/from-mkdocs.md +54 -9
- package/bundled/docs/trailheads/from-zola.md +2 -2
- package/bundled/docs/trailheads.md +22 -5
- package/bundled/docs/where-values-come-from.md +1 -1
- package/bundled/mkdocs/404.jinja +6 -0
- package/bundled/ssqch.d.ts +71 -16
- package/lib/assets.js +10 -9
- package/lib/{chunk-MUYWL4ZX.js → chunk-2L3HR67O.js} +71 -18
- package/lib/{chunk-ERNVEZOK.js → chunk-2QTJTEBV.js} +1 -1
- package/lib/{chunk-CXRHH5P5.js → chunk-3HZZY3Y7.js} +5 -5
- package/lib/{chunk-G67W2FTJ.js → chunk-3K237XAX.js} +9 -8
- package/lib/{chunk-6RSZV5O2.js → chunk-443ZQLVX.js} +3 -3
- package/lib/{chunk-ZZBHBLDB.js → chunk-5ELAUHRL.js} +18 -16
- package/lib/{chunk-MDG5A4NI.js → chunk-A75EVUJX.js} +5 -5
- package/lib/{chunk-JFPLNHEQ.js → chunk-AIMEXBTK.js} +28 -5
- package/lib/{chunk-6OUT5VFK.js → chunk-B5E27PLU.js} +10 -39
- package/lib/{chunk-R2YGC3VE.js → chunk-CMJ7X5WW.js} +3 -2
- package/lib/{chunk-MDB3D3LP.js → chunk-ERAIEV3O.js} +2 -2
- package/lib/{chunk-DTSTCVRX.js → chunk-FCM3NYFR.js} +11 -8
- package/lib/{chunk-X7C6GFUM.js → chunk-GJNIQAIH.js} +8 -8
- package/lib/{chunk-FYRC2HBU.js → chunk-GLJQ4C76.js} +39 -18
- package/lib/{chunk-BXARVN5Z.js → chunk-GS5B3CBW.js} +1 -1
- package/lib/chunk-H5K2ZE7B.js +219 -0
- package/lib/{chunk-DNWA7WNO.js → chunk-HFSWUTXX.js} +1 -1
- package/lib/{chunk-7JGYYAKI.js → chunk-HWW5NCVJ.js} +1 -1
- package/lib/{chunk-BT3NVQOD.js → chunk-I3HYKEEW.js} +1 -1
- package/lib/{chunk-RFNLZM7W.js → chunk-IOBC665M.js} +1 -1
- package/lib/chunk-JC54PHIT.js +7992 -0
- package/lib/{chunk-3BQJY6GF.js → chunk-KCF2Z6N7.js} +1 -1
- package/lib/{chunk-HMVYNV6M.js → chunk-KZZS4W2V.js} +14 -12
- package/lib/{chunk-XR7GFL4B.js → chunk-LJOURBYT.js} +14 -12
- package/lib/chunk-OQGXZYZS.js +45 -0
- package/lib/chunk-OSBEH67S.js +6296 -0
- package/lib/{chunk-FYU22VDK.js → chunk-QJ5ZFTML.js} +14 -12
- package/lib/{chunk-LU73FTIR.js → chunk-QLUTNR37.js} +11 -10
- package/lib/{chunk-DUGGZ4EE.js → chunk-RBNPBTDP.js} +1 -1
- package/lib/{chunk-F65YUXZ7.js → chunk-RIAOXEXC.js} +10 -4
- package/lib/chunk-RVXGUMFI.js +21 -0
- package/lib/{chunk-FZGJUJAL.js → chunk-RYIWYWRQ.js} +3 -3
- package/lib/{chunk-LYPKL524.js → chunk-RZYAIX2R.js} +12 -10
- package/lib/{chunk-3NDFUMV2.js → chunk-V2FSMOFX.js} +3 -3
- package/lib/{chunk-26SHWRC6.js → chunk-X2GAVYV2.js} +524 -72
- package/lib/chunk-XS4EJSEK.js +279 -0
- package/lib/chunk-YCOTX2VM.js +37 -0
- package/lib/{chunk-P2TRR6XK.js → chunk-Z44IAMNG.js} +85 -16
- package/lib/chunk-Z5OP43HU.js +2945 -0
- package/lib/{chunk-3LODFCCH.js → chunk-ZINLHOX4.js} +2 -2
- package/lib/{chunk-HNG372DW.js → chunk-ZR3JYLFB.js} +814 -12347
- package/lib/cli.js +78 -37
- package/lib/elements.js +10 -9
- package/lib/image.js +11 -10
- package/lib/links.js +10 -9
- package/lib/minify.js +71 -12
- package/lib/redirects.js +10 -9
- package/lib/rss.js +13 -10
- package/lib/sass.js +13 -243
- package/lib/sitemap.js +18 -15
- package/lib/ssqch.js +6 -4
- package/package.json +1 -1
- package/types/index.d.ts +52 -11
- package/types/minify.d.ts +15 -3
- package/types/sass.d.ts +2 -0
- package/types/sitemap.d.ts +2 -2
- package/wasm/markdown.wasm +0 -0
- package/wasm/minify.wasm +0 -0
- package/wasm/sass.wasm +0 -0
- package/lib/chunk-II7ZRIAC.js +0 -1285
- package/lib/chunk-IOXCGMSF.js +0 -1539
- /package/lib/{chunk-JFPLNHEQ.js.LEGAL.txt → chunk-AIMEXBTK.js.LEGAL.txt} +0 -0
- /package/lib/{chunk-HNG372DW.js.LEGAL.txt → chunk-ZR3JYLFB.js.LEGAL.txt} +0 -0
package/bundled/completions/bash
CHANGED
|
@@ -37,8 +37,11 @@ _ssqch() {
|
|
|
37
37
|
ssqch,help)
|
|
38
38
|
cmd="ssqch__subcmd__help"
|
|
39
39
|
;;
|
|
40
|
-
ssqch,
|
|
41
|
-
cmd="
|
|
40
|
+
ssqch,baseline)
|
|
41
|
+
cmd="ssqch__subcmd__baseline"
|
|
42
|
+
;;
|
|
43
|
+
ssqch,scout)
|
|
44
|
+
cmd="ssqch__subcmd__scout"
|
|
42
45
|
;;
|
|
43
46
|
ssqch,init)
|
|
44
47
|
cmd="ssqch__subcmd__init"
|
|
@@ -76,8 +79,11 @@ _ssqch() {
|
|
|
76
79
|
ssqch__subcmd__help,help)
|
|
77
80
|
cmd="ssqch__subcmd__help__subcmd__help"
|
|
78
81
|
;;
|
|
79
|
-
ssqch__subcmd__help,
|
|
80
|
-
cmd="
|
|
82
|
+
ssqch__subcmd__help,baseline)
|
|
83
|
+
cmd="ssqch__subcmd__help__subcmd__baseline"
|
|
84
|
+
;;
|
|
85
|
+
ssqch__subcmd__help,scout)
|
|
86
|
+
cmd="ssqch__subcmd__help__subcmd__scout"
|
|
81
87
|
;;
|
|
82
88
|
ssqch__subcmd__help,init)
|
|
83
89
|
cmd="ssqch__subcmd__help__subcmd__init"
|
|
@@ -101,7 +107,7 @@ _ssqch() {
|
|
|
101
107
|
|
|
102
108
|
case "${cmd}" in
|
|
103
109
|
ssqch)
|
|
104
|
-
opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new inspect completions diff footprint init types
|
|
110
|
+
opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new inspect completions diff footprint init types baseline scout capabilities docs help"
|
|
105
111
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then
|
|
106
112
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
107
113
|
return 0
|
|
@@ -245,7 +251,7 @@ _ssqch() {
|
|
|
245
251
|
return 0
|
|
246
252
|
;;
|
|
247
253
|
ssqch__subcmd__diff)
|
|
248
|
-
opts="-o -q -v -h --exact --ignore --only --lines --format --root --output --base --offline --env --quiet --verbose --help"
|
|
254
|
+
opts="-o -q -v -h --exact --ungrouped --ignore --only --exclude --lines --format --root --output --base --offline --env --quiet --verbose --help"
|
|
249
255
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
250
256
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
251
257
|
return 0
|
|
@@ -259,6 +265,10 @@ _ssqch() {
|
|
|
259
265
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
260
266
|
return 0
|
|
261
267
|
;;
|
|
268
|
+
--exclude)
|
|
269
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
270
|
+
return 0
|
|
271
|
+
;;
|
|
262
272
|
--lines)
|
|
263
273
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
264
274
|
return 0
|
|
@@ -379,7 +389,7 @@ _ssqch() {
|
|
|
379
389
|
return 0
|
|
380
390
|
;;
|
|
381
391
|
ssqch__subcmd__help)
|
|
382
|
-
opts="build serve new inspect completions diff footprint init types
|
|
392
|
+
opts="build serve new inspect completions diff footprint init types baseline scout capabilities docs help"
|
|
383
393
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
384
394
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
385
395
|
return 0
|
|
@@ -490,7 +500,21 @@ _ssqch() {
|
|
|
490
500
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
491
501
|
return 0
|
|
492
502
|
;;
|
|
493
|
-
|
|
503
|
+
ssqch__subcmd__help__subcmd__baseline)
|
|
504
|
+
opts=""
|
|
505
|
+
if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
|
|
506
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
507
|
+
return 0
|
|
508
|
+
fi
|
|
509
|
+
case "${prev}" in
|
|
510
|
+
*)
|
|
511
|
+
COMPREPLY=()
|
|
512
|
+
;;
|
|
513
|
+
esac
|
|
514
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
515
|
+
return 0
|
|
516
|
+
;;
|
|
517
|
+
ssqch__subcmd__help__subcmd__scout)
|
|
494
518
|
opts=""
|
|
495
519
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
|
|
496
520
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
@@ -574,33 +598,55 @@ _ssqch() {
|
|
|
574
598
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
575
599
|
return 0
|
|
576
600
|
;;
|
|
577
|
-
|
|
578
|
-
opts="-
|
|
601
|
+
ssqch__subcmd__baseline)
|
|
602
|
+
opts="-q -h --from --runs --commit --to --link --patch --copy-installs --root --quiet --help"
|
|
579
603
|
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
580
604
|
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
581
605
|
return 0
|
|
582
606
|
fi
|
|
583
607
|
case "${prev}" in
|
|
584
|
-
--
|
|
608
|
+
--from)
|
|
585
609
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
586
610
|
return 0
|
|
587
611
|
;;
|
|
588
|
-
--
|
|
612
|
+
--runs)
|
|
589
613
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
590
614
|
return 0
|
|
591
615
|
;;
|
|
592
|
-
|
|
616
|
+
--commit)
|
|
593
617
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
594
618
|
return 0
|
|
595
619
|
;;
|
|
596
|
-
--
|
|
620
|
+
--to)
|
|
597
621
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
598
622
|
return 0
|
|
599
623
|
;;
|
|
600
|
-
--
|
|
624
|
+
--link)
|
|
625
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
626
|
+
return 0
|
|
627
|
+
;;
|
|
628
|
+
--patch)
|
|
601
629
|
COMPREPLY=($(compgen -f "${cur}"))
|
|
602
630
|
return 0
|
|
603
631
|
;;
|
|
632
|
+
--root)
|
|
633
|
+
COMPREPLY=($(compgen -f "${cur}"))
|
|
634
|
+
return 0
|
|
635
|
+
;;
|
|
636
|
+
*)
|
|
637
|
+
COMPREPLY=()
|
|
638
|
+
;;
|
|
639
|
+
esac
|
|
640
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
641
|
+
return 0
|
|
642
|
+
;;
|
|
643
|
+
ssqch__subcmd__scout)
|
|
644
|
+
opts="-h --write-draft --from --format --patch --compare --reference --help"
|
|
645
|
+
if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
|
|
646
|
+
COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
|
|
647
|
+
return 0
|
|
648
|
+
fi
|
|
649
|
+
case "${prev}" in
|
|
604
650
|
*)
|
|
605
651
|
COMPREPLY=()
|
|
606
652
|
;;
|
|
@@ -41,7 +41,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
41
41
|
cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
42
42
|
cand init 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
43
43
|
cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
44
|
-
cand
|
|
44
|
+
cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
|
|
45
|
+
cand scout 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
|
|
45
46
|
cand capabilities 'Say what this binary supports: template languages, modules, config options and optional features'
|
|
46
47
|
cand docs 'Read the documentation for this version: a command, config option, function or topic'
|
|
47
48
|
cand help 'Print this message or the help of the given subcommand(s)'
|
|
@@ -132,6 +133,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
132
133
|
&'ssqch;diff'= {
|
|
133
134
|
cand --ignore 'Leave out text matching this regular expression before comparing (repeatable)'
|
|
134
135
|
cand --only 'Only compare files matching this glob, like ''**/*.html'' (repeatable)'
|
|
136
|
+
cand --exclude 'Leave out files matching this glob, like ''img/**'' (repeatable)'
|
|
137
|
+
cand --ungrouped 'List each file with all its changes, without grouping the ones shared by several files'
|
|
135
138
|
cand --lines 'Changed lines to show for each file (0 for all)'
|
|
136
139
|
cand --format 'text or json'
|
|
137
140
|
cand --root 'Project root (defaults to the current directory)'
|
|
@@ -195,18 +198,27 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
195
198
|
cand -h 'Print help'
|
|
196
199
|
cand --help 'Print help'
|
|
197
200
|
}
|
|
198
|
-
&'ssqch;
|
|
201
|
+
&'ssqch;baseline'= {
|
|
199
202
|
cand --root 'Project root (defaults to the current directory)'
|
|
200
|
-
cand
|
|
201
|
-
cand --
|
|
202
|
-
cand --
|
|
203
|
-
cand --
|
|
204
|
-
cand --
|
|
205
|
-
cand --
|
|
203
|
+
cand --from 'The folder the command writes (default _site)'
|
|
204
|
+
cand --runs 'How many builds to make and compare (default 3)'
|
|
205
|
+
cand --commit 'Build this commit instead of the working tree'
|
|
206
|
+
cand --to 'What to call the builds (default ref)'
|
|
207
|
+
cand --link 'Link this folder of the site into each copy (repeatable)'
|
|
208
|
+
cand --patch 'Apply this patch to each copy before building'
|
|
209
|
+
cand --copy-installs 'Copy the installs into each copy instead of linking them'
|
|
206
210
|
cand -q 'Print only warnings and errors'
|
|
207
211
|
cand --quiet 'Print only warnings and errors'
|
|
208
|
-
cand -
|
|
209
|
-
cand --
|
|
212
|
+
cand -h 'Print help'
|
|
213
|
+
cand --help 'Print help'
|
|
214
|
+
}
|
|
215
|
+
&'ssqch;scout'= {
|
|
216
|
+
cand --from 'The generator the site is built with, when scout finds another'
|
|
217
|
+
cand --format 'text or json'
|
|
218
|
+
cand --write-draft 'Write the new files of the draft; never overwrites a file'
|
|
219
|
+
cand --patch 'Write the mechanical edits to FILE as a patch to review; nothing is applied'
|
|
220
|
+
cand --compare 'Also build with ssqch and compare with the reference build'
|
|
221
|
+
cand --reference 'The reference build to compare with'
|
|
210
222
|
cand -h 'Print help'
|
|
211
223
|
cand --help 'Print help'
|
|
212
224
|
}
|
|
@@ -251,7 +263,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
251
263
|
cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
|
|
252
264
|
cand init 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
253
265
|
cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
254
|
-
cand
|
|
266
|
+
cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
|
|
267
|
+
cand scout 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
|
|
255
268
|
cand capabilities 'Say what this binary supports: template languages, modules, config options and optional features'
|
|
256
269
|
cand docs 'Read the documentation for this version: a command, config option, function or topic'
|
|
257
270
|
cand help 'Print this message or the help of the given subcommand(s)'
|
|
@@ -274,7 +287,9 @@ set edit:completion:arg-completer[ssqch] = {|@words|
|
|
|
274
287
|
}
|
|
275
288
|
&'ssqch;help;types'= {
|
|
276
289
|
}
|
|
277
|
-
&'ssqch;help;
|
|
290
|
+
&'ssqch;help;baseline'= {
|
|
291
|
+
}
|
|
292
|
+
&'ssqch;help;scout'= {
|
|
278
293
|
}
|
|
279
294
|
&'ssqch;help;capabilities'= {
|
|
280
295
|
}
|
package/bundled/completions/fish
CHANGED
|
@@ -42,7 +42,8 @@ complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "diff" -d 'Compare two b
|
|
|
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
43
|
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
44
|
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
|
-
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "
|
|
45
|
+
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'
|
|
46
|
+
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "scout" -d 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
|
|
46
47
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
|
|
47
48
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
|
|
48
49
|
complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
|
|
@@ -100,6 +101,8 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -s v -l verbose
|
|
|
100
101
|
complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -s h -l help -d 'Print help'
|
|
101
102
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l ignore -d 'Leave out text matching this regular expression before comparing (repeatable)' -r
|
|
102
103
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l only -d 'Only compare files matching this glob, like \'**/*.html\' (repeatable)' -r
|
|
104
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l exclude -d 'Leave out files matching this glob, like \'img/**\' (repeatable)' -r
|
|
105
|
+
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'
|
|
103
106
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l lines -d 'Changed lines to show for each file (0 for all)' -r
|
|
104
107
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l format -d 'text or json' -r
|
|
105
108
|
complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
@@ -140,15 +143,23 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand types" -l offline -d 'Don\'t
|
|
|
140
143
|
complete -c ssqch -n "__fish_ssqch_using_subcommand types" -s q -l quiet -d 'Print only warnings and errors'
|
|
141
144
|
complete -c ssqch -n "__fish_ssqch_using_subcommand types" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
142
145
|
complete -c ssqch -n "__fish_ssqch_using_subcommand types" -s h -l help -d 'Print help'
|
|
143
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
144
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
145
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
146
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
147
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
148
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
149
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
150
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
151
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand
|
|
146
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
147
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l from -d 'The folder the command writes (default _site)' -r
|
|
148
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l runs -d 'How many builds to make and compare (default 3)' -r
|
|
149
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l commit -d 'Build this commit instead of the working tree' -r
|
|
150
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l to -d 'What to call the builds (default ref)' -r
|
|
151
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l link -d 'Link this folder of the site into each copy (repeatable)' -r -F
|
|
152
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l patch -d 'Apply this patch to each copy before building' -r -F
|
|
153
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -l copy-installs -d 'Copy the installs into each copy instead of linking them'
|
|
154
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -s q -l quiet -d 'Print only warnings and errors'
|
|
155
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand baseline" -s h -l help -d 'Print help'
|
|
156
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l from -d 'The generator the site is built with, when scout finds another' -r
|
|
157
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l format -d 'text or json' -r
|
|
158
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l write-draft -d 'Write the new files of the draft; never overwrites a file'
|
|
159
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l patch -d 'Write the mechanical edits to FILE as a patch to review; nothing is applied' -r -F
|
|
160
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l compare -d 'Also build with ssqch and compare with the reference build'
|
|
161
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -l reference -d 'The reference build to compare with' -r -F
|
|
162
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand scout" -s h -l help -d 'Print help'
|
|
152
163
|
complete -c ssqch -n "__fish_ssqch_using_subcommand capabilities" -l format -d 'text or json' -r
|
|
153
164
|
complete -c ssqch -n "__fish_ssqch_using_subcommand capabilities" -l root -d 'Project root (defaults to the current directory)' -r -F
|
|
154
165
|
complete -c ssqch -n "__fish_ssqch_using_subcommand capabilities" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
|
|
@@ -168,16 +179,17 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -l offline -d 'Don\'t
|
|
|
168
179
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s q -l quiet -d 'Print only warnings and errors'
|
|
169
180
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s v -l verbose -d 'Also list the slowest images to encode'
|
|
170
181
|
complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s h -l help -d 'Print help'
|
|
171
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
172
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
173
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
174
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
175
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
176
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
177
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
178
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
179
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
180
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
181
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
182
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
183
|
-
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types
|
|
182
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "build" -d 'Build the site (default)'
|
|
183
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
|
|
184
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint 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'
|
|
185
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "inspect" -d 'Show where a page comes from, and which level of the data cascade set each value'
|
|
186
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
|
|
187
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint 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'
|
|
188
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint 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'
|
|
189
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
|
|
190
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
|
|
191
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint 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'
|
|
192
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint 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'
|
|
193
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
|
|
194
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
|
|
195
|
+
complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
|
|
@@ -44,7 +44,8 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
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
45
|
[CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
|
|
46
46
|
[CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
|
|
47
|
-
[CompletionResult]::new('
|
|
47
|
+
[CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
|
|
48
|
+
[CompletionResult]::new('scout', 'scout', [CompletionResultType]::ParameterValue, 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move')
|
|
48
49
|
[CompletionResult]::new('capabilities', 'capabilities', [CompletionResultType]::ParameterValue, 'Say what this binary supports: template languages, modules, config options and optional features')
|
|
49
50
|
[CompletionResult]::new('docs', 'docs', [CompletionResultType]::ParameterValue, 'Read the documentation for this version: a command, config option, function or topic')
|
|
50
51
|
[CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
|
|
@@ -141,6 +142,8 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
141
142
|
'ssqch;diff' {
|
|
142
143
|
[CompletionResult]::new('--ignore', '--ignore', [CompletionResultType]::ParameterName, 'Leave out text matching this regular expression before comparing (repeatable)')
|
|
143
144
|
[CompletionResult]::new('--only', '--only', [CompletionResultType]::ParameterName, 'Only compare files matching this glob, like ''**/*.html'' (repeatable)')
|
|
145
|
+
[CompletionResult]::new('--exclude', '--exclude', [CompletionResultType]::ParameterName, 'Leave out files matching this glob, like ''img/**'' (repeatable)')
|
|
146
|
+
[CompletionResult]::new('--ungrouped', '--ungrouped', [CompletionResultType]::ParameterName, 'List each file with all its changes, without grouping the ones shared by several files')
|
|
144
147
|
[CompletionResult]::new('--lines', '--lines', [CompletionResultType]::ParameterName, 'Changed lines to show for each file (0 for all)')
|
|
145
148
|
[CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
|
|
146
149
|
[CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
|
|
@@ -208,18 +211,28 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
208
211
|
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
209
212
|
break
|
|
210
213
|
}
|
|
211
|
-
'ssqch;
|
|
214
|
+
'ssqch;baseline' {
|
|
212
215
|
[CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
|
|
213
|
-
[CompletionResult]::new('
|
|
214
|
-
[CompletionResult]::new('--
|
|
215
|
-
[CompletionResult]::new('--
|
|
216
|
-
[CompletionResult]::new('--
|
|
217
|
-
[CompletionResult]::new('--
|
|
218
|
-
[CompletionResult]::new('--
|
|
216
|
+
[CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'The folder the command writes (default _site)')
|
|
217
|
+
[CompletionResult]::new('--runs', '--runs', [CompletionResultType]::ParameterName, 'How many builds to make and compare (default 3)')
|
|
218
|
+
[CompletionResult]::new('--commit', '--commit', [CompletionResultType]::ParameterName, 'Build this commit instead of the working tree')
|
|
219
|
+
[CompletionResult]::new('--to', '--to', [CompletionResultType]::ParameterName, 'What to call the builds (default ref)')
|
|
220
|
+
[CompletionResult]::new('--link', '--link', [CompletionResultType]::ParameterName, 'Link this folder of the site into each copy (repeatable)')
|
|
221
|
+
[CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Apply this patch to each copy before building')
|
|
222
|
+
[CompletionResult]::new('--copy-installs', '--copy-installs', [CompletionResultType]::ParameterName, 'Copy the installs into each copy instead of linking them')
|
|
219
223
|
[CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
|
|
220
224
|
[CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
|
|
221
|
-
[CompletionResult]::new('-
|
|
222
|
-
[CompletionResult]::new('--
|
|
225
|
+
[CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
|
|
226
|
+
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
227
|
+
break
|
|
228
|
+
}
|
|
229
|
+
'ssqch;scout' {
|
|
230
|
+
[CompletionResult]::new('--from', '--from', [CompletionResultType]::ParameterName, 'The generator the site is built with, when scout finds another')
|
|
231
|
+
[CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
|
|
232
|
+
[CompletionResult]::new('--write-draft', '--write-draft', [CompletionResultType]::ParameterName, 'Write the new files of the draft; never overwrites a file')
|
|
233
|
+
[CompletionResult]::new('--patch', '--patch', [CompletionResultType]::ParameterName, 'Write the mechanical edits to FILE as a patch to review; nothing is applied')
|
|
234
|
+
[CompletionResult]::new('--compare', '--compare', [CompletionResultType]::ParameterName, 'Also build with ssqch and compare with the reference build')
|
|
235
|
+
[CompletionResult]::new('--reference', '--reference', [CompletionResultType]::ParameterName, 'The reference build to compare with')
|
|
223
236
|
[CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
|
|
224
237
|
[CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
|
|
225
238
|
break
|
|
@@ -267,7 +280,8 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
267
280
|
[CompletionResult]::new('footprint', 'footprint', [CompletionResultType]::ParameterValue, 'Show how much a build weighs: its files by kind, and the heaviest pages and files')
|
|
268
281
|
[CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
|
|
269
282
|
[CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
|
|
270
|
-
[CompletionResult]::new('
|
|
283
|
+
[CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
|
|
284
|
+
[CompletionResult]::new('scout', 'scout', [CompletionResultType]::ParameterValue, 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move')
|
|
271
285
|
[CompletionResult]::new('capabilities', 'capabilities', [CompletionResultType]::ParameterValue, 'Say what this binary supports: template languages, modules, config options and optional features')
|
|
272
286
|
[CompletionResult]::new('docs', 'docs', [CompletionResultType]::ParameterValue, 'Read the documentation for this version: a command, config option, function or topic')
|
|
273
287
|
[CompletionResult]::new('help', 'help', [CompletionResultType]::ParameterValue, 'Print this message or the help of the given subcommand(s)')
|
|
@@ -300,7 +314,10 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
|
|
|
300
314
|
'ssqch;help;types' {
|
|
301
315
|
break
|
|
302
316
|
}
|
|
303
|
-
'ssqch;help;
|
|
317
|
+
'ssqch;help;baseline' {
|
|
318
|
+
break
|
|
319
|
+
}
|
|
320
|
+
'ssqch;help;scout' {
|
|
304
321
|
break
|
|
305
322
|
}
|
|
306
323
|
'ssqch;help;capabilities' {
|
package/bundled/completions/zsh
CHANGED
|
@@ -138,6 +138,8 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
138
138
|
_arguments "${_arguments_options[@]}" : \
|
|
139
139
|
'*--ignore=[Leave out text matching this regular expression before comparing (repeatable)]:REGEX:_default' \
|
|
140
140
|
'*--only=[Only compare files matching this glob, like '\''**/*.html'\'' (repeatable)]:GLOB:_default' \
|
|
141
|
+
'*--exclude=[Leave out files matching this glob, like '\''img/**'\'' (repeatable)]:GLOB:_default' \
|
|
142
|
+
'--ungrouped[List each file with all its changes, without grouping the ones shared by several files]' \
|
|
141
143
|
'--lines=[Changed lines to show for each file (0 for all)]:LINES:_default' \
|
|
142
144
|
'--format=[text or json]:FORMAT:_default' \
|
|
143
145
|
'--root=[Project root (defaults to the current directory)]:ROOT:_files' \
|
|
@@ -212,22 +214,33 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
212
214
|
'--help[Print help]' \
|
|
213
215
|
&& ret=0
|
|
214
216
|
;;
|
|
215
|
-
(
|
|
217
|
+
(baseline)
|
|
216
218
|
_arguments "${_arguments_options[@]}" : \
|
|
217
219
|
'--root=[Project root (defaults to the current directory)]:ROOT:_files' \
|
|
218
|
-
'
|
|
219
|
-
'--
|
|
220
|
-
'--
|
|
221
|
-
'--
|
|
222
|
-
'
|
|
223
|
-
'--
|
|
220
|
+
'--from=[The folder the command writes (default _site)]:DIR:_default' \
|
|
221
|
+
'--runs=[How many builds to make and compare (default 3)]:RUNS:_default' \
|
|
222
|
+
'--commit=[Build this commit instead of the working tree]:REV:_default' \
|
|
223
|
+
'--to=[What to call the builds (default ref)]:NAME:_default' \
|
|
224
|
+
'*--link=[Link this folder of the site into each copy (repeatable)]:PATH:_files' \
|
|
225
|
+
'--patch=[Apply this patch to each copy before building]:FILE:_files' \
|
|
226
|
+
'--copy-installs[Copy the installs into each copy instead of linking them]' \
|
|
224
227
|
'-q[Print only warnings and errors]' \
|
|
225
228
|
'--quiet[Print only warnings and errors]' \
|
|
226
|
-
'-v[Also list the slowest images to encode]' \
|
|
227
|
-
'--verbose[Also list the slowest images to encode]' \
|
|
228
229
|
'-h[Print help]' \
|
|
229
230
|
'--help[Print help]' \
|
|
230
|
-
'
|
|
231
|
+
'*::COMMAND -- The old generator build command:_default' \
|
|
232
|
+
&& ret=0
|
|
233
|
+
;;
|
|
234
|
+
(scout)
|
|
235
|
+
_arguments "${_arguments_options[@]}" : \
|
|
236
|
+
'--from=[The generator the site is built with, when scout finds another]:FROM:_default' \
|
|
237
|
+
'--format=[text or json]:FORMAT:_default' \
|
|
238
|
+
'--write-draft[Write the new files of the draft; never overwrites a file]' \
|
|
239
|
+
'--patch=[Write the mechanical edits to FILE as a patch to review; nothing is applied]:PATCH:_files' \
|
|
240
|
+
'--compare[Also build with ssqch and compare with the reference build]' \
|
|
241
|
+
'--reference=[The reference build to compare with]:REFERENCE:_files' \
|
|
242
|
+
'-h[Print help]' \
|
|
243
|
+
'--help[Print help]' \
|
|
231
244
|
'::dir -- The site'\''s folder (default\: the current folder):_default' \
|
|
232
245
|
&& ret=0
|
|
233
246
|
;;
|
|
@@ -315,7 +328,7 @@ _arguments "${_arguments_options[@]}" : \
|
|
|
315
328
|
_arguments "${_arguments_options[@]}" : \
|
|
316
329
|
&& ret=0
|
|
317
330
|
;;
|
|
318
|
-
(
|
|
331
|
+
(scout)
|
|
319
332
|
_arguments "${_arguments_options[@]}" : \
|
|
320
333
|
&& ret=0
|
|
321
334
|
;;
|
|
@@ -352,7 +365,8 @@ _ssqch_commands() {
|
|
|
352
365
|
'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
|
|
353
366
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
354
367
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
355
|
-
'
|
|
368
|
+
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
369
|
+
'scout:Scout a site built with another generator\: what moving it to ssqch takes, and what remains during a move' \
|
|
356
370
|
'capabilities:Say what this binary supports\: template languages, modules, config options and optional features' \
|
|
357
371
|
'docs:Read the documentation for this version\: a command, config option, function or topic' \
|
|
358
372
|
'help:Print this message or the help of the given subcommand(s)' \
|
|
@@ -401,7 +415,8 @@ _ssqch__subcmd__help_commands() {
|
|
|
401
415
|
'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
|
|
402
416
|
'init:Create a starter site (config, layout, five posts, data and editor types)' \
|
|
403
417
|
'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
|
|
404
|
-
'
|
|
418
|
+
'baseline:Build the site with its old generator in fresh copies and compare the builds' \
|
|
419
|
+
'scout:Scout a site built with another generator\: what moving it to ssqch takes, and what remains during a move' \
|
|
405
420
|
'capabilities:Say what this binary supports\: template languages, modules, config options and optional features' \
|
|
406
421
|
'docs:Read the documentation for this version\: a command, config option, function or topic' \
|
|
407
422
|
'help:Print this message or the help of the given subcommand(s)' \
|
|
@@ -443,10 +458,10 @@ _ssqch__subcmd__help__subcmd__help_commands() {
|
|
|
443
458
|
local commands; commands=()
|
|
444
459
|
_describe -t commands 'ssqch help help commands' commands "$@"
|
|
445
460
|
}
|
|
446
|
-
(( $+functions[
|
|
447
|
-
|
|
461
|
+
(( $+functions[_ssqch__subcmd__help__subcmd__scout_commands] )) ||
|
|
462
|
+
_ssqch__subcmd__help__subcmd__scout_commands() {
|
|
448
463
|
local commands; commands=()
|
|
449
|
-
_describe -t commands 'ssqch help
|
|
464
|
+
_describe -t commands 'ssqch help scout commands' commands "$@"
|
|
450
465
|
}
|
|
451
466
|
(( $+functions[_ssqch__subcmd__help__subcmd__init_commands] )) ||
|
|
452
467
|
_ssqch__subcmd__help__subcmd__init_commands() {
|
|
@@ -473,10 +488,15 @@ _ssqch__subcmd__help__subcmd__types_commands() {
|
|
|
473
488
|
local commands; commands=()
|
|
474
489
|
_describe -t commands 'ssqch help types commands' commands "$@"
|
|
475
490
|
}
|
|
476
|
-
(( $+functions[
|
|
477
|
-
|
|
491
|
+
(( $+functions[_ssqch__subcmd__baseline_commands] )) ||
|
|
492
|
+
_ssqch__subcmd__baseline_commands() {
|
|
493
|
+
local commands; commands=()
|
|
494
|
+
_describe -t commands 'ssqch baseline commands' commands "$@"
|
|
495
|
+
}
|
|
496
|
+
(( $+functions[_ssqch__subcmd__scout_commands] )) ||
|
|
497
|
+
_ssqch__subcmd__scout_commands() {
|
|
478
498
|
local commands; commands=()
|
|
479
|
-
_describe -t commands 'ssqch
|
|
499
|
+
_describe -t commands 'ssqch scout commands' commands "$@"
|
|
480
500
|
}
|
|
481
501
|
(( $+functions[_ssqch__subcmd__init_commands] )) ||
|
|
482
502
|
_ssqch__subcmd__init_commands() {
|
package/bundled/docs/agents.md
CHANGED
|
@@ -68,3 +68,14 @@ ssqch serve --port 0 --ready-file .cache/ready.json &
|
|
|
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
70
|
The other commands with JSON are [`ssqch inspect --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
|
+
|
|
72
|
+
## Moving a site with an agent
|
|
73
|
+
|
|
74
|
+
Every move from another generator so far ran the same loop: build the old site, build the new one, compare, fix the biggest group of differences, repeat. It's a loop an agent can run, as long as each step has an answer it can read:
|
|
75
|
+
|
|
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
|
+
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
|
+
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.
|
|
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
|
+
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.
|