Typecraft v2.5
Jump to: navigation, search

Difference between revisions of "Help:QuickStart"

 
(112 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<span style="font-size:150%;">This is the TypeCraft QuickStart page</span>
+
Also look at:  
 +
* [[Help:The_TypeCraft_Editors_for_Newcomers| '''Newcomers''']]
 +
* [[Help: How to search in TypeCraft| '''Database search''']]
 +
 +
* '''The TypeCraft wiki'''
 +
** [[Help:Posting_on_the_TypeCraft_Wiki|'''Posting'''  ]]
 +
** [[Help:Searching_in_the_TypeCraft_Wiki|'''Searching''' ]]
  
For more information about linguistic online editing with TypeCraft, search in the TypeCraft database, exporting TypeCraft data, or editing the TypeCraft wiki, please consult
 
one of the following TypeCraft wiki pages:
 
  
* Help with the TypeCraft Editor [[Help:The_TypeCraft_editor_for_Newcomers|for Newcomers]]
+
===How to annotate new text in the TC database===
 +
Link to a more detailed introduction  [[Help:How_to_annotate_in_TypeCraft_-_a_practical_guide| Using the '''TypeCraft Editors''']]
 
   
 
   
* Help with using the [[Help:How_to_annotate_in_TypeCraft_-_a_practical_guide|TypeCraft Editor]]
+
You enter the editor by clicking on '''TypeCraft Menu''' -> '''TypeCraft editor''' -> '''New text''' on the TypeCraft navigation bar. "Text" here refers to any written material that you would like to submit to the editor for annotation. After clicking on '''New text''' the editor loads an empty text field with a template for meta data on the right, as shown in the screen shot below. (Click on the picture to enlarge it.)
 
+
* Help with searching in TypeCraft [[Help: How to search in TypeCraft]]
+
+
* Help with the TypeCraft wiki[[Help:Posting_on_the_TypeCraft_Wiki ]]
+
 
+
 
+
==Help with the TC Editors==
+
===Annotation using the TypeCraft 2.0 editor=== 
+
You enter the TC2 editor by clicking on '''New text''' one the TypeCraft navigation bar. The editor opens a dialog window with the following message:
+
 
+
Your text will use the new and better TC editor.
+
If for some reason you want to use the old editor choose 
+
*'''No'''* below.  
+
 
+
The word "Text" in the phrase "Your text" above refers to any piece of digital writing not yet linguisticaly annotated. To annotate this text in the new editor, you now press "yes".  
+
 
[[File:TCeditor1.jpg|thumb|250px|left|the Editor text area-no text loaded yet ]]
 
[[File:TCeditor1.jpg|thumb|250px|left|the Editor text area-no text loaded yet ]]
The editor's text area opens (see screenshot to the left). To the right the Metadata matrix is accessible. We offer a default Metadata template and a
+
The editor's text area allows basic formatting of your text (see screenshot to the left). To the right of the text area the Metadata matrix is accessible. We offer a default Metadata template and additional specialized templates to which you can change by using the *Change Metadata set* bottom at the bottom of the template section.
template for the [http://www.skrivesenteret.no/ Norwegian Centre for Writing and Writing Research]. (You find a *Change Metadata set* bottom at the end of the template.)
+
  
You enter your text into the text area by copying & pasting text from a file or from an online site into the text area. Next you select the text's lanuage in the metadata template and provide the rest of the metadata. You always can come back to this, and fill in missing information.
+
You enter your text into the text area by copying & pasting text from a file or from an online site into the text area. You then  select the text's language in the metadata template and provide the rest of the metadata. You can always come back to completing meta information.  
  
Back to the text area you now define what we call ''Phrases'' for annotation. TypeCraft ''phrases'' might be sentences or fragments. Also, text does not need to be annotated sentence by sentence, although that is also possible by ..............
+
Back to the text area you now define what we call ''Phrases'' for annotation. TypeCraft ''phrases'' may be sentences or fragments.  
............... .
+
Text does not need to be annotated sentence by sentence. You select an element for annotation by highlighting it. You then press the '''New Phrase''' button which will put the selected element into the '''Phrase list'''. In the text area this phrase now appears in green.
 
+
If you would like to annotate the whole text, press '''New Phrase''' without selecting anything. Follow the instructions given in the dialog window.
You select an element for annotation by highlighting it. You then press the '''New Phrase''' button which will put the selected element into the '''Phrase list'''. In the text area this phrase now appears in green.
+
 
   
 
   
Now it is time for starting with the core annotation. You can do that in two ways. You double-click on one of the instantiated elements in the text area (those sentence in green colour), or you open the Phrase list by clicking on *View Phrase list*.
+
You can start to annotate in several ways. You double-click on one of the instantiated (green) elements in the text area, or you open the Phrase list by clicking on '''*View Phrase list*''' and select the phrase that you would like to annotate.
  
When the phrase opens a dialogue window pops-up with the following message:
+
When the phrase opens, a dialogue window pops-up with the following message:
  
 
   '''TypeCraft wants to know '''
 
   '''TypeCraft wants to know '''
Line 46: Line 34:
 
       For this option, click *Cancel* and an empty table will appear.
 
       For this option, click *Cancel* and an empty table will appear.
  
====The tabular annotation editor====
+
After you have decided between these options, i.e., whether you would like to work with a pre-filled table which realizes your choices of morph boundaries, or you would like to start with an empty table, the tabular editor will open, respectively, pre-filled or empty.  
After you have decided whether you would like to work with a pre-filled table which realises your choices of morph boundaries, or you would like to start with a
+
clean table, the tabular editor will open, respectively, pre-filled or empty.  
+
 
+
You annotate by navigating through the table. We recommend that you add annotations to the tiers vertically by making use of the space bar. This method is in our experience the fastest.
+
 
+
''' To learn more about the tiers and annotation tags and levels go to'''
+
          '''[[Multi-level linguistic annotation with TypeCraft]]'''
+
 
+
The *WORD* and the *MORPH* tiers feature a menu bar which allows you to modify existing entries. The menu bar appears when you activate the field you want to change. From the menu you can also add words or change the word's segmentation. *Gloss* and *POS* tags are chosen from a predefined list. You find an overview over all Gloss and POS tags on your navigation bar. These lists are auto-generated and can be ordered by category at your convenience. The lists also provide short definitions for each tag.
+
 
+
The annotation table is supplemented by a large note field. Notice that also the content of the note field can be searched, and if you for example use a designated marker to
+
flag sentences that you would like to target by a search, this can be done easily. Is the annotation of a phrase questionable, you could add a question mark to the Note field. A search for "?" in the note field will then allow you to target by a search only sentences with questionable annotations.
+
 
+
 
+
====Annotation for Discourse Senses====
+
Recently linguists have taken a new interest in text annotation: Next to semantic and pragmatic phenomena, also writing research seeks to establish reliably annotations to determine writer proficiency. Which text attributes are indicators for the writer's proficiency. How do we describe in qualitative terms writing development of young writers, and how should we flag these qualities in terms of attributes that we are able to tag by means of annotations.
+
 
+
The new TypeCraft editor allows its users to annotate text fragments in the context of a text, and to annotate words or word sequence for discourse senses (here called for short ''Senses''.
+
For the QuickStart, we describe how you can define text fragments of different length, assign discourse senses, indicate their scope and view them in a text.
+
 
+
  ''' To learn more about the discourse senses in TypeCraft go to'''
+
          '''[[Multi-level linguistic annotation with TypeCraft]]'''
+
 
+
 
+
In order to add discourse senses to your annotations, go to your tabular editor. At the bottom of the annotation table you find the function *Add Discourse Sense*. Clicking the function will add a new tier to your annotation table. In this way, the editor can be extended by tree additional tiers for sense annotation. You can hide tiers of the table that you are not interested in by going to the Tool tabs above the table.
+
 
+
At present we offer one experimental set of annotation tags for discourse senses. These tags can be accessed from the TypeCraft navigation bar. The list is automatically updated from the database when new tags become available.
+
 
+
After you have added a Sense tier you assign a Sense tag. This you do by clicking on the leftmost field of the new Sense tier. Sense tags must be chosen from a list of predefined tags(see Sense tag list in the navigation bar). Available tags also appear in the drop-down menu which is activated as soon as you start typing into the left most Sense tier field.
+
 
+
 
+
 
+
====Annotation for Valence using the Valence description template====
+
You enter the valence annotation mode from the tabular editor by pressing the * Change* to the
+
right of the label '''Valence''' which you find above the word- and morph-level annotation table.
+
 
+
An additional annotation window, as shown in the screenshot to the left, appears and allows you to specify valency attributes using a predefined vocabulary.
+
 
+
[[Image:ValenceAnno.jpg|thumb|500px|left|Valence Annotation Schema]]
+
 
+
While the valence annotation schema is still under development, we allow at this point the input of the following attributes:
+
 
+
[[Image:Menu Valence.jpg|thumb|200px|right| Drop-down window for the attribute Syntactic argument structure]] 
+
 
+
* '''Syntactic Argument Structure'''  * '''Salient Sentence Pattern'''
+
* '''Situation Type'''                * '''Force & Eventuality'''
+
* '''Diathesis'''                      * '''Modality'''
+
* '''Adjunct of Interest'''            * '''Sentence Aspect'''
+
 
+
 
+
Each of these attributes has a set of possible values. Some of the values for the attribute Syntactic Argument Structure are shown to the the right in the way they appear in the drop-down menu.
+
 
+
 
+
More about Valence annotation in TypeCraft can be found under:
+
 
+
''' To learn more about Valence annotation in TypeCraft go to'''
+
'''[[Multi-level linguistic annotation with TypeCraft]]'''
+
 
+
  
 +
You annotate by navigating through the table. We recommend that you add annotations to the tiers vertically by making use of the space bar for traversing the table in a vertical fashion. This method is in our experience the fastest.
  
 +
The *WORD* and the *MORPH* tiers feature a menu bar which allows you to modify existing entries. The menu bar appears when you activate the field you want to change by clicking on it. From the menu (visible as grey lines on the right of the field) you can also add words or change the word's segmentation.
  
 +
*Gloss* and *POS* tags are chosen from predefined lists. You find an overview over all Gloss and POS tags in you '''TypeCraft Tools''' on the navigation bar (on the left of your browser window). These lists are auto-generated and can be ordered by category at your convenience. The lists also provide short definitions for each tag.
  
 +
The annotation table is supplemented by a large note field. Notice that also the content of the note field can be searched, and if you use a designated marker to flag sentences that you would like to target by a search, this can be done easily in the note field. Is the annotation of a phrase questionable, for example, you could add a question mark to the Note field. A search for "?" in the note field will then allow you to search only for sentences with questionable annotations.
  
 +
Aside from the features already mentioned, one can annotate also for '''valence''' and for '''discourse sense'''. For these, see [[How to annotate in TypeCraft - a practical guide]], and [[Multi-level linguistic annotation with TypeCraft]].
  
When finished with the annotation of valency you return to your tabular annotation editor, where the valence values now appear as a hyphenated string (as shown in the screenshot to the left)
+
===Search for Interlinear Glossed Text in the TC database===
 +
You enter the search facilities by clicking on '''TypeCraft Menu''' -> '''TypeCraft Search''', from which you have access to '''Text search''' and '''Phrase search'''.
  
[[File:ValenceAnno2.jpg|thumb|400px|left|The Valence annotation is highlighted in yellow]]
 
  
 +
====Text search====
  
exposing the valency specifications that you have chosen for the phrase under annotation. This is illustrated in the screenshot to the left; the Valence annotations is highlighted in yellow.
+
Text search allows you to find Interlinear Glossed Texts in the TypeCraft IGT database.
  
 +
[[File:Search1.jpg|thumb|700px|left]] 
  
 +
Since TypeCraft data is structured throughout, you can use many different search criteria to find the type of text you are looking for. You also can decide if you would like to look
 +
only in your own data, or if you intend a general search in TypeCraft data.
  
 +
Using Metadata information as search term, you can for example ask for the name of the text owner, when the text was modified last, and of course for the language.
 +
Strings or sub-strings of the text title or the title translation can be used directly as search terms.
  
 +
Valence over Sense annotations as well as Gloss and Part of Speech tags can be used to select texts that contain them. One or several tags in combination can be specified as search terms, and their
 +
scope can be defined.
  
 +
Also strings or sub-strings contained in the Note field can be used to search for texts.
  
 +
Go to the [[:Special:TypeCraft/SearchText/ |Text search]] on your navigation bar to look for the other search options.
  
 +
The screenshot above shows a partial result for a search of texts that contain thematic annotations; the GLOSS tags BEN(eficiary) and GOAL were used as search terms,
 +
and 38 texts were found with 127 instances for the search term GOAL and 154 instances for the search term BEN(eficiary).
  
  
  
 +
====Phrase search====
  
 +
Phrase search is equally fine-grained as text search. Next to specifying textual, phrasal, word and morpheme properties in order to inform your search, you can define the scope of your search.
  
 +
For example: When defining two Gloss tags as search terms you can choose the search scope such that you only look for glosses that specify the same morpheme, as it would be the case
 +
for the 3SG and PRES gloss tags relative to the English verb suffix ''-s'' in the word ''goe-s''.
  
 +
You might instead define that certain search terms should occur on the same word, or occur in the same phrase.
  
 +
As for text search, also the result of a phrase search is displayed showing the number of phrases found and the number of instances that were found for each of the search terms.
  
  
  
 +
===Search in the TypeCraft wiki===
 +
To access the wiki pages for search, write part of the name of the page wanted into the '''Search TC-wiki''' slot in the upper right cormer. You can choose between coontinuations of the name, and  a '''Search results''' page will open, either with the desired page, or a set of ''Page title matches'', between which you can further select.
  
 +
For further specification of the search domain, see [[Help:Searching_in_the_TypeCraft_Wiki|'''Searching''' ]].
  
===Annotation using the TypeCraft 1.0 editor===
+
If you want to search by general content rather than the name of a page, you can type into the '''Search TC-wiki''' slot in the upper right cormer the string "Category:", and a range of categories of wiki pages will show up. Clicking on either of these, all wiki pages falling within the category will show up.
  
<span style="color: red;"> We recommend the use of the new and improved TypeCraft 2.0 editor.</span>
 
  
  
<span style="color: grey;">Click *My Text* in the navigation-bar. The TC Editor opens. You may now enter or copy-and-paste a text into the left part of the editor window.
+
===The TypeCraft Importer===
Do not add morph boundaries at this point. At this point the TC Editor only accepts text strings. Before you start to tokenize your text strings,
+
The TypeCraft Importer allows you to import structured data from  other application.
determine the language of your text by going to the *CHANGE* button. TC uses the ISO-639-1 code for languages. Please use the drop-down window
+
At present we support import from Toolbox WORD (txt) import of IGT and the import of TC XML.
to select one of the ISO language namYour text will use the new and better TC editor.</span>
+
<span style="color: grey;">If for some reason you want to use the old editor choose No below.s. Give your text a title and a title translation if appropriate. Text title and title translation will inform *Text search* and therefore should be chosen with care.</span> 
+
  
'''Tokenization'''
+
Your files or the material that you provide in the Importer's text area will after import be accessible
<span style="color: grey;">You can tokenise your text into sentences. This generally works quite well. TypeCraft has at this point still problems with period signs for example in titles like ''Mr.'' or ''Dr.'' and semicolons. In order to tokenise you text or collection of sentences press *CREATE PHRASES*; this will initiate the tokenization. Inspect the result before you choose *Yes* from the dialogue box. If you have not highlighted parts of your text, TC will ask you whether you would like to tokenize the whole text. Say *Yes*. The tokenization can be repeated several times until you are content with the result.</span> 
+
in '''*Your text*''' which you access from the TypeCraft navigation bar after login.
  
'''Morph break-up'''
+
The TypeCraft Importer can also be used to import Norwegian text (Bokmål or Nynork)for Part of Speech tagging.
<span style="color: grey;">Select a sentence from the set of tokenised sentences which now have appeared on the right hand side of your editor window. Click on one sentence. This will open a dialogue box. Follow the instructions in the dialogue box to insert morph boundaries into the annotation table.</span>
+
The tagged output becomes accessible under ''' *My text * ''' for further annotation.
  
'''Annotation Table'''
+
For a more detailed description of the TypeCraft Importer go [[Help: The TypeCraft Importer]]
<span style="color: grey;">Navigate through the annotation levels vertically by making use of the space bar. The *WORD* and the *MORPH* tier feature a menu bar which allows you to delete words/morphs which appear when you click on the field in those rows that you would like to change. From the menu you can also add words or change the word segmentation. *Gloss* and *POS* tags are chosen from a predefined list. You find an overview over all Gloss and POS tags on your navigation bar. These lists are auto-generated and can be ordered by category at your convenience.
+
</span>
+

Latest revision as of 15:58, 25 December 2017

Also look at:


How to annotate new text in the TC database

Link to a more detailed introduction   Using the TypeCraft Editors

You enter the editor by clicking on TypeCraft Menu -> TypeCraft editor -> New text on the TypeCraft navigation bar. "Text" here refers to any written material that you would like to submit to the editor for annotation. After clicking on New text the editor loads an empty text field with a template for meta data on the right, as shown in the screen shot below. (Click on the picture to enlarge it.)

the Editor text area-no text loaded yet

The editor's text area allows basic formatting of your text (see screenshot to the left). To the right of the text area the Metadata matrix is accessible. We offer a default Metadata template and additional specialized templates to which you can change by using the *Change Metadata set* bottom at the bottom of the template section.

You enter your text into the text area by copying & pasting text from a file or from an online site into the text area. You then select the text's language in the metadata template and provide the rest of the metadata. You can always come back to completing meta information.

Back to the text area you now define what we call Phrases for annotation. TypeCraft phrases may be sentences or fragments. Text does not need to be annotated sentence by sentence. You select an element for annotation by highlighting it. You then press the New Phrase button which will put the selected element into the Phrase list. In the text area this phrase now appears in green. If you would like to annotate the whole text, press New Phrase without selecting anything. Follow the instructions given in the dialog window.

You can start to annotate in several ways. You double-click on one of the instantiated (green) elements in the text area, or you open the Phrase list by clicking on *View Phrase list* and select the phrase that you would like to annotate.

When the phrase opens, a dialogue window pops-up with the following message:

 TypeCraft wants to know 
 which of the following options you prefer:
 1. to insert full forms into the table directly (recommended).
      Choosing this option allows you to separate affixes from word stems
      in the input mask below. Insert hyphens "-" or spaces " " to indicate morph 
      or word boundaries and then click OK.
 2. to manually insert words from your phrase into the table.
      For this option, click *Cancel* and an empty table will appear.

After you have decided between these options, i.e., whether you would like to work with a pre-filled table which realizes your choices of morph boundaries, or you would like to start with an empty table, the tabular editor will open, respectively, pre-filled or empty.

You annotate by navigating through the table. We recommend that you add annotations to the tiers vertically by making use of the space bar for traversing the table in a vertical fashion. This method is in our experience the fastest.

The *WORD* and the *MORPH* tiers feature a menu bar which allows you to modify existing entries. The menu bar appears when you activate the field you want to change by clicking on it. From the menu (visible as grey lines on the right of the field) you can also add words or change the word's segmentation.

  • Gloss* and *POS* tags are chosen from predefined lists. You find an overview over all Gloss and POS tags in you TypeCraft Tools on the navigation bar (on the left of your browser window). These lists are auto-generated and can be ordered by category at your convenience. The lists also provide short definitions for each tag.

The annotation table is supplemented by a large note field. Notice that also the content of the note field can be searched, and if you use a designated marker to flag sentences that you would like to target by a search, this can be done easily in the note field. Is the annotation of a phrase questionable, for example, you could add a question mark to the Note field. A search for "?" in the note field will then allow you to search only for sentences with questionable annotations.

Aside from the features already mentioned, one can annotate also for valence and for discourse sense. For these, see How to annotate in TypeCraft - a practical guide, and Multi-level linguistic annotation with TypeCraft.

Search for Interlinear Glossed Text in the TC database

You enter the search facilities by clicking on TypeCraft Menu -> TypeCraft Search, from which you have access to Text search and Phrase search.


Text search

Text search allows you to find Interlinear Glossed Texts in the TypeCraft IGT database.

Search1.jpg

Since TypeCraft data is structured throughout, you can use many different search criteria to find the type of text you are looking for. You also can decide if you would like to look only in your own data, or if you intend a general search in TypeCraft data.

Using Metadata information as search term, you can for example ask for the name of the text owner, when the text was modified last, and of course for the language. Strings or sub-strings of the text title or the title translation can be used directly as search terms.

Valence over Sense annotations as well as Gloss and Part of Speech tags can be used to select texts that contain them. One or several tags in combination can be specified as search terms, and their scope can be defined.

Also strings or sub-strings contained in the Note field can be used to search for texts.

Go to the Text search on your navigation bar to look for the other search options.

The screenshot above shows a partial result for a search of texts that contain thematic annotations; the GLOSS tags BEN(eficiary) and GOAL were used as search terms, and 38 texts were found with 127 instances for the search term GOAL and 154 instances for the search term BEN(eficiary).


Phrase search

Phrase search is equally fine-grained as text search. Next to specifying textual, phrasal, word and morpheme properties in order to inform your search, you can define the scope of your search.

For example: When defining two Gloss tags as search terms you can choose the search scope such that you only look for glosses that specify the same morpheme, as it would be the case for the 3SG and PRES gloss tags relative to the English verb suffix -s in the word goe-s.

You might instead define that certain search terms should occur on the same word, or occur in the same phrase.

As for text search, also the result of a phrase search is displayed showing the number of phrases found and the number of instances that were found for each of the search terms.


Search in the TypeCraft wiki

To access the wiki pages for search, write part of the name of the page wanted into the Search TC-wiki slot in the upper right cormer. You can choose between coontinuations of the name, and a Search results page will open, either with the desired page, or a set of Page title matches, between which you can further select.

For further specification of the search domain, see Searching .

If you want to search by general content rather than the name of a page, you can type into the Search TC-wiki slot in the upper right cormer the string "Category:", and a range of categories of wiki pages will show up. Clicking on either of these, all wiki pages falling within the category will show up.


The TypeCraft Importer

The TypeCraft Importer allows you to import structured data from other application. At present we support import from Toolbox WORD (txt) import of IGT and the import of TC XML.

Your files or the material that you provide in the Importer's text area will after import be accessible in *Your text* which you access from the TypeCraft navigation bar after login.

The TypeCraft Importer can also be used to import Norwegian text (Bokmål or Nynork)for Part of Speech tagging. The tagged output becomes accessible under *My text * for further annotation.

For a more detailed description of the TypeCraft Importer go Help: The TypeCraft Importer