StoryRampSchema.json

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "StoryRAMP Config Schema",
    "type": "object",
    "additionalProperties": false,

    "$defs": {
        "slide": {
            "type": "object",
            "description": "A universal StoryRAMP slide",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "The title for the slide."
                },
                "panel": {
                    "$ref": "#/$defs/panel"
                }
            },
            "required": ["title", "panel"]
        },

        "panel": {
            "type": "array",
            "description": "A single slide component",
            "items": {
                "oneOf": [
                    {
                        "$ref": "#/$defs/textPanel"
                    },
                    {
                        "$ref": "#/$defs/mapPanel"
                    },
                    {
                        "$ref": "#/$defs/multimediaPanel"
                    },
                    {
                        "$ref": "#/$defs/dqvchartPanel"
                    },
                    {
                        "$ref": "#/$defs/dynamicPanel"
                    }
                ]
            },
            "properties": {
                "width": "number",
                "description": "The width of the panel inside the slide (between 0 and 100)."
            },
            "minItems": 1,
            "maxItems": 2
        },

        "textPanel": {
            "type": "object",
            "description": "A text slide component.",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "The title for the text panel."
                },
                "titleTag": {
                    "type": "string",
                    "description": "An optional tag to use for the panel title. If not supplied h2 is used.",
                    "default": "h2"
                },
                "content": {
                    "type": "string",
                    "description": "The main text body."
                },
                "type": {
                    "type": "string",
                    "enum": ["text"]
                }
            },
            "required": ["content", "type", "title"]
        },

        "dynamicPanel": {
            "type": "object",
            "description": "A dynamic slide component.",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "The title for the text panel."
                },
                "titleTag": {
                    "type": "string",
                    "description": "An optional tag to use for the panel title. If not supplied h2 is used.",
                    "default": "h2"
                },
                "content": {
                    "type": "string",
                    "description": "The main text body."
                },
                "children": {
                    "type": "array",
                    "description": "The panels to display dynamically.",
                    "items": {
                        "$ref": "#/$defs/dynamicChildItem"
                    },
                    "minItems": 1
                },
                "type": {
                    "type": "string",
                    "enum": ["dynamic"]
                }
            },
            "required": ["content", "type", "children", "title"]
        },

        "dynamicChildItem": {
            "type": "object",
            "description": "A child screen of a dynamic panel. Contains an ID and a panel config.",
            "properties": {
                "id": "string",
                "panel": {
                    "oneOf": [
                        {
                            "$ref": "#/$defs/textPanel"
                        },
                        {
                            "$ref": "#/$defs/mapPanel"
                        },
                        {
                            "$ref": "#/$defs/multimediaPanel"
                        },
                        {
                            "$ref": "#/$defs/dqvchartPanel"
                        }
                    ]
                }
            },
            "required": ["id", "panel"]
        },

        "multimediaPanel": {
            "type": "object",
            "description": "A multimedia slide component.",
            "oneOf": [
                {
                    "$ref": "#/$defs/multimediaImage"
                },
                {
                    "$ref": "#/$defs/multimediaVideo"
                },
                {
                    "$ref": "#/$defs/multimediaAudio"
                },
                {
                    "$ref": "#/$defs/multimediaSlideshow"
                }
            ],
            "properties": {
                "fullscreen": {
                    "type": "boolean",
                    "description": "Specifies whether the panel can be expanded to full screen.",
                    "default": true
                }
            }
        },

        "mapPanel": {
            "type": "object",
            "description": "A map slide component.",
            "properties": {
                "config": {
                    "type": "string",
                    "description": "A relative path to a JSON file containing the map config.",
                    "default": ""
                },
                "fullscreen": {
                    "type": "boolean",
                    "description": "Specifies whether the panel can be expanded to full screen.",
                    "default": true
                },
                "type": {
                    "type": "string",
                    "enum": ["map"]
                },
                "scrollguard": {
                    "type": "boolean",
                    "description": "Whether or not CTRL is required to scroll this map.",
                    "default": false
                },
                "title": {
                    "type": "string",
                    "description": "A title that is displayed centered above this map."
                }
            },
            "required": ["config", "type"]
        },

        "dqvchartPanel": {
            "type": "object",
            "description": "A dqvchart slide component.",
            "properties": {
                "src": {
                    "type": "string",
                    "description": "The source containing the dqvchart json config."
                },
                "config": {
                    "type": "object",
                    "description": "Configured Highcharts JSON object (from editor)."
                },
                "fullscreen": {
                    "type": "boolean",
                    "description": "Specifies whether the panel can be expanded to full screen.",
                    "default": true
                },
                "type": {
                    "type": "string",
                    "enum": ["chart"]
                },
                "options": {
                    "$ref": "#/$defs/dqvchartOptions"
                }
            },
            "required": ["src", "type"]
        },

        "multimediaImage": {
            "type": "object",
            "description": "A multimedia image component.",
            "properties": {
                "width": {
                    "type": "number",
                    "description": "The image width."
                },
                "height": {
                    "type": "number",
                    "description": "The image height."
                },
                "src": {
                    "type": "string",
                    "description": "The source for the image."
                },
                "altText": {
                    "type": "string",
                    "description": "The supporting text for the image."
                },
                "caption": {
                    "type": "string",
                    "description": "Supporting text content for the image."
                },
                "class": {
                    "type": "string",
                    "description": "Styling class properties for the image."
                },
                "tooltip": {
                    "type": "string",
                    "description": "Tooltip content for the image."
                },
                "type": {
                    "type": "string",
                    "enum": ["image"]
                }
            },
            "required": ["src", "type"]
        },

        "multimediaVideo": {
            "type": "object",
            "description": "A multimedia video component.",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "The title for the video."
                },
                "width": {
                    "type": "number",
                    "description": "The video width."
                },
                "height": {
                    "type": "number",
                    "description": "The video height. Only for Youtube videos. Changing height for external/local videos won't work due to the aspect ratio of the original video needing to be kept the same."
                },
                "src": {
                    "type": "string",
                    "description": "The source for the video. External and YouTube videos should be a URL, while local video files must be contained in the assets folder."
                },
                "videoType": {
                    "type": "string",
                    "enum": ["local", "external", "YouTube"]
                },
                "thumbnailUrl": {
                    "type": "string",
                    "description": "Optional link for providing URL for video thumbnail image. Limited to non-YouTube videos."
                },
                "transcript": {
                    "type": "string",
                    "description": "The source for the transcript in HTML/Markdown."
                },
                "caption": {
                    "type": "string",
                    "description": "Overlaying subtitles on the video, input should be a .vtt file."
                },
                "type": {
                    "type": "string",
                    "enum": ["video"]
                }
            },
            "required": ["src", "type", "videoType"]
        },

        "multimediaAudio": {
            "type": "object",
            "description": "A multimedia audio component.",
            "properties": {
                "src": {
                    "type": "string",
                    "description": "** TODO: the plan just has 'type' here, how do we want to distinguish mp3, wav, etc?"
                },
                "caption": {
                    "type": "string",
                    "description": "Supporting text content for the audio."
                },
                "type": {
                    "type": "string",
                    "enum": ["audio"]
                }
            },
            "required": ["src", "type"]
        },

        "multimediaSlideshow": {
            "type": "object",
            "description": "A multimedia slideshow component.",
            "properties": {
                "images": {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/multimediaImage"
                    },
                    "description": "An array of images to display in the slideshow.",
                    "minItems": 1
                },
                "loop": {
                    "type": "boolean",
                    "description": "Determines whether the slideshow loops back around to the beginning when you reach the end.",
                    "default": false
                },
                "caption": {
                    "type": "text",
                    "description": "A caption to display below the slideshow."
                },
                "type": {
                    "type": "string",
                    "enum": ["slideshow"]
                }
            },
            "required": ["images", "type"]
        },
        "dqvchartOptions": {
            "type": "object",
            "description": "Configuration for a dqvchart.",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "The title of the chart."
                },
                "subtitle": {
                    "type": "string",
                    "description": "The subtitle of the chart."
                },
                "type": {
                    "type": "string",
                    "description": "The type of chart.",
                    "enum": ["line", "spline", "area", "areaspline", "column", "bar", "pie", "scatter", "gauge", "arearange", "areasplinerange", "columnrange"]
                },
                "width": {
                    "type": "number",
                    "description": "The width of the chart (will not exceed panel container width)."
                },
                "height": {
                    "type": "number",
                    "description": "The height of chart (will not exceed panel container height on mobile resolutions)."
                },
                "colours": {
                    "type": "array",
                    "description": "A list of colors to display chart data that corresponds to the order of columns in CSV file.",
                    "items": {
                        "type": "string"
                    }
                },
                "export": {
                    "type": "boolean",
                    "description": "Specify whether export menu options are enabled.",
                    "default": true
                },
                "credits": {
                    "type": "boolean",
                    "description": "Specify whether credits are enabled.",
                    "default": false
                },
                "xAxisLabel": {
                    "type": "string",
                    "description": "The title of the x-axis."
                },
                "yAxisLabel": {
                    "type": "string",
                    "description": "The title of the y-axis."
                }
            }
    },

    "properties": {
        "title": {
            "type": "string",
            "description": "The title of the story map."
        },

        "introSlide": {
            "type": "object",
            "description": "The introductory slide",
            "properties": {
                "logo": {
                    "type": "object",
                    "description": "Information about the StoryRAMP logo",
                    "properties": {
                        "src": {
                            "type": "string",
                            "description": "An image source that is displayed at the top of the slide"
                        },
                        "altText": {
                            "type": "string",
                            "description": "Alt text for the logo"
                        }
                    },
                    "required": ["src"]
                },
                "title": {
                    "type": "string",
                    "description": "The title of the project, displayed under the image"
                },
                "subtitle": {
                    "type": "string",
                    "description": "An optional subtitle that is displayed under the title."
                },
                "blurb": {
                    "type": "string",
                    "description": "Any additional information to display on the introductory slide."
                }
            },
            "required": ["logo", "title"]
        },

        "slides": {
            "type": "array",
            "description": "A list of StoryRAMP slides. A minimum of one slide is required.",
            "items": {
                "$ref": "#/$defs/slide"
            },
            "minItems": 1
        },

        "contextLink": {
            "type": "string",
            "description": "A link pointing to the source information"
        },

        "contextLabel": {
            "type": "string",
            "description": "A description that explains the context link."
        },

        "lang": {
            "type": "string",
            "description": "The language to display in the app",
            "enum": ["en", "fr"]
        },

        "dateModified": {
            "type": "string",
            "description": "The last date that this config file was modified."
        }
    },

    "required": ["title", "introSlide", "slides"]
}