You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

How to use this guide

This is a complete list of metadata fields for Terms 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 section contains the identifier for the Knowledge Map, and lets you make the term private or public.

FieldDescriptionType
Term IDA 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. 

FieldDescriptionType

Term

An alternate name for the term. 

short text
Name TypeThis field sets whether the name is official or popular.controlled vocabulary
LanguageThe language of the name. This field is independent of the 'writing system,' which you can learn more about below.controlled vocabulary
Writing SystemThe alphabet or symbol system used to represent the language. For example, English uses the Latin script. controlled vocabulary
EtymologyThe 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.

FieldDescriptionType

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
CaptionThe 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
AuthorThe 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.

FieldDescriptionType

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
SummaryThe text of the summary. This should be shorter than 750 characters.WYSIWYG
AuthorThe 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.

FieldDescriptionType

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
URLThe 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
CaptionA short description of the image.short text
Place (Places Dictionary FID)A place associated with the image. This field uses Knowledge Maps.kmap
Is PrimaryIf 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.

FieldDescriptionType
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
ValueThe 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: 

  1. In the "Term Relations" metadata section, click New Child
    • An editor for the new term will open
  2. Fill out the form using the table below to guide you
  3. Click Create

To assign an existing related term: 

  1. In the "Term Relations" metadata section, click New term relation
    • A list of terms will appear
  2. Click Select next to the term you want to connect to the original term
    • New fields will open
  3. Fill out the form using the table below to guide you
  4. Click Create
FieldDescriptionType
TermThe name of the new term (if you're creating a child term.)short text
Name TypeThis sets whether the name is official or popular.controlled vocabulary
LanguageThe language of the name. This is independent of the 'writing system,' which you can learn more about below.controlled vocabulary 
Writing SystemThe alphabet or symbol system used to represent the language. For example, English uses the Latin script. controlled vocabulary
EtymologyThe 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 TypeThe type of relationship between the original term and the related term (whether new or existing).controlled vocabulary
PerspectiveThis 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

FieldDescriptionType
Is PublicCheck this to make the definition available to the public. checkbox
Is Primary
checkbox
ContentThe definition for the term. This can include styling, including bold, italics, paragraphs, and lists. WYSIWYG
Numerology
short text
TenseThis will depend on your language; in English, the tense associated with a verb expresses the time in which the action is occurring. short text
LanguageThe language of the definition. Each definition should only have one language. If you need to include a translation, add a new definition.controlled vocabulary
AuthorThe 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: 

  1. Click Add recording
    • Metadata fields for recordings will open
  2. Enter the dialect name, or click show dialect hierarchy to see the list of 
  3. Click Choose File next to "Audio File"
    • Your operating system's file browser will open
  4. Open the file you want to add
  5. Click Create

Etymologies

FieldDescriptionType
Etymology TypeThe type of etymology – basic syllabic, creative, or historical.controlled vocabulary
ContentThe etymology for the term. WYSIWYG

Controlled Vocabularies

Name Type

ValueDefinition
Official

The official name for a term, as designated by the government.

Example: French cheese names are controlled by the French government. To call a cheese "Camembert de Normandie," it has to meet strict standards of production. "Camembert de Normandie" would be the "official" name for the cheese.

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



  • No labels