jekyll-open-sdg-plugins 1.1.0 → 1.2.0.pre.beta5

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1198 @@
1
+ {
2
+ "type": "object",
3
+ "title": "Open SDG site configuration",
4
+ "description": "This form will produce the site configuration for your Open SDG implementation.",
5
+ "properties": {
6
+ "accessible_charts": {
7
+ "title": "Accessible charts",
8
+ "type": "boolean",
9
+ "description": "This setting can be set to `true` to enable chart functionality that is intended to increase accessibility by adding support for screenreaders and keyboard navigation.",
10
+ "format": "checkbox",
11
+ "links": [
12
+ {
13
+ "rel": "More information on the accessible charts setting",
14
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#accessible_charts"
15
+ }
16
+ ]
17
+ },
18
+ "accessible_tabs": {
19
+ "title": "Accessible tabs",
20
+ "type": "boolean",
21
+ "description": "This setting can be set to `true` to enable tab functionality that is compliant with the WAI-ARIA best practices. This adds improved keyboard navigation of the tabs.",
22
+ "format": "checkbox",
23
+ "links": [
24
+ {
25
+ "rel": "More information on the accessible tabs setting",
26
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#accessible_tabs"
27
+ }
28
+ ]
29
+ },
30
+ "analytics": {
31
+ "options": {"collapsed": true},
32
+ "type": "object",
33
+ "title": "Analytics",
34
+ "description": "If these settings are used, usage statistics will be sent to Google Analytics.",
35
+ "properties": {
36
+ "ga_prod": {
37
+ "type": "string",
38
+ "title": "Google Analytics tracking ID",
39
+ "description": "The tracking ID (UA code) for your property on Google Analytics."
40
+ }
41
+ },
42
+ "links": [
43
+ {
44
+ "rel": "More information on the analytics setting",
45
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#analytics"
46
+ }
47
+ ]
48
+ },
49
+ "breadcrumbs": {
50
+ "options": {"collapsed": true},
51
+ "type": "object",
52
+ "title": "Breadcrumbs",
53
+ "description": "This can contain breadcrumb settings for each of the supported collection types: goal, indicator, and post. Each should have a list of label/path objects.",
54
+ "properties": {
55
+ "goal": {
56
+ "options": {"collapsed": true},
57
+ "format": "table",
58
+ "type": "array",
59
+ "title": "Goal breadcrumbs",
60
+ "description": "The breadcrumb items for goal pages.",
61
+ "items": {
62
+ "$ref": "#/definitions/breadcrumb_item"
63
+ }
64
+ },
65
+ "indicator": {
66
+ "options": {"collapsed": true},
67
+ "format": "table",
68
+ "type": "array",
69
+ "title": "Indicator breadcrumbs",
70
+ "description": "The breadcrumb items for indicator pages. Note that there will automatically be a final item, which is a link to the goal that the indicator belongs to. You do not need to specify this, since it is done dynamically and automatically.",
71
+ "items": {
72
+ "$ref": "#/definitions/breadcrumb_item"
73
+ }
74
+ },
75
+ "post": {
76
+ "options": {"collapsed": true},
77
+ "format": "table",
78
+ "type": "array",
79
+ "title": "Post breadcrumbs",
80
+ "description": "The breadcrumb items for post pages.",
81
+ "items": {
82
+ "$ref": "#/definitions/breadcrumb_item"
83
+ }
84
+ }
85
+ },
86
+ "links": [
87
+ {
88
+ "rel": "More information on the breadcrumbs setting",
89
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#breadcrumbs"
90
+ }
91
+ ]
92
+ },
93
+ "country": {
94
+ "options": {"collapsed": true},
95
+ "type": "object",
96
+ "title": "Country information",
97
+ "description": "Information about your country (or region, locality, etc.)",
98
+ "properties": {
99
+ "name": {
100
+ "type": "string",
101
+ "title": "Name",
102
+ "description": "The name of your country/region/locality/etc.",
103
+ "minLength": 1
104
+ },
105
+ "adjective": {
106
+ "type": "string",
107
+ "title": "Adjective",
108
+ "description": "Adjective form of your country/region/locality/etc.",
109
+ "minLength": 1
110
+ }
111
+ },
112
+ "links": [
113
+ {
114
+ "rel": "More information on the country setting",
115
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#country"
116
+ }
117
+ ]
118
+ },
119
+ "create_config_forms": {
120
+ "options": {"collapsed": true},
121
+ "type": "object",
122
+ "title": "Create configuration forms",
123
+ "description": "This setting can be used to automatically create the configuration form pages.",
124
+ "properties": {
125
+ "layout": {
126
+ "type": "string",
127
+ "title": "Layout",
128
+ "enum": [
129
+ "",
130
+ "config-builder"
131
+ ],
132
+ "options": {
133
+ "enum_titles": [
134
+ "Do not automatically create config forms",
135
+ "config-builder"
136
+ ]
137
+ },
138
+ "description": "The layout to use for the configuration form pages."
139
+ }
140
+ },
141
+ "links": [
142
+ {
143
+ "rel": "More information on the create config forms setting",
144
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#create_config_forms"
145
+ }
146
+ ]
147
+ },
148
+ "create_goals": {
149
+ "options": {"collapsed": true},
150
+ "type": "object",
151
+ "title": "Create goals",
152
+ "description": "This setting can be used to automatically create the goal pages.",
153
+ "properties": {
154
+ "layout": {
155
+ "type": "string",
156
+ "title": "Layout",
157
+ "enum": [
158
+ "",
159
+ "goal",
160
+ "goal-by-target",
161
+ "goal-by-target-vertical"
162
+ ],
163
+ "options": {
164
+ "enum_titles": [
165
+ "Do not automatically create goals",
166
+ "goal",
167
+ "goal-by-target",
168
+ "goal-by-target-vertical"
169
+ ]
170
+ },
171
+ "description": "The layout to use for the goal pages."
172
+ }
173
+ },
174
+ "links": [
175
+ {
176
+ "rel": "More information on the create goals setting",
177
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#create_goals"
178
+ }
179
+ ]
180
+ },
181
+ "create_indicators": {
182
+ "options": {"collapsed": true},
183
+ "type": "object",
184
+ "title": "Create indicators",
185
+ "description": "This setting can be used to automatically create the indicator pages.",
186
+ "properties": {
187
+ "layout": {
188
+ "type": "string",
189
+ "title": "Layout",
190
+ "enum": [
191
+ "",
192
+ "indicator"
193
+ ],
194
+ "options": {
195
+ "enum_titles": [
196
+ "Do not automatically create indicators",
197
+ "indicator"
198
+ ]
199
+ },
200
+ "description": "The layout to use for the indicator pages."
201
+ }
202
+ },
203
+ "links": [
204
+ {
205
+ "rel": "More information on the create indicators setting",
206
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#create_indicators"
207
+ }
208
+ ]
209
+ },
210
+ "create_pages": {
211
+ "options": {"collapsed": true},
212
+ "format": "table",
213
+ "type": "array",
214
+ "title": "Create pages",
215
+ "description": "This setting can be used to automatically create the pages.",
216
+ "items": {
217
+ "type": "object",
218
+ "title": "Page",
219
+ "properties": {
220
+ "filename": {
221
+ "type": "string",
222
+ "title": "Filename",
223
+ "description": "The filename for the page - usually 'index.html'."
224
+ },
225
+ "folder": {
226
+ "type": "string",
227
+ "minLength": 1,
228
+ "title": "Folder",
229
+ "description": "The folder path for the page."
230
+ },
231
+ "layout": {
232
+ "type": "string",
233
+ "minLength": 1,
234
+ "title": "Layout",
235
+ "description": "The layout to use for the page."
236
+ },
237
+ "title": {
238
+ "type": "string",
239
+ "title": "Title",
240
+ "description": "The page title for the page."
241
+ }
242
+ }
243
+ },
244
+ "links": [
245
+ {
246
+ "rel": "More information on the create pages setting",
247
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#create_pages"
248
+ }
249
+ ]
250
+ },
251
+ "custom_css": {
252
+ "options": {"collapsed": true},
253
+ "format": "table",
254
+ "type": "array",
255
+ "title": "Custom CSS files",
256
+ "description": "Deprecated: instead of using this, it is recommended to put custom CSS in a _sass/custom.scss file.",
257
+ "items": {
258
+ "type": "string",
259
+ "title": "Custom CSS file"
260
+ },
261
+ "links": [
262
+ {
263
+ "rel": "More information on the custom CSS setting",
264
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#custom_css"
265
+ }
266
+ ]
267
+ },
268
+ "custom_js": {
269
+ "options": {"collapsed": true},
270
+ "format": "table",
271
+ "type": "array",
272
+ "title": "Custom JavaScript files",
273
+ "description": "This setting can be used to load additional JavaScript files on each page.",
274
+ "items": {
275
+ "type": "string",
276
+ "title": "Custom JavaScript file"
277
+ },
278
+ "links": [
279
+ {
280
+ "rel": "More information on the custom JS setting",
281
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#custom_js"
282
+ }
283
+ ]
284
+ },
285
+ "data_edit_url": {
286
+ "type": "string",
287
+ "minLength": 1,
288
+ "title": "Data edit URL",
289
+ "description": "This setting controls the URL of the 'Edit Data' buttons that appear on the staging site's indicator pages.",
290
+ "links": [
291
+ {
292
+ "rel": "More information on the data edit URL setting",
293
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#data_edit_url"
294
+ }
295
+ ]
296
+ },
297
+ "date_formats": {
298
+ "options": {"collapsed": true},
299
+ "format": "table",
300
+ "type": "array",
301
+ "title": "Date formats",
302
+ "description": "This setting can be used to control date formats for use in the site, such as in the news/category/post layouts. Any number date formats can be entered, and each must have an arbitrary type, such as `standard`. Make sure that each type has a variant for each of your languages.",
303
+ "items": {
304
+ "type": "object",
305
+ "title": "Date format",
306
+ "properties": {
307
+ "type": {
308
+ "type": "string",
309
+ "minLength": 1,
310
+ "title": "Type",
311
+ "description": "Use `standard` for news/post dates."
312
+ },
313
+ "language": {
314
+ "type": "string",
315
+ "minLength": 1,
316
+ "title": "Language",
317
+ "description": "Language code the format applies to."
318
+ },
319
+ "format": {
320
+ "type": "string",
321
+ "minLength": 1,
322
+ "title": "Format",
323
+ "description": "Ruby DateTime date format."
324
+ }
325
+ }
326
+ },
327
+ "links": [
328
+ {
329
+ "rel": "More information on the date formats setting",
330
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#date_formats"
331
+ }
332
+ ]
333
+ },
334
+ "disclaimer": {
335
+ "options": {"collapsed": true},
336
+ "type": "object",
337
+ "title": "Disclaimer",
338
+ "description": "This setting controls the content of the disclaimer that appears at the top of each page.",
339
+ "properties": {
340
+ "phase": {
341
+ "type": "string",
342
+ "title": "Phase",
343
+ "description": "The development phase of your platform (alpha, beta, etc.)"
344
+ },
345
+ "message": {
346
+ "type": "string",
347
+ "title": "Message",
348
+ "description": "A short disclaimer message."
349
+ }
350
+ },
351
+ "links": [
352
+ {
353
+ "rel": "More information on the disclaimer setting",
354
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#disclaimer"
355
+ }
356
+ ]
357
+ },
358
+ "email_contacts": {
359
+ "options": {"collapsed": true},
360
+ "type": "object",
361
+ "title": "Email addresses",
362
+ "description": "Email addresses to publish on your platform.",
363
+ "properties": {
364
+ "questions": {
365
+ "type": "string",
366
+ "minLength": 1,
367
+ "format": "email",
368
+ "title": "Questions",
369
+ "description": "Inbox for questions about your platform."
370
+ },
371
+ "suggestions": {
372
+ "type": "string",
373
+ "minLength": 1,
374
+ "format": "email",
375
+ "title": "Suggestions",
376
+ "description": "Inbox for suggestions for your platform."
377
+ },
378
+ "functional": {
379
+ "type": "string",
380
+ "minLength": 1,
381
+ "format": "email",
382
+ "title": "Functional",
383
+ "description": "Inbox for bug reports for your platform."
384
+ }
385
+ },
386
+ "links": [
387
+ {
388
+ "rel": "More information on the email contacts setting",
389
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#email_contacts"
390
+ }
391
+ ]
392
+ },
393
+ "environment": {
394
+ "type": "string",
395
+ "minLength": 1,
396
+ "title": "Environment",
397
+ "description": "Which environment (staging or production) this configuration is for.",
398
+ "enum": ["staging", "production"],
399
+ "links": [
400
+ {
401
+ "rel": "More information on the environment setting",
402
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#environment"
403
+ }
404
+ ]
405
+ },
406
+ "footer_language_toggle": {
407
+ "type": "string",
408
+ "title": "Footer language toggle",
409
+ "description": "This setting controls the type of language toggle to be used in the footer.",
410
+ "enum": ["none", "dropdown", "links"],
411
+ "links": [
412
+ {
413
+ "rel": "More information on the footer language toggle setting",
414
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#footer_language_toggle"
415
+ }
416
+ ]
417
+ },
418
+ "footer_menu": {
419
+ "options": {"collapsed": true},
420
+ "format": "table",
421
+ "type": "array",
422
+ "title": "Footer menu",
423
+ "description": "The links to display in the footer menu.",
424
+ "items": {
425
+ "$ref": "#/definitions/menu_item"
426
+ },
427
+ "links": [
428
+ {
429
+ "rel": "More information on the footer menu setting",
430
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#footer_menu"
431
+ }
432
+ ]
433
+ },
434
+ "frontpage_cards": {
435
+ "options": {"collapsed": true},
436
+ "type": "array",
437
+ "title": "Frontpage cards",
438
+ "description": "This setting is only used in the frontpage-alt layout. It can display any number of 'cards' in 3-column rows, beneath the grid of goal tiles.",
439
+ "items": {
440
+ "type": "object",
441
+ "title": "Frontpage card",
442
+ "properties": {
443
+ "title": {
444
+ "type": "string",
445
+ "minLength": 1,
446
+ "title": "Title",
447
+ "description": "The card's title."
448
+ },
449
+ "content": {
450
+ "type": "string",
451
+ "title": "Content",
452
+ "description": "The card's content.",
453
+ "format": "markdown"
454
+ },
455
+ "include": {
456
+ "type": "string",
457
+ "title": "Include file",
458
+ "description": "A Jekyll include file to place inside the card."
459
+ },
460
+ "button_label": {
461
+ "type": "string",
462
+ "title": "Button label",
463
+ "description": "A label for a button to display at the bottom of the card."
464
+ },
465
+ "button_link": {
466
+ "type": "string",
467
+ "title": "Button link",
468
+ "description": "A path or URL for the card's button to link to."
469
+ },
470
+ "rule_color": {
471
+ "type": "string",
472
+ "title": "Rule color",
473
+ "description": "The color of the horizontal line appearing above the card."
474
+ }
475
+ }
476
+ },
477
+ "links": [
478
+ {
479
+ "rel": "More information on the frontpage cards setting",
480
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#frontpage_cards"
481
+ }
482
+ ]
483
+ },
484
+ "frontpage_goals_grid": {
485
+ "options": {"collapsed": true},
486
+ "type": "object",
487
+ "title": "Frontpage goals grid",
488
+ "description": "This setting is only used in the frontpage-alt layout. It can display a title and description above the grid of goal tiles.",
489
+ "$ref": "#/definitions/title_and_description",
490
+ "links": [
491
+ {
492
+ "rel": "More information on the frontpage goals grid setting",
493
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#frontpage_goals_grid"
494
+ }
495
+ ]
496
+ },
497
+ "frontpage_heading": {
498
+ "type": "string",
499
+ "title": "Frontpage heading",
500
+ "description": "This setting can control the heading that appears on the front page. This setting is only used in the frontpage layout.",
501
+ "links": [
502
+ {
503
+ "rel": "More information on the frontpage heading setting",
504
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#frontpage_heading"
505
+ }
506
+ ]
507
+ },
508
+ "frontpage_instructions": {
509
+ "type": "string",
510
+ "title": "Frontpage instructions",
511
+ "description": "This setting can control the instructions that appear on the front page. This setting is only used in the frontpage layout.",
512
+ "links": [
513
+ {
514
+ "rel": "More information on the frontpage instructions setting",
515
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#frontpage_instructions"
516
+ }
517
+ ]
518
+ },
519
+ "frontpage_introduction_banner": {
520
+ "options": {"collapsed": true},
521
+ "type": "object",
522
+ "title": "Frontpage introduction banner",
523
+ "description": "This setting is only used in the frontpage-alt layout. It can display a title and description in a banner at the top of the frontpage.",
524
+ "$ref": "#/definitions/title_and_description",
525
+ "links": [
526
+ {
527
+ "rel": "More information on the frontpage introduction banner setting",
528
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#frontpage_introduction_banner"
529
+ }
530
+ ]
531
+ },
532
+ "goal_image_base": {
533
+ "type": "string",
534
+ "minLength": 1,
535
+ "title": "Goal image base URL",
536
+ "description": "This setting controls the base URL for downloading the imagery for the goals.",
537
+ "links": [
538
+ {
539
+ "rel": "More information on the goal image base setting",
540
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#goal_image_base"
541
+ }
542
+ ]
543
+ },
544
+ "goal_image_extension": {
545
+ "type": "string",
546
+ "title": "Goal image extension",
547
+ "description": "This setting controls the type of file (the file extension) that will be used for the goal images.",
548
+ "links": [
549
+ {
550
+ "rel": "More information on the goal image extension setting",
551
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#goal_image_extension"
552
+ }
553
+ ]
554
+ },
555
+ "goals_page": {
556
+ "options": {"collapsed": true},
557
+ "type": "object",
558
+ "title": "Goals page",
559
+ "description": "This setting is used in the 'goals' layout. It can display a title and description above the grid of goal tiles.",
560
+ "$ref": "#/definitions/title_and_description",
561
+ "links": [
562
+ {
563
+ "rel": "More information on the goals page setting",
564
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#goals_page"
565
+ }
566
+ ]
567
+ },
568
+ "graph_color_set": {
569
+ "type": "string",
570
+ "title": "Graph color set",
571
+ "description": "This setting can be used to customize the color set used in the charts.",
572
+ "examples": [],
573
+ "enum": ["default", "sdg", "goal", "custom"],
574
+ "links": [
575
+ {
576
+ "rel": "More information on the graph color set setting",
577
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#graph_color_set"
578
+ }
579
+ ]
580
+ },
581
+ "graph_color_list": {
582
+ "options": {"collapsed": true},
583
+ "format": "table",
584
+ "type": "array",
585
+ "title": "Graph color list",
586
+ "description": "This setting can be used to define a set of colors to be used in the charts. This is only used when graph_color_set is 'custom'.",
587
+ "items": {
588
+ "type": "string",
589
+ "format": "color",
590
+ "title": "Color",
591
+ "description": "Hexadecimal color code"
592
+ },
593
+ "links": [
594
+ {
595
+ "rel": "More information on the graph color list setting",
596
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#graph_color_list"
597
+ }
598
+ ]
599
+ },
600
+ "graph_color_number": {
601
+ "title": "Graph color number",
602
+ "type": "integer",
603
+ "description": "This setting can be used to limit the length of the list of colors selected via graph_color_set.",
604
+ "links": [
605
+ {
606
+ "rel": "More information on the graph color number setting",
607
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#graph_color_number"
608
+ }
609
+ ]
610
+ },
611
+ "header_language_toggle": {
612
+ "type": "string",
613
+ "title": "Header language toggle",
614
+ "description": "This setting controls the type of language toggle to be used in the header.",
615
+ "enum": ["none", "dropdown", "links"],
616
+ "links": [
617
+ {
618
+ "rel": "More information on the header language toggle setting",
619
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#header_language_toggle"
620
+ }
621
+ ]
622
+ },
623
+ "hide_empty_metadata": {
624
+ "title": "Hide empty metadata",
625
+ "type": "boolean",
626
+ "description": "This setting can be used to hide any metadata fields that are empty.",
627
+ "format": "checkbox",
628
+ "links": [
629
+ {
630
+ "rel": "More information on the hide empty metadata setting",
631
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#hide_empty_metadata"
632
+ }
633
+ ]
634
+ },
635
+ "indicator_config_form": {
636
+ "options": {"collapsed": true},
637
+ "type": "object",
638
+ "title": "Indicator configuration form",
639
+ "description": "Configuration of the indicator configuration form.",
640
+ "$ref": "#/definitions/config_form_options"
641
+ },
642
+ "languages": {
643
+ "options": {"collapsed": true},
644
+ "format": "table",
645
+ "type": "array",
646
+ "minItems": 1,
647
+ "title": "Languages",
648
+ "description": "This setting controls the languages to be used on the site.",
649
+ "items": {
650
+ "type": "string",
651
+ "minLength": 1,
652
+ "title": "Language"
653
+ },
654
+ "links": [
655
+ {
656
+ "rel": "More information on the languages setting",
657
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#languages"
658
+ }
659
+ ]
660
+ },
661
+ "languages_public": {
662
+ "options": {"collapsed": true},
663
+ "format": "table",
664
+ "type": "array",
665
+ "title": "Language code overrides",
666
+ "description": "This setting can be used if you are not happy with any of the standard language codes.",
667
+ "items": {
668
+ "type": "object",
669
+ "title": "Language override",
670
+ "properties": {
671
+ "language": {
672
+ "type": "string",
673
+ "minLength": 1,
674
+ "title": "Language",
675
+ "description": "The (standard) language code that you would like to override."
676
+ },
677
+ "language_public": {
678
+ "type": "string",
679
+ "minLength": 1,
680
+ "title": "Language override",
681
+ "description": "The (non-standard) language code that you would like show the public instead."
682
+ }
683
+ }
684
+ },
685
+ "links": [
686
+ {
687
+ "rel": "More information on the language override setting",
688
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#languages_public"
689
+ }
690
+ ]
691
+ },
692
+ "map_layers": {
693
+ "options": {"collapsed": true},
694
+ "format": "table",
695
+ "type": "array",
696
+ "title": "Map layers",
697
+ "description": "Configure any number of layers to display on all indicator maps. A minimum of one layer is required to display maps.",
698
+ "items": {
699
+ "type": "object",
700
+ "title": "Map layer",
701
+ "properties": {
702
+ "subfolder": {
703
+ "type": "string",
704
+ "title": "Subfolder",
705
+ "description": "The subfolder under 'geojson' in the data repository holding the GeoJSON file for this layer."
706
+ },
707
+ "label": {
708
+ "type": "string",
709
+ "title": "Download button label",
710
+ "description": "The label to use in the 'Download GeoJSON' button for this layer."
711
+ },
712
+ "min_zoom": {
713
+ "type": "integer",
714
+ "title": "Minimum zoom",
715
+ "description": "This layer will only be visible when the map is zoomed to at least this number."
716
+ },
717
+ "max_zoom": {
718
+ "type": "integer",
719
+ "title": "Maximum zoom",
720
+ "description": "The layer will not be visible when the map is zoomed beyond this number."
721
+ },
722
+ "staticBorders": {
723
+ "type": "boolean",
724
+ "format": "checkbox",
725
+ "title": "Static borders",
726
+ "description": "Whether the borders on this layer should remain visible when the map is zoomed past the maximum."
727
+ }
728
+ }
729
+ },
730
+ "links": [
731
+ {
732
+ "rel": "More information on the map layers setting",
733
+ "href": "https://open-sdg.readthedocs.io/en/latest/maps/#map_layers"
734
+ }
735
+ ]
736
+ },
737
+ "map_options": {
738
+ "options": {"collapsed": true},
739
+ "type": "object",
740
+ "title": "Map options",
741
+ "description": "Site-wide configuration of map behavior and style.",
742
+ "properties": {
743
+ "minZoom": {
744
+ "title": "Minimum zoom",
745
+ "type": "integer",
746
+ "description": "The lowest amount of 'zoom' possible for users.",
747
+ "default": 5
748
+ },
749
+ "maxZoom": {
750
+ "title": "Maximum zoom",
751
+ "type": "integer",
752
+ "description": "The highest amount of 'zoom' possible for users.",
753
+ "default": 10
754
+ },
755
+ "tileURL": {
756
+ "title": "Tile URL",
757
+ "type": "string",
758
+ "format": "url",
759
+ "description": "If you would like the maps to show tile imagery, add the URL here."
760
+ },
761
+ "tileOptions": {
762
+ "title": "Tile options",
763
+ "type": "object",
764
+ "options": {"collapsed": true},
765
+ "description": "Additional options for map tile imagery.",
766
+ "properties": {
767
+ "id": {
768
+ "type": "string",
769
+ "title": "Tile ID"
770
+ },
771
+ "accessToken": {
772
+ "type": "string",
773
+ "title": "Access token"
774
+ },
775
+ "attribution": {
776
+ "type": "string",
777
+ "title": "Attribution"
778
+ }
779
+ }
780
+ },
781
+ "colorRange": {
782
+ "type": "string",
783
+ "title": "Color range",
784
+ "description": "The color range for the choropleth map.",
785
+ "default": "chroma.brewer.BuGn",
786
+ "links": [
787
+ {
788
+ "ref": "More information on the color range setting",
789
+ "href": "https://gka.github.io/chroma.js/#chroma-brewer"
790
+ }
791
+ ]
792
+ },
793
+ "noValueColor": {
794
+ "type": "string",
795
+ "format": "color",
796
+ "title": "No-value color",
797
+ "description": "Color for boundaries that have no data.",
798
+ "default": "#f0f0f0"
799
+ },
800
+ "styleNormal": {
801
+ "type": "object",
802
+ "format": "table",
803
+ "title": "Style (normal)",
804
+ "description": "Style for boundaries in normal state",
805
+ "$ref": "#/definitions/map_style",
806
+ "default": {
807
+ "weight": 1,
808
+ "opacity": 1,
809
+ "fillOpacity": 0.7,
810
+ "color": "#888888"
811
+ }
812
+ },
813
+ "styleHighlighted": {
814
+ "type": "object",
815
+ "format": "table",
816
+ "title": "Style (highlighted)",
817
+ "description": "Style for boundaries in highlighted state",
818
+ "$ref": "#/definitions/map_style",
819
+ "default": {
820
+ "weight": 1,
821
+ "opacity": 1,
822
+ "fillOpacity": 0.7,
823
+ "color": "#111111"
824
+ }
825
+ },
826
+ "styleStatic": {
827
+ "type": "object",
828
+ "format": "table",
829
+ "title": "Style (static)",
830
+ "description": "Style for boundaries in static state (map layers using the 'static boundaries' option).",
831
+ "$ref": "#/definitions/map_style",
832
+ "default": {
833
+ "weight": 2,
834
+ "opacity": 1,
835
+ "fillOpacity": 0,
836
+ "color": "#172d44",
837
+ "dashArray": "5,5"
838
+ }
839
+ }
840
+ },
841
+ "links": [
842
+ {
843
+ "rel": "More information on the map options setting",
844
+ "href": "https://open-sdg.readthedocs.io/en/latest/maps/#map_options"
845
+ }
846
+ ]
847
+ },
848
+ "menu": {
849
+ "options": {"collapsed": true},
850
+ "format": "table",
851
+ "type": "array",
852
+ "minItems": 1,
853
+ "title": "Main menu",
854
+ "description": "The links to display in the main menu.",
855
+ "items": {
856
+ "$ref": "#/definitions/menu_item"
857
+ },
858
+ "links": [
859
+ {
860
+ "rel": "More information on the menu setting",
861
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#menu"
862
+ }
863
+ ]
864
+ },
865
+ "metadata_edit_url": {
866
+ "type": "string",
867
+ "minLength": 1,
868
+ "title": "Metadata edit URL",
869
+ "description": "This setting controls the URL of the 'Edit Metadata' buttons that appear on the staging site's indicator pages.",
870
+ "links": [
871
+ {
872
+ "rel": "More information on the metadata edit URL setting",
873
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#metadata_edit_url"
874
+ }
875
+ ]
876
+ },
877
+ "metadata_tabs": {
878
+ "options": {"collapsed": true},
879
+ "format": "table",
880
+ "type": "array",
881
+ "title": "Metadata tabs",
882
+ "description": "This setting can control the metadata tabs which appear on the indicator pages.",
883
+ "items": {
884
+ "type": "object",
885
+ "title": "Metadata tab",
886
+ "properties": {
887
+ "scope": {
888
+ "type": "string",
889
+ "minLength": 1,
890
+ "title": "Scope",
891
+ "description": "This tab will contain fields in the specific `scope` in your data repository's metadata schema file (eg, `_prose.yml`)."
892
+ },
893
+ "title": {
894
+ "type": "string",
895
+ "minLength": 1,
896
+ "title": "Title",
897
+ "description": "The title of the metadata tab."
898
+ },
899
+ "description": {
900
+ "type": "string",
901
+ "title": "Description",
902
+ "description": "A descriptive blurb to show at the top of the tab content.",
903
+ "format": "markdown"
904
+ }
905
+ }
906
+ },
907
+ "links": [
908
+ {
909
+ "rel": "More information on the metadata tabs setting",
910
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#metadata_tabs"
911
+ }
912
+ ]
913
+ },
914
+ "news": {
915
+ "options": {"collapsed": true},
916
+ "type": "object",
917
+ "title": "News",
918
+ "description": "Configuration related to news updates and posts.",
919
+ "properties": {
920
+ "category_links": {
921
+ "title": "Category links",
922
+ "type": "boolean",
923
+ "description": "Whether you would like the 'categories' of posts to generate links to dedicated category pages.",
924
+ "format": "checkbox"
925
+ }
926
+ },
927
+ "links": [
928
+ {
929
+ "rel": "More information on the news setting",
930
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#news"
931
+ }
932
+ ]
933
+ },
934
+ "non_global_metadata": {
935
+ "type": "string",
936
+ "title": "Non-global metadata",
937
+ "description": "This setting can be used to control the text of the tab containing non-global metadata.",
938
+ "links": [
939
+ {
940
+ "rel": "More information on the non-global metadata setting",
941
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#non_global_metadata"
942
+ }
943
+ ]
944
+ },
945
+ "remote_data_prefix": {
946
+ "type": "string",
947
+ "minLength": 1,
948
+ "title": "Remote data repository URL",
949
+ "description": "Specify the URL of your published data repository.",
950
+ "links": [
951
+ {
952
+ "rel": "More information on the remote data prefix setting",
953
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#remote_data_prefix"
954
+ }
955
+ ]
956
+ },
957
+ "reporting_status": {
958
+ "options": {"collapsed": true},
959
+ "type": "object",
960
+ "title": "Reporting status",
961
+ "description": "This setting is used in the 'reportingstatus' layout. It can display a title and description above the reporting status page.",
962
+ "$ref": "#/definitions/title_and_description",
963
+ "links": [
964
+ {
965
+ "rel": "More information on the reporting status setting",
966
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#reporting_status"
967
+ }
968
+ ]
969
+ },
970
+ "search_index_boost": {
971
+ "options": {"collapsed": true},
972
+ "format": "table",
973
+ "type": "array",
974
+ "title": "Search index boost",
975
+ "description": "This setting can be used to give a boost to one or more fields in the search index.",
976
+ "items": {
977
+ "type": "object",
978
+ "title": "Boost",
979
+ "properties": {
980
+ "field": {
981
+ "type": "string",
982
+ "minLength": 1,
983
+ "title": "Field",
984
+ "description": "Field to boost ('title', 'content', etc.)"
985
+ },
986
+ "boost": {
987
+ "type": "integer",
988
+ "minLength": 1,
989
+ "title": "Boost",
990
+ "description": "Higher boost means higher search ranking."
991
+ }
992
+ }
993
+ },
994
+ "links": [
995
+ {
996
+ "rel": "More information on the search index boost setting",
997
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#search_index_boost"
998
+ }
999
+ ]
1000
+ },
1001
+ "search_index_extra_fields": {
1002
+ "options": {"collapsed": true},
1003
+ "format": "table",
1004
+ "type": "array",
1005
+ "title": "Search index extra fields",
1006
+ "description": "This setting can be used to index additional metadata fields in your indicators, for the purposes of affecting the site-wide search.",
1007
+ "items": {
1008
+ "type": "string",
1009
+ "title": "Extra field"
1010
+ },
1011
+ "links": [
1012
+ {
1013
+ "rel": "More information on the search index extra fields setting",
1014
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#search_index_extra_fields"
1015
+ }
1016
+ ]
1017
+ },
1018
+ "series_toggle": {
1019
+ "title": "Series toggle",
1020
+ "type": "boolean",
1021
+ "description": "This setting enables the special treatment of the 'Series' column in the data. If set to true, when an indicator's data includes a 'Series' column, it will be displayed above 'Units' as radio buttons.",
1022
+ "format": "checkbox",
1023
+ "links": [
1024
+ {
1025
+ "rel": "More information on the series toggle setting",
1026
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#series_toggle"
1027
+ }
1028
+ ]
1029
+ },
1030
+ "sharethis_property": {
1031
+ "type": "string",
1032
+ "title": "ShareThis property",
1033
+ "description": "This setting creates a ShareThis widget along the left side of every page. It should be the property id for your ShareThis account.",
1034
+ "links": [
1035
+ {
1036
+ "rel": "More information on the sharethis setting",
1037
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#sharethis_property"
1038
+ }
1039
+ ]
1040
+ },
1041
+ "site_config_form": {
1042
+ "options": {"collapsed": true},
1043
+ "type": "object",
1044
+ "title": "Site configuration form",
1045
+ "description": "Configuration of the site configuration form.",
1046
+ "$ref": "#/definitions/config_form_options"
1047
+ },
1048
+ "validate_indicator_config": {
1049
+ "title": "Validate indicator config",
1050
+ "type": "boolean",
1051
+ "description": "If checked, this will require that all indicators have valid Open SDG indicator configuration.",
1052
+ "format": "checkbox",
1053
+ "links": [
1054
+ {
1055
+ "rel": "More information on the validate indicator config setting",
1056
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#validate_indicator_config"
1057
+ }
1058
+ ]
1059
+ },
1060
+ "validate_site_config": {
1061
+ "title": "Validate site config",
1062
+ "type": "boolean",
1063
+ "description": "If checked, this will require valid site configuration.",
1064
+ "format": "checkbox",
1065
+ "links": [
1066
+ {
1067
+ "rel": "More information on the validate site config setting",
1068
+ "href": "https://open-sdg.readthedocs.io/en/latest/configuration/#validate_site_config"
1069
+ }
1070
+ ]
1071
+ }
1072
+ },
1073
+ "additionalProperties": true,
1074
+ "definitions": {
1075
+ "menu_item": {
1076
+ "type": "object",
1077
+ "title": "Menu item",
1078
+ "properties": {
1079
+ "path": {
1080
+ "type": "string",
1081
+ "minLength": 1,
1082
+ "title": "Path",
1083
+ "description": "Path or URL that the menu item should link to."
1084
+ },
1085
+ "translation_key": {
1086
+ "type": "string",
1087
+ "minLength": 1,
1088
+ "title": "Label",
1089
+ "description": "Label (or translation key) for the link."
1090
+ }
1091
+ }
1092
+ },
1093
+ "breadcrumb_item": {
1094
+ "type": "object",
1095
+ "title": "Breadcrumb item",
1096
+ "properties": {
1097
+ "path": {
1098
+ "type": "string",
1099
+ "minLength": 1,
1100
+ "title": "Path",
1101
+ "description": "Path or URL that the breadcrumb item should link to."
1102
+ },
1103
+ "label": {
1104
+ "type": "string",
1105
+ "minLength": 1,
1106
+ "title": "Label",
1107
+ "description": "Label (or translation key) for the breadcrumb item."
1108
+ }
1109
+ }
1110
+ },
1111
+ "title_and_description": {
1112
+ "type": "object",
1113
+ "properties": {
1114
+ "title": {
1115
+ "type": "string",
1116
+ "title": "Title"
1117
+ },
1118
+ "description": {
1119
+ "type": "string",
1120
+ "title": "Description",
1121
+ "format": "markdown"
1122
+ }
1123
+ }
1124
+ },
1125
+ "map_style": {
1126
+ "properties": {
1127
+ "weight": {
1128
+ "type": "number",
1129
+ "title": "Weight",
1130
+ "description": "The weight (boldness) of boundary borders."
1131
+ },
1132
+ "opacity": {
1133
+ "type": "number",
1134
+ "title": "Opacity",
1135
+ "description": "The opacity of the boundary borders (between 0 and 1)."
1136
+ },
1137
+ "fillOpacity": {
1138
+ "type": "number",
1139
+ "title": "Fill opacity",
1140
+ "description": "The opacity of the boundaries' background color (between 0 and 1)."
1141
+ },
1142
+ "color": {
1143
+ "type": "string",
1144
+ "format": "color",
1145
+ "title": "Color",
1146
+ "description": "The color of the boundary borders."
1147
+ },
1148
+ "dashArray": {
1149
+ "type": "string",
1150
+ "title": "Dash array",
1151
+ "description": "A 'dash array' describing the boundary as dashed lines."
1152
+ }
1153
+ }
1154
+ },
1155
+ "config_form_options": {
1156
+ "type": "object",
1157
+ "properties": {
1158
+ "dropdowns": {
1159
+ "type": "array",
1160
+ "title": "Dropdown lists",
1161
+ "description": "Set options for any dropdown lists.",
1162
+ "items": {
1163
+ "type": "object",
1164
+ "format": "table",
1165
+ "title": "Dropdown list",
1166
+ "properties": {
1167
+ "jsonschema": {
1168
+ "type": "string",
1169
+ "title": "JSONSchema path",
1170
+ "description": "The jsonschema path to the dropdown field."
1171
+ },
1172
+ "values": {
1173
+ "type": "array",
1174
+ "format": "table",
1175
+ "title": "Values",
1176
+ "description": "List of dropdown option values",
1177
+ "items": {
1178
+ "type": "string",
1179
+ "title": "Value"
1180
+ }
1181
+ },
1182
+ "labels": {
1183
+ "type": "array",
1184
+ "format": "table",
1185
+ "title": "Labels",
1186
+ "description": "Optional list of dropdown option labels. Should correspond to the values above.",
1187
+ "items": {
1188
+ "type": "string",
1189
+ "title": "Label"
1190
+ }
1191
+ }
1192
+ }
1193
+ }
1194
+ }
1195
+ }
1196
+ }
1197
+ }
1198
+ }