-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathgen.txt
1840 lines (1431 loc) · 75.3 KB
/
gen.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
NAME
ssc - static site checker
SYNOPSIS
ssc [...] directory
ssc -f config
ssc
DESCRIPTION
ssc (the Static Site Checker) is an opinionated HTML nit-picker,
intended for people, like its author, who hand code websites. It
doesn't just check static sites for broken links, dubious syntax, and
bad semantic data, it will actively complain about things that are
perfectly legal but rather untidy, like its author.
Except when serving CGI queries, it recursively scans the directory
seeking HTML & related files to analyse. It produces a list of errors,
warnings, and other hints of imperfection.
Scripts are ignored.
COMMAND LINE ONLY SWITCHES
These options are only available on the command line:
-a Ask the user to enter arguments, answer them;
ask and answer again, until a blank line is
entered. Arguments entered on the command line
(with -a) will be processed as normal. Certain
arguments entered during the argument answer
cycle will be ignored, including -a and thread
counts.
-A List switches read, then exit.
-f file Load a configuration from a file, which should
be in .INI file format. See CONFIGURATION FILE
FORMAT below. This should be an absolute path.
-F Load the configuration file .ssc/config in the
current directory.
-h Show a summary of switches, then exit.
--ontology.list List known schema versions, then exit.
-q Use a simple shell. The shell accepts the
following commands:
c configure: enter a series of command
line switches, one per line, then a
full stop on a line by itself
C clear the current configuration
h a summary of available commands
p print the current configuration
q quit
r run using the current configuration
-V Show version details, then exit.
--validation List extendable attribute types, then exit.
These types accept additional values on some
X/HTML attributes and CSS properties. It is
intended to allow checking of HTML etc. with
bespoke extensions.
COMMAND LINE AND CONFIGURATION FILES SWITCHES
These options are available on the command line (with dashes) and in
configuration files (without dashes). The short form single letter
alternative switches only work on the command line.
Most binary options, e.g. those without arguments below that turn on a
feature (which may be the default), have a corresponding "no-" switch
to turn it off. The "no-" is inserted after the dot, so, for example,
the contradiction to "--general.noh" would be "--general.no-noh". When
both are specified, perhaps in a configuration file and on the command
line, the "no-" switch always applies.
Corpus
Corpus switches control XML data for output to a local search engine.
--corpus.article Prefer the content of <ARTICLE> when gathering
corpus text.
--corpus.body Prefer the content of <BODY> when gathering
corpus text. This is the default.
--corpus.main Prefer the content of <MAIN> when gathering
corpus text.
--corpus.output file Dump XML corpus of site into file. This is
intended for use by a local search engine. If
none of --corpus.article, --corpus.body, or
--corpus.main are specified, the content of
<BODY> is used. If more than one are specified,
then the text collected depends on a page's
content. This is incompatible with
--shadow.update.
CSS
The CSS switches precisely control CSS interpretation. If you are
checking a site with a CSS version contemporary to the given HTML
version (see --html.version), you can ignore them. Otherwise, you
probably only need --css.version. The other switches allow you to
precisely specify the CSS modules presumed. Specific modules are
defined at w3.org.
--css.adjust X Use CSS Colour Adjustment level X, where X is 0
or 3.
--css.anchor X Use CSS Scrollbar Anchoring level X, where X is
0 or 3.
--css.animation X Use CSS Animation level X, where X is 0, 3 or
4.
--css.background X Use CSS Backgrounds and Borders level X, where
X is 0 or 3.
--css.box-align X Use CSS Box Alignment level X, where X is 0 or
3.
--css.box-model X Use CSS Box Model level X, where X is 0, 3 or
4.
--css.box-sizing X Use CSS Box Sizing level X, where X is 0, 3 or
4.
--css.cascade X Use CSS Cascading and Inheritance level X,
where X is 0, 3, 4, 5 or 6.
--css.colour X Use CSS Colour level X, where X is 0, 3, 4 or
5.
--css.compositing X Use CSS Compositing and Blending level X, where
X is 0 or 3.
--css.cond-rule X Use CSS Conditional Rules level X, where X is
0, 3, 4, or 5.
--css.contain X Use CSS Contain level X, where X is 0, 3, 4 or
5: see --css.version for gen.
--css.content X Use CSS Generated Content level X, where X is 0
or 3.
--css.cs X Use CSS Counter Style level X, where X is 0 or
3.
--css.custom X Use CSS Custom Properties for Cascading
Variables level X, where X is 0 or 3.
--css.device X Use CSS Device Adaption level X, where X is 0
or 3.
--css.display X Use CSS Display level X, where X is 0 or 3.
--css.ease X Use CSS Easing Functions level X, where X is 0
or 3.
--css.exclude X Use CSS Exclusions level X, where X is 0 or 3.
--css.extension ext Presume files with extension '.ext' are CSS
files.
--css.fbl X Use CSS Flexible Box Layout level X, where X is
0 or 3.
--css.filter X Use CSS Filter Effects level X, where X is 0 or
3.
--css.float X Use CSS Page Floats level X, where X is 0 or 3.
--css.font X Use CSS Fonts level X, where X is 0, 3, 4 or 5.
--css.frag X Use CSS Fragmentation level X, where X is 0, 3.
or 4
--css.grid X Use CSS Grid level X, where X is 0, 3 or 4: see
--css.version for gen.
--css.highlight X Use CSS Custom Highlights level X, where X is 0
or 3.
--css.image X Use CSS Images level X, where X is 0, 3 or 4.
--css.inline X Use CSS Inline Layout level X, where X is 0 or
3.
--css.line-grid X Use CSS Line Grid level X, where X is 0 or 3.
--css.list X Use CSS Lists and Counters level X, where X is
0 or 3.
--css.logic X Use CSS Logical Properties level X, where X is
0 or 3.
--css.marquee X Use CSS Marquee level X, where X is 0 or 3.
--css.masking X Use CSS Masking level X, where X is 0 or 3.
--css.media X Use CSS Media Queries level X, where X is 0, 3,
4 or 5.
--css.mobile Test against the CSS Mobile Profile.
--css.multi-column X Use CSS Multi-Column level X, where X is 0 or
3.
--css.namespace X Use CSS Namespaces level X, where X is 0 or 3.
--css.nes X Use CSS Non-Element Selectors level X, where X
is 0 or 3.
--css.overflow X Use CSS Overflow level X, where X is 0, 3 or 4.
--css.overscroll X Use CSS Overscroll Behaviour level X, where X
is 0 or 3.
--css.page X Use CSS Paged Media level X, where X is 0 or 3.
--css.position X Use CSS Positions level X, where X is 0 or 3.
--css.present X Use CSS Presentation Levels level X, where X is
0 or 3.
--css.print Test against the CSS Print Profile.
--css.region X Use CSS Regions level X, where X is 0 or 3.
--css.rhythm X Use CSS Rhythmic Sizing level X, where X is 0
or 3.
--css.round X Use CSS Round Display level X, where X is 0 or
3.
--css.ruby X Use CSS Ruby Annotations level X, where X is 0
or 3.
--css.scope X Use CSS Scoping level X, where X is 0 or 3.
--css.scrollbar X Use CSS Scrollbar Style level X, where X is 0
or 3.
--css.sda X Use CSS Scroll-Driven Animations Style level X,
where X is 0 or 3.
--css.selector X Use CSS Selectors level X, where X is 0, 3 or
4.
--css.shadow X Use CSS Shadow Parts level X, where X is 0 or
3.
--css.shape X Use CSS Shapes level X, where X is 0, 3 or 4.
--css.snap X Use CSS Scroll Snap level X, where X is 0 or 3.
--css.spatial X Use CSS Spatial Navigation level X, where X is
0 or 3.
--css.speech X Use CSS Speech level X, where X is 0 or 3.
--css.style X Use CSS Style level X, where X is 0 or 3.
--css.syntax X Use CSS Syntex level X, where X is 0 or 3
--css.table X Use CSS Tables level X, where X is 0 or 3 (this
is an experimental spec, likely to change).
--css.text X Use CSS Text level X, where X is 0, 3 or 4.
--css.text-dec X Use CSS Text Decoration level X, where X is 0,
3 or 4.
--css.tv Test against the CSS TV Profile.
--css.transform X Use CSS Transforms level X, where X is 0, 3 or
4: see --css.version for gen.
--css.transition X Use CSS Transitions level X, where X is 0 or 3.
--css.ui X Use CSS Basic User Interface level X, where X
is 0, 3 or 4.
--css.value X Use CSS Values and Units level X, where X is 0,
3 or 4.
--css.verify Verify CSS files (replaces --general.css).
--css.version X Presume version X of CSS, where X is one of:
1 CSS 1.0
2.0 CSS 2.0
2.1 CSS 2.1
2.2 CSS 2.2 (Feb 2022 draft)
3 all CSS level 3 so far
4 all CSS level 4 so far
5 all CSS level 5 so far
6 all CSS level 6 so far
2007
2010
2015
2015+
2015++
2017
2017+
2017++
2018
2018+
2018++
2020
2020+
2020++
2021
2021+
2021++
2022
2022+
2022++
2023
2023+
2023++
2024
2024+
2024++
2024+++
The years are CSS snapshots, whether the year
itself for stable modules, with + for wobbly
modules, ++ for wibbly-wobbly modules, and +++
for weally-wibbly-wobbly modules, as per the
corresponding W3 CSS snapshots (the terminology
in those snapshots is inconsistent, hence the
use of alternative scientific terminology).
For levels 3, 4, 5 and 6, note that extensions
that are part of neither CSS 1 nor CSS 2.x
specifications are numbered three and upwards
in ssc, for internal consistency. If you wish
to use an extension named ... level 1, that is
not part of CSS 1, specify 3. Similarly, for
those named level 2 that are not part of any
CSS 2 specification, etc..
--css.view X Use CSS View Transitions level X, where X is 0
or 3.
--css.wc X Use CSS Will Change level X, where X is 0 or 3.
--css.writing X Use CSS Writing Mode level X, where X is 0, 3
or 4.
General switches
This are switches that don't really belong in any other section.
--general.class Nitpick class values.
--general.classic Report all classes used, not just those in
CSS files.
--general.cgi Check environment variables for snippets of
-W HTML. SSC expects environment variables as
produced by OpenBSD's native httpd, produced
using <FORM METHOD=GET ...>. Do NOT let ssc
anywhere near untrusted data. Ignores many
options such as shadowing.
--general.datapath dir Look for any configuration, caches, and other
-C dir useful files, in this directory.
--general.defthrd N If --general.thread is not given, then set the
-Y N number of threads to N. The default is 1. If 0
is specified, then select a number of threads
not entirely inappropriate for the hardware.
--general.ede Exclude certain platform specific files, such
as .DS_Store under MacOS.
--general.exclude xxx Ignore all paths containing xxx. May be
repeated. Case independent under Windows only.
.DS_Store is always excluded under darwin.
--general.file XXX File for persistent data. See also
--general.datapath. Default extension: .ndx.
--general.maxfilesize n Do not process HTML source files that exceed n
bytes in size (default: 4M). Specify 0 for
unlimited, although be warned that ssc is
stunningly stupid in such circumstances and may
even attempt to load files bigger than
available memory.
--general.output file Output to the specified file. If this switch is
-o file not used, standard output is used.
--general.progress Dump progress information to standard output.
-D This can interfere with formatted output.
--general.rdfa Check RDFa attributes (version 1.1.3). This is
intended for ontology testing only, so is
incomplete.
--general.rpt Report CSS files that are opened.
--general.spec Reset the values of most switches to false.
-j
--general.test Output data in automated test format. Used by
-T ssc-test. Not generally useful. Documented so
you can avoid using it!
--general.thread N Use N threads when running. Defaults to 1. If
-y N 0 is given, a value not entirely inappropriate
for the hardware is used. Too high a value can
cause problems. See also --general.defthrd.
--general.username XXX The name of the account being used to run SSC.
If this is not specified, SSC gets the name
the operating system.
--general.vcs Excludes, as per --general.exclude, files and
directories called:
.bazaar
.bk
CVS
.cvsignore
_darcs
.fslckout
.git
.gitattributes
.gitignore
.gitmodules
.pijul
RCS
SCCS
.svn
HTML
The only HTML switch you are likely to need is --html.version, and then
only if you want to check a site that is not contemporary to the build
of ssc. The remaining switches allow you to precisely control analysis
of older sites.
--html.custom EL Define a custom element <EL> for verifying the
IS attribute. May be repeated.
--html.force If <!DOCTYPE...> is missing, force presumption
of --html.version value, not HTML 1/tags
--html.ie Don't mention certain Internet Explorer
'features'.
--html.ignore EL Ignore attributes and content of the element
<EL>. May be repeated.
--html.lang LA If an X/HTML file does not have a language /
dialect specified (e.g. "en" for generic
English, "en-IE" for Irish English, "lb-LU"
for Luxembourgish, "ma" for Marain, etc.),
default to 'LA'. If not given, the default is
your system default, or, if none, then "en-US".
--html.rel Only mention <LINK> REL values, found neither
in the living standard nor at microformats.org,
in debug output.
--html.rfc1867 Ignore the RFC 1867 (INPUT=FILE) extension when
processing HTML 2.0
--html.rfc1942 Ignore the RFC 1942 (tables) extension when
processing HTML 2.0.
--html.rfc1980 Ignore the RFC 1980 (client side image maps)
extension when processing HTML 2.0.
--html.rfc2070 Ignore the RFC 2070 (internationalisation)
extension when processing HTML 2.0.
--html.ruby Accept Ruby Markup Extension (draft, late April
2024) for HTML from May 2024 onwards.
--html.safari Don't mention certain early Safari 'features'.
--html.sloven Ignore perfectly legal yet inefficient, indeed
thoroughly slovenly, HTML, such as being far
too lazy to bother to get round to closing
elements.
--html.tags When an HTML file is loaded that contains no
DOCTYPE, ssc normally presumes HTML 1. This
switch tells it to presume the file conforms
to an earlier HTML Tags specification (the one
at CERN). This is overridden by --html.version.
--html.timefmt X Set the SSI timefmt to X.
--html.title n If <TITLE> text is longer than n characters,
-z n say so. This applies to text enclosed by a
<TITLE> element under <HEAD>, not the value of
TITLE attributes.
--html.version X If no doctype (or xml header) is specified,
presume version X of HTML. X can be:
tags HTML tags (1991, informal)
1 HTML 1.0 (Jun 1993 draft)
1.0 HTML 1.0 (Jun 1993 draft)
+ HTML Plus (Nov 1993 draft)
2 HTML 2.0
2.0 HTML 2.0
3 HTML 3.2
3.0 HTML 3.0 (Mar 1995 draft)
3.2 HTML 3.2
4 HTML 4.01
4.0 HTML 4.0
4.1 HTML 4.01
4.2 XHTML 1.0
4.3 XHTML 1.1 core
4.4 XHTML 2.0 (Dec 2010 draft)
5 recent WhatWG HTML 5
5.0 W3 HTML 5.0
5.1 W3 HTML 5.1
5.2 W3 HTML 5.2
5.3 W3 HTML 5.3 (Oct 2018 draft)
2005/1/1 WhatWG WebApps draft (Jan 2005)
... (halfly)
2007/1/1 WhatWG WebApps draft (Jan 2007)
2007/7/1 WhatWG HTML 5 (Jul 2007)
... (halfly)
2021/1/1 WhatWG HTML 5 (Jan 2021)
... (quarterly)
2025/1/1 WhatWG HTML 5 (Jan 2025)
XHTML 1.0 XHTML 1.0
XHTML 1.1 XHTML 1.1 core
XHTML 2.0 (Dec 2010 draft)
XHTML 5.x XHTML corresponding to
equivalent W3 HTML
Although you can specify exact dates for
versions of the WhatWG HTML 5 living standard,
currently only broad versions published in
January and July are supported (quarterly
from 2021).
Certain versions of HTML offer variants, such
as loose and strict definitions. ssc picks
those up from the <!DOCTYPE ...> in the HTML
file, if any, and then carefully ignores them.
Validation of XHTML is even less strict.
Just to remind you, there are no guarantees of
accuracy (or inaccuracy).
Copies of the appropriate standards can be
found online. A copy of the copies referenced
during ssc's development can be found at
https://ssc.lu/.
--html.wx The site is intended for use with wxWidgets'
HTML engine.
Json-LD switches
Please note this is an incomplete validation. It was written to
enable testing of certain ontologies.
--jsonld.extension x Files with extension x are JSON-LD files.
The default is 'jld'. May be repeated
--jsonld.ontology x:y Ontology symbol X refers to ontology y. For
example, sc:https://schema.org/ to use sc to
represent schema in the JSON-LD files. Omitting
':y' works when using a standard shortening,
such as the usual 'schema' for schema.org.
The switch also accepts 'all' for all
ontologies known to ssc, and 'standard' for a
common set of ontologies. May be repeated.
--jsonld.pretty When outputting JSON-LD, do so prettily.
--jsonld.verify Verify JSON-LD files.
--jsonld.version v Adhere to this version of JSON-LD (v can be
'1.0' or '1.1'), default '1.0'.
Link switches
If you want to check links on the site, you'll find these switches
useful, particularly --link.external. --link.check is a must, it spots
broken links within the site.
--link.301 Normally, when ssc checks external links
-3 (--link.external), it does not report http
forwarding errors 301 and 308. Use this switch
to have it do so.
--link.check Check internal links, e.g. those within the
-l website being analysed.
--link.example Report links to faux domains, as defined by RFC
2606 (note ssc also reports links to
example.edu, example.gov & example.mil).
--link.external Check external links, e.g. those not on the
-e site being checked. Note that ssc will NOT
check RFC 2606 links, such as example.com (see
--link.example).
--link.forward Report HTTP forwarding errors encountered when
checking external links (e.g. 301 and 308)
--link.ignore DOMAIN When checking external links, ignore this
domain. May be repeated.
--link.local Report links to local domains, such as domains
ending in .lan, .home, .corp, and others.
--link.once Only report each broken external link once. If,
-O for example, the site has a number of references
to a page that does not exist, ssc will only
report the first instance of the broken link.
Note that, even if it reports every occurrence
of the link, it will only check it the first
time it's encountered (requires
--link.external).
--link.pretend FILE Pretend links containing xxx exist. May be
repeated.
--link.report DOMAIN Report links to domain and its descendents. May
be repeated.
--link.required Z,Y,X,E,F,T,D A link to URL Z is required for lang Y
(default: all) on X pages (can be a page name,
ALL, FRONT, INDEX, default ALL), as a child of
element E (default BODY), from X/HTML version
F to X/HTML version T (default: all versions),
called D. All values are optional except Z.
--link.revoke Do not check whether links' https certificates
-r have been revoked (requires --link.external).
--link.special Report links to special domains, such as domains
ending in .alt, .onion, .yu, and others.
--link.xlink Check crosslink IDs on the site being analysed.
-X For example, if a link goes to /index.html#id,
then, when this switch is set, ssc will verify
that the id exists and that it is not hidden.
MathML switches
These switches are useful when you have some MathML which is not
contemporary to the corresponding HTML.
--math.version N Presume version N of MathML (1, 2, 3 pr 4). The
following versions are supported:
0 based on the HTML version
1 MathML 1
2 MathML 2
3 MathML 3
4.20 MathML 4 2020 draft
4 MathML 4 2022 draft
core MathML 4 core (May 2022 draft)
Microformat switches
These switches are useful for checking andor outputting any microformat
data found.
--microformat.export Export microformat data encountered in JSON
format. This option will write files in the
same directory as the source, with the
extension .json.
--microformat.pretty Prettify the export file (see boost json for
details).
--microformat.verify Verify Microformats data in class and rel
-M attributes (see https://microformats.org/).
--microformat.version x Presume microformats version x. The following
values are currently accepted:
1 microformats version 1 only
2 microformats version 2 only
3 both microformats versions 1 and 2
Nits
Nits are the output of ssc, the static site NITpicker. You will need
these switches if you want to hide certain nits, output lots of extra
gen, etc..
--nits.abhorrent n redefine nit n as an abhorrence; may be
repeated (the value of n can be determined
using --nits.nids below).
--nits.catastrophe n redefine nit n as a catastrophe; may be
repeated (the value of n can be determined
using --nits.nids below).
--nits.comment n Redefine nit n as a comment; may be repeated
(the value of n can be determined using
--nits.nids).
--nits.debug n Redefine nit n as a debug message; may be
repeated (the value of n can be determined
using --nits.nids).
--nits.error n Redefine nit n as an error; may be repeated
(the value of n can be determined using
--nits.nids).
--nits.errorexit x If nits of the specified category or worse are
-E generated, then, on exit, return an error code.
Values are: 'catastrophe', 'error' (the
default), 'warning', 'info', or 'comment'.
--nits.expand Expand text content of certain nits.
--nits.extra Report additional nits.
--nits.info n Redefine nit n as information; may be repeated
(the value of n can be determined using
--nits.nids).
--nits.nids Output nit ids, which can be used to redefine
nits.
--nits.quote X Specify quote style when using nit.format. X
can be 'text' or 'html'.
--nits.root By default, seek nit output template files in
the website root.
--nits.silence n Silence nit n; may be repeated (the value of n
can be determined using --nits.nids).
--nits.unique Do not output repeated nits, even if they may
contain additional information.
--nits.verbose x Output nits to the specified verbosity:
-v 'catastrophe', 'abhorrent', 'error', 'warning',
'info' (the default), 'comment', or '0' for
silence. Additional values are available when
debugging. Each level includes its preceding
level, so, for example, 'warning' will also
output 'catastrophe', 'abhorrent', and 'error'
nits.
--nits.warning n Redefine nit n as a warning; may be repeated
(the value of n can be determined using
--nits.nids).
--nits.watch Output debug nits (intended for automation).
Ontology switches
If you are interested in checking andor hoovering ontology data, you
may find these switches useful. Note that ssc only knows about certain
ontologies (see --ontology.list).
--ontology.export Export ontologies encountered. This data is
exported in JSON format (not JSON-LD).
--ontology.pretty Prettify the export file (see boost json for
details).
--ontology.root DIR When exporting ontologies with
--ontology.export, write files into the
directory DIR. ssc will create the directory
tree structure as appropriate.
--ontology.verify Check ontology found in WhatWG living standard
-m microdata attributes (itemprop, itemtype,
etc.).
--ontology.virtual v=d When exporting ontologies using
--ontology.export, export the contents of
virtual directory 'v' to 'd'. 'v' must match a
directory identified with --site.virtual. For
example:
--ontology.virtual virtual=X:\virtual.
--ontology.ONT X.Y Presume version X.Y of ontology ONT. For
example:
--ontology.xsd 1.1
defaults usage of XSD to version 1.1. This
versioning applies to RDFa, microdata, and
microformats (using class) analysis. If .Y is
omitted, .0 is presumed. X must be present.
Unspecified defaults are derived from the HTML
version. For a list of possible values, use
--ontology.list.
At the time of writing, the following ontology
versions can be verified. Note that single
version ontologies cannot have their version
changed:
adms 1.0,2.0
article 12,14,18,22
as 1.0,2.0
basic 1.0-1.3,2.1,3.0 (see below)
bfo 2.0,2020 (see below)
bibo 1.3
biro 1.1
book 12,14,18,22
cc 1.0
cito 2.8
content 1.0
cr 0.2-1.1 (see below)
crs 1.0 (see below)
csvw 1.0
ctag 1.0
daq 1.0
ddi 1.0
dbp 1.0
dbp-owl 1.0
dbr 1.0
dc11 1.0,1.1
dcam 1.0
dcat 1.0,2.0
dcmi 1.0
dcterms 1.0,1.1
ddi 1.0
doap 1.0
dpv* 0.1-2.1 (see below)
dqv 1.0
describedby 1.0
duv 1.0
earl 1.0
event 1.0
exif 1.0-3.0 (see below)
exifex 2.21-3.0 (see below)
foaf 0.1-0.99
frbr_core 1.0
gr 1.0
grddl 1.0
gs1 1.1-1.5
ical 1.0
icaltzd 1.0
jsonld 1.0,1.1
ldp 1.0
license 1.0
locn 1.0
ma 1.0
mf 1.0-2.255
music 12,14,18,22
oa 1.0
odrl 1.0
og 10,12,14,18,22 (see below)
org 1.0
owl 1.0,2.0
pam 2.0 (see below)
pcm 3.1 (see below)
pcmm 3.0 (see below)
pcv 1.0(see below)
pdf 1.0 (see below)
photoshop 1.0 (see below)
pim 1.0-3.0 (see below)
pmi 3.0 (see below)
poetry 1.0,1.1
prism 1.0-3.0 (see below)
prism-ad 3.0 (see below)
prl 1.0-2.0 (see below)
prm 3.0 (see below)
prs 3.1 (see below)
profile 12,14,18,22
prov 1.0
psv 1.0 (see below)
ptr 1.0
pur 2.1-3.0 (see below)
qb 1.0
rai 1.0.3-1.1 (see below)
rdf 1.0-1.3
rdfa 1.0-1.3
rdfg 1.0
rdfs 1.0
rev 1.0
rif 1.0
role 1.0
rr 1.0
schema.org 0.10-29 (see below)
sd 1.0
sioc 1.0
sioc_s 1.0
sioc_t 1.0
skos 1.0
skosxl 1.0
sosa 1.0
ssn 1.0
stdim 1.0 (see below)
stevt 1.0 (see below)
stfnt 1.0 (see below)
stjob 1.0 (see below)
stref 1.0 (see below)
stver 1.0 (see below)
taxo 1.0
tiff 6.0
time 1.0
v 1.0
vann 1.0,1.1
vcard 1,2,3,4 (see below)
video 12,14,18,22
void 1.0
wdr 1.0
wdrs 1.0
website 12,14,18,22
wwg 1.0
xhv 1.0
xml 1.0
xmp 1.0 (see below)
xmpdm 1.0 (see below)
xmpg 1.0 (see below)
xmpgimg 1.0 (see below)
xmpidq 1.0 (see below)
xmpmm 1.0 (see below)
xmprights 1.0 (see below)
xmptpg 1.0 (see below)
xsd 1.0,1.1
The various Adobe ontologies (crs, pdf,
photoshop, stdim, stevt, stfnt, stjob, stref,
stver, smp, xmpdm, xmpg, xmpgimg, xmpidq,
xmpmm, xmprights, xmptpg) have only been
partially applied. They do not seem to have
been designed for microdata, hence the partial
implementation: the goal is to enable hoovering
to JSON.
BFO (Basic Format Ontology) versions should be
specified as follows:
Use For
2.0 2.0
2.2 2020
BFO 2020 uses OBO's machine code style
identifiers. Given the history of computing
science, as a convenience for users, and with
my experience of both devops and maintaining
code, identifiers following the standard
ontology naming convention are also accepted.
Since this is unofficial, both standard English
and American dialect spellings are processed.
The croissant (cr and rai) ontologies follow
this version scheme:
For Use
0.0.2 0.2 (cr only)
0.0.3 0.3 (cr only)
0.0.4 0.4 (cr only)
0.0.6 0.6 (cr only)
0.8 0.8 (cr only)
1.0 1.0 (cr only)
1.0.1 1.1 (cr only)
1.0.2 1.2 (cr only)
1.0.3 1.3 (cr and rai)
1.0.4 1.4 (cr and rai)
1.0.5 1.5 (cr and rai)
1.0.6 1.6 (cr and rai)
1.0.7 1.7 (cr and rai)
1.0.8 1.8 (cr and rai)
1.0.9 1.9 (cr and rai)
1.0.10 1.10 (cr and rai)
1.0.11 1.11 (cr and rai)
1.0.12 1.12 (cr and rai)
1.1 1.100 (cr and rai)
The data privacy family of ontologies follow
this versioning scheme:
Use For
0.10 0.1
0.20 0.2
0.30 0.3
0.40 0.4.0
0.41 0.4.1
0.42 0.4.2
0.50 0.5
0.60 0.6
0.70 0.7
0.80 0.8.0
0.81 0.8.1
0.82 0.8.2
0.90 0.9
1.0 1
2.0 2.0
2.1 2.1
The data privacy ontology versions:
ai 2.0,2.1
dpv 0.1-2.1
eu-aiact 2.0,2.1
eu-dga 2.0,2.1
eu-ehds 2.1
eu-gdpr 2.0,2.1
eu-nis2 2.0,2.1
eu-rights 2.0,2.1