The ITS Team will be performing maintenance on Confluence beginning at 6:00 pm Tuesday, October 8. 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 Terms Knowledge Maps.
General Information
This section contains the identifier for the Knowledge Map, and lets you make the term private or public.
Field | Description | Type |
---|---|---|
Term ID | A unique identifier assigned to the term. This can't be changed and helps you distinguish the term from others with the same name. | short text (cannot be changed) |
Public? | Sets whether the term is visible to the public. You can uncheck this box if you aren't ready to share the term. | checkbox |
Names
Names for the Knowledge Map. The name for a term can change across languages or time: you can track those changes here. You can also list popular names for a term.
Field | Description | Type |
---|---|---|
Term | An alternate name for the term. | short text |
Name Type | This field sets whether the name is official or popular. | controlled vocabulary |
Language | The language of the name. This field 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 term. The caption appears in term previews throughout Mandala. It should be under 140 characters. Make sure it's general and clear enough to identify the term 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 field should be shorter than 140 characters. Make sure it's general and clear enough to identify the term 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 term. 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 term. It appears next to the summary on the main page for the Knowledge Map. Other images, including those that relate to the term 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) | A place associated with the image. This field uses Knowledge Maps. | kmap |
Is Primary | If this is checked, the image will show up before any other illustrations, including in Knowledge Map previews. | checkbox |
Term Codes
You can add codes to identify the term here. Every term 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 Terms: 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 |
Term Relations
You can assign related terms here. When you create a new term, a starts with relation will automatically be assigned to you term based off the starting characters. We've included some of the fields you'll need here.
To create a child term:
- In the "Term Relations" metadata section, click New Child
An editor for the new term will open
- Fill out the form using the table below to guide you
- Click Create
To assign an existing related term:
- In the "Term Relations" metadata section, click New term relation
A list of terms will appear
- Click Select next to the term you want to connect to the original term
New fields will open
- Fill out the form using the table below to guide you
- Click Create
Field | Description | Type |
---|---|---|
Term | The name of the new term (if you're creating a child term.) | 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 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 |
Term Relation Type | The type of relationship between the original term and the related term (whether new or existing). | controlled vocabulary |
Perspective | This corresponds to the language for your term. |
Essay
This is a legacy option. You should use Texts in Mandala if you want to add a longer essay to your Knowledge Map.
Definitions
Field | Description | Type |
---|---|---|
Is Public | Check this to make the definition available to the public. | checkbox |
Is Primary | checkbox | |
Content | The definition for the term. This can include styling, including bold, italics, paragraphs, and lists. | WYSIWYG |
Numerology | short text | |
Tense | This will depend on your language; in English, the tense associated with a verb expresses the time in which the action is occurring. | short text |
Language | The language of the definition. Each definition should only have one language. If you need to include a translation, add a new definition. | controlled vocabulary |
Author | The author of the definition. Contact mandala@virginia.edu if you need to add people to this list; any Terms editor can be assigned as an author. | controlled vocabulary |
Recordings
Recordings let you add audio files of your term being spoken. To add a recording:
- Click Add recording
Metadata fields for recordings will open
- Enter the dialect name, or click show dialect hierarchy to see the list of
- If you need a dialect not on this list, contact mandala@virginia.edu
- Click Choose File next to "Audio File"
Your operating system's file browser will open
- Open the file you want to add
- Click Create
Etymologies
Field | Description | Type |
---|---|---|
Etymology Type | The type of etymology – basic syllabic, creative, or historical. | controlled vocabulary |
Content | The etymology for the term. | WYSIWYG |
Controlled Vocabularies
Name Type
Value | Definition |
---|---|
Official | The official name for a term, as designated by the government. |
Popular | A popular name for the term, 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
- Cyrillic
- Devanagari Script
- Latin Script
- Simplified Chinese Characters
- Tibetan Script
- Traditional Chinese Characters
Picture Type
Unless you're part of the Tibetan and Himalayan Library, this should always be External.
- External
- MMS
Subject Relation Type
Value |
---|
Is Related To |
Is Beginning Of |
Heads |
Is Headed By |
Has A Conjugation |
Is A Conjugation Of |