The ITS Team will be performing maintenance on Confluence beginning at 6:00 pm Tuesday, May 6. During this time the service may go offline. It should be available again by 8:00 pm. Please refrain from editing pages during this time to avoid losing your work.
How to use this guide
This is a complete list of metadata fields for Subject Knowledge Maps.
You can use these tables to guide your data entry. We've listed fields in the order they appear in the editor. Each section in the editor has its own table.
For certain fields, you have a restricted list of options called controlled vocabularies. We've listed the controlled vocabularies for those fields at the bottom of the page.
General Information
This contains the identifier for the Knowledge Map, and lets you make the place private or public.
| Field | Description | Type |
|---|---|---|
| Subject ID | A unique identifier assigned to the place. This can't be changed, and helps you distinguish the place from others with the same name. | |
| Public? | Sets whether the places is visible to the public. You can check this box if you aren't ready to share the place. | checkbox |
Names
Names for the Knowledge Map. The name for a subject can change across languages or time: you can track those changes here. You can also list popular names for a subject.
| Field | Description | Type |
|---|---|---|
Subject | An alternate name for the subject. | short text |
| Name Type | This sets whether the name is official or popular. | controlled vocabulary |
| Language | The language of the name. This is independent of the 'writing system,' which you can learn more about below. | controlled vocabulary |
| Writing System | The alphabet or symbol system used to represent the language. For example, English uses the Latin script. | controlled vocabulary |
| Etymology | The etymological origin of the alternate name. | long text (WYSIWYG) |
| Primary for Popular Romanization View? | Popular romanization is an easy-to-pronounce version of names in roman script, which is intended for audiences around the world. | checkbox |
Caption
A brief, "tweet-sized" description for the KMap. This appears in KMap previews throughout Mandala. The caption should be under 140 characters. Make sure it's general and clear enough to identify the feature from a list.
| Field | Description | Type |
|---|---|---|
Language | The language of the caption. Each caption should only have one language. If you need to include a translation, add a new caption. | controlled vocabulary |
| Caption | The text of the caption. This should be shorter than 140 characters. Make sure it's general and clear enough to identify the feature from a list. | WYSIWYG |
| Author | The author of the caption. By default, this is set to your username. | controlled vocabulary |
Summaries
A summary of the important aspects of the subject. This should be less than 750 characters long. If you want to translate your summary into multiple languages, each language needs its own summary. You can add more than one summary.
| Field | Description | Type |
|---|---|---|
Language | The language of the summary. Each summary should only have one language. If you need to include a translation, add a new summary. | controlled vocabulary |
| Summary | The text of the summary. This should be shorter than 750 characters. | WYSIWYG |
| Author | The author of the summary. By default, this is set to your username. | controlled vocabulary |
Illustration
A single image that is representative of the subject or place. It appears next to the summary on the main page for the Knowledge Map. Other images, including those that relate to the subject or place but do not illustrate it, can be added using Images in Mandala. Learn more about this feature with Add Illustrations to KMaps.
| Field | Description | Type |
|---|---|---|
Picture Type | The type of source for the file. Unless you work for the Tibetan and Himalayan Library, this will always be "External." | controlled vocabulary |
| URL | The URL of your image, which is the source for the file. Unless you work for the Tibetan and Himalayan Library, this will always be "External." If your image is on your computer, you can host it using Images in Mandala. You would then paste that image's URL in that field. | short text |
| Caption | A short description of the image. | short text |
| Place (Places Dictionary FID) | short text | |
| Is Primary | checkbox |
Subject Codes
You can add codes to identify the subject here. Every subject also has its own unique identifier in Knowledge Maps.
| Field | Description | Type |
|---|---|---|
| Subject Code Type | The type of code. We don't currently have a set list of code types for Subjects: email mandala@virginia.edu to request a type. Example: The 'Library of Congress Subject Area' designates broad subject areas using a specific letter. | controlled vocabulary |
| Value | The actual value of the code. Example: For the subject 'Education' and a subject code type 'Library of Congress Classification', the value would be 'L' | short text |
Subject Relations
You can assign related subjects here. This is also used to create child subjects. We've included some of the fields you'll need here, but check out the Create a Child Subject and Add a Subject Relation guides.
| Field | Description | Type |
|---|---|---|
| Subject | The name of the new subject (if you're creating a child subject.) | short text |
| Name Type | This sets whether the name is official or popular. | controlled vocabulary |
| Language | The language of the name. This is independent from the 'writing system,' which you can learn more about below. | controlled vocabulary |
| Writing System | The alphabet or symbol system used to represent the language. For example, English uses the Latin script. | controlled vocabulary |
| Etymology | The etymological origin of the name. | WYSIWYG |
| Primary for Popular Romanization View? | Popular romanization is an easy-to-pronounce version of names in roman script, which is intended for audiences around the world. | checkbox |
| Subject Relation Type | The type of relationship between the original subject and the related subject (whether new or existing). | controlled vocabulary |
| Perspective | You can ignore this field, which applies only to Places. There is only on perspective for Subjects – "General." You can learn more about Perspectives if you're curious. | controlled vocabulary |
Essay
This is a legacy option. You should use Texts in Mandala if you want to add a longer essay to your Knowledge Map.
Controlled Vocabularies
Name Type
| Value | Definition |
|---|---|
| Official | The official name for a subject, as designated by the government. |
| Popular | A popular name for the subject, used in speech or non-official documents. Example: 'Camembert' is the popular name for "Camembert de Normandie," a cheese protected by the French government (see the example above.) |
Language
Arabic
Burmese
Chinese
Dzongkha
English
French
German
Hindi
Italian
Japanese
Korean
Latin
Mongolian
Nepali
Pali
Polish
Prakrit
Russian
Sanskrit
Sinhalese
Spanish
Thai
Tibetan
Unknown
Urdu
Vietnamese
Writing System
| Value | Definition |
|---|---|
Cyrillic | |
| Devanagari Script | |
| Latin Script | |
| Simplified Chinese Characters | |
| Tibetan Script | |
| Traditional Chinese Characters |
Picture Type
| Value | Definition |
|---|---|
| External | |
| MMS |
Subject Relation Type
| Value | Definition |
|---|---|
Is The Same As | A relationship in which the two subjects are the same. |
Is An Instance Of | A relationship in which one subject (A) is an illustrative case, example, or concretization of another (more abstract) subject (B). A is an instance of B.
|
| Is A Type Of | A relationship in which one subject (A) shares or exemplifies characteristics defined by another subject (B). Subject B is usually above the subject A hierarchically. Example: A cat is a type of pet. |
| Is A Variation Of | A relationship in which two subjects share similar characteristics, but show deviations from each other. Unlike "is a type of", neither subject is above the other hierarchically. Example: The Cesca chair designed by Marcel Breuer is in the public domain, so the design has been remade and remixed by several manufacturers. Each chair is a variation of the original. |
| Is Narrower Than | A relationship in which one subject (A) has a smaller scope than the other subject (B). A is narrower than B. |
| Is Related To | A generic relationship between two subjects; use this only if no other relationship applies. |
| Is The Opposite Of | A relationship of opposition. This includes antonyms. |