@goldsucc/sanity-plugin-taxonomy-manager
v3.2.7
Published
Create and manage SKOS compliant taxonomies, thesauri, and classification schemes in Sanity Studio.
Downloads
30
Maintainers
Readme
Sanity Taxonomy Manager
Create and manage SKOS compliant taxonomies, thesauri, and classification schemes in Sanity Studio.
| | | --- |
Documentation
For full documentation, visit sanitytaxonomymanager.com.
Features
- Adds two document types to your Sanity schema which are used to generate SKOS compliant concepts and taxonomies:
skosConcept
andskosConceptScheme
- Includes reference filter helpers to allow you to easily include a specific taxonomy, or particular branch of a taxonomy in your Sanity documents
- Encourages taxonomy and thesaurus design best practices by enforcing disjunction between Broader and Related relationships and disjunction between Preferred and Alternate/Hidden labels
- Standards compliant architecture means that taxonomy terms and structures can be migrated to standards compliant standalone tools when you need higher level taxonomy and knowledge graph support.
Installation
In your Sanity project folder, run
npm i sanity-plugin-taxonomy-manager
or
yarn add sanity-plugin-taxonomy-manager
🚨 Breaking Changes for Concept Fields
Version 3 of Sanity Taxonomy Manager includes changes to
baseUri
andskosConceptScheme
fields that were part of version 1 and early (patch) versions of v2. If you are upgrading to Taxonomy Manager version 3 with concepts created in one of these early versions, install v2.3.1 first: it includes field utilities to help you migrate your terms and schemes to version 3.
Configuration
Add the plugin to your project configuration to add the Taxonomy Manager Tool to your studio workspace.
// sanity.config.js
import {defineConfig} from 'sanity'
import {deskTool} from 'sanity/desk'
import {taxonomyManager} from 'sanity-plugin-taxonomy-manager'
import {schemaTypes} from './schemas'
export default defineConfig({
name: 'default',
title: 'Sanity Studio',
projectId: '<projectId>',
dataset: 'production',
plugins: [
deskTool(),
// Include the taxonomy manager plugin
taxonomyManager({
// Optional: Set a Base URI to use for new concepts & concept schemes
baseUri: 'https://example.com/',
}),
],
schema: {
types: schemaTypes,
},
})
The plugin adds skosConcept
and skosConceptScheme
document types to your studio. Use a filter on documentTypeListItems
in the desk tool configuration to exclude taxonomy manager document types from your main document view.
// sanity.config.js
import {defineConfig} from 'sanity'
import {deskTool} from 'sanity/desk'
import {taxonomyManager} from 'sanity-plugin-taxonomy-manager'
import {schemaTypes} from './schemas'
export default defineConfig({
name: 'default',
title: 'Sanity Studio',
projectId: '<projectId>',
dataset: 'production',
plugins: [
deskTool({
structure: (S) =>
S.list()
.title('Content')
.items([
...S.documentTypeListItems().filter(
(listItem) => !['skosConcept', 'skosConceptScheme'].includes(listItem.getId())
),
]),
}),
taxonomyManager({
baseUri: 'https://example.com/',
}),
],
schema: {
types: schemaTypes,
},
})
Contributing
Community collaboration is highly encouraged. To make sure your contributions are aligned with project goals and principles, please read the contributing docs before submitting a pull request.
License
MIT © Andy Fitzgerald See LICENSE