JSON schema definition and supporting example/validation code for The Washington Post's ANS specification
NOTE This schema is in development and subject to change.
ANS ("Arc Native Specification") is the collection of schema documents that comprise the Washington Post's definition of "content", in so far as content is passed back and forth between systems in the Arc ecosystem of applications.
ANS Schema files are defined with the JSON Schema specification. Schemas are defined in individual files under the src/main/resrouces/schema/ans/version/ directory.
Small, self-contained, attributes such as "had copyright" or "had unique id" are modeled as traits, which are combined together or applied directly to more complicated schema objects for the purpose of re-usability. The "content.json" schema, for example, composes the traits "credit", "locale", "location", and "copyright".
One can use a variety of third party tools to validate their content against the schema files hosted here on github publicly, such as Ajv.
A few examples are provided of content documents that validate against the Washington Post ANS schema:
See the contributing documentation for information about how to suggest changes to the ANS schema.
This project contains a node library that can be used to validate ANS documents locally. It is the same validator used in the ANS Service: http://ans.arc2.nile.works/validate/0.7.1
You can run the validator on the command line from the project directory to validate an ANS document:
npm install
npm run-script ans -- --ansdata='{"type":"story", "version":"0.5.5"}' --version=0.5.8 validate
[
{
"keyword": "enum",
"dataPath": ".version",
"schemaPath": "https://raw.githubusercontent.com/washingtonpost/ans-schema/master/src/main/resources/schema/ans/0.5.8/traits/trait_version.json/enum",
"params": {},
"message": "should be equal to one of values"
}
]
A file can also be used as input:
npm run-script ans -- --ansfile=test.json --version=0.5.8 validate
You can also load the validator as a library in your node project:
var ans = require('ans-schema');
ans.getValidatorForVersion('0.5.8', function(err, validator) {
var errors = validator.validate({"type":"story", "version":"0.5.8"});
if (errors.length > 0) {
console.log("There were some errors: " + JSON.stringify(errors));
}
else {
console.log("It's valid!");
}
});
Converts a valid document in an old version of ANS to newer version.
npm run-script ans -- --ansdata='{"type":"story", "version":"0.5.0", "content_elements":[{"type":"text", "content": "Foo!", "additonal_properties": { "foo":"bar"}}], "taxonomy":{"sections":[{ "type": "section", "version":"0.5.0"}]}}' upvert
{
"type": "story",
"version": "0.5.8",
"content_elements": [
{
"type": "text",
"content": "Foo!",
"additional_properties": {
"foo": "bar"
}
}
],
"taxonomy": {
"sites": [
{
"additional_properties": {
"type": "section"
},
"version": "0.5.8",
"type": "site",
"name": "(unnamed)",
"primary": false
}
]
}
}
Fixes an invalid document composed of valid sub-documents of differing ANS versions. Essentially this converts a very specific kind of invalid document to a valid one by selective upverting.
npm run-script ans -- --ansdata='{"type":"story", "version":"0.5.8", "content_elements":[{"type":"gallery", "version":"0.5.3", "content_elements":[ {"type":"image", "version":"0.5.3", "url":"http://foo.com/img.jpg"}]}]}' sync
{
"type": "story",
"version": "0.5.8",
"content_elements": [
{
"type": "gallery",
"version": "0.5.8",
"content_elements": [
{
"type": "image",
"version": "0.5.8",
"url": "http://foo.com/img.jpg"
}
]
}
]
}
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent