Typecraft v2.5
Jump to: navigation, search

Difference between revisions of "Help:QuickStart"

(How to start a TCwiki-page)
 
(153 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{TcCopyEdit}}
+
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''' ]]
  
  
 +
===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''']]
 +
 +
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.)
 +
[[File:TCeditor1.jpg|thumb|250px|left|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.
  
=This is the TypeCraft QuickStart Guide=
+
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.
  
For more information about linguistic online editing with TypeCraft, search in the TypeCraft database, exporting TypeCraft data, or editing the TypeCraft wiki, please consult
+
Back to the text area you now define what we call ''Phrases'' for annotation. TypeCraft ''phrases'' may be sentences or fragments.
one of the following TypeCraft wiki pages:
+
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.
* Help with the TypeCraft Editor [[Help:The_TypeCraft_editor_for_Newcomers|for Newcomers]]
+
 
   
 
   
* Help with the using the [[Help:How_to_annotate_in_TypeCraft_-_a_practical_guide|TypeCraft Editor]]
+
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.
+
* Help with posting on the [[Help:Posting_on_the_TypeCraft_Wiki#Help_with_editing_in_the_TC_wiki|TypeCraft Wiki ]]
+
  
* Help with Search in Typecraft data
+
When the phrase opens, a dialogue window pops-up with the following message:
  
* Help with Editing the TypeCraft wiki
+
  '''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.
  
==Help with the TC Editors==
+
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.  
===Annotation using the TypeCraft 2.0 editor=== 
+
  
RECOMMENDED
+
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.  
         
+
===Annotation using the TypeCraft 1.0 editor===
+
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.
+
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,
+
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
+
to select one of the ISO language names. 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.
+
  
'''Tokenization'''
+
*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.
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.
+
  
'''Morph break-up'''
+
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.
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.
+
  
'''Annotation Table'''
+
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]].
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.
+
  
===Export===
+
===Search for Interlinear Glossed Text in the TC database===
The TypeCraft user-interface allows for several forms of export:
+
You enter the search facilities by clicking on '''TypeCraft Menu''' -> '''TypeCraft Search''', from which you have access to '''Text search''' and '''Phrase search'''.
  
* Export to the TCwiki
 
* Export to HTML
 
* Export to WORD and Open Office
 
  
In your TypeCraft Editor go to the tab *Phrase* in the upper left corner of your editor window. When pressing on *Phrase* a drop-down window opens. Select the first option which is: *Export*. 
+
====Text search====
 
+
====Export to the TCwiki====
+
 
+
For a description of the export to the TCwiki, please follow this link: [[TypeCraft Export|Export to the TC wiki]].
+
 
+
===Export to WORD and Open Office===
+
The export to WORD or Open Office is done through several simple steps:
+
Go to the TypeCraft Editor by opening *My texts*. You select one of your texts and open it. This can look for example like this:
+
+
  
[[File:Export.png|thumb|500px|left|click on the picture to enlarge]]
+
Text search allows you to find Interlinear Glossed Texts in the TypeCraft IGT database.
  
As shown in the picture on the left, you can now select the sentences that you would like to export by marking them in the check boxes on the left of the instantiated sentences (the blue sentences to the right of the Editor window).
+
[[File:Search1.jpg|thumb|700px|left]] 
Go to the tool tabs of the Editor window and select Phrases -> Export -> HTML (just as it is shown in the picture). You have the choice of exporting the examples with or without border. Make your choice and save the Tc-export file to your computer. (You will see a small pop-up window that asks you to either open or save the Tc-export file. You should save the file.)
+
When you now open the exported file on your machine, the default option that you will be presented with is to open the file in your browser (for example Firefox,Chrome, IE or Safari). In order to save the Tc-export file as a WORD or Open Office document you have to open the file by choosing the option *Open with* -> WORD or Open Office. Notice that the imported examples can still be manipulated. For example you might want to change the font size or highlight certain glosses, add colour or borders.
+
  
===Share your text with a group===
+
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
This is a feature of your TypeCraft editor that must be set by the [mailto:ldd.workshop@hf.ntnu.no system administrator]. In your mail to the administrator, please state which name you wish for your group (for example the name of your project or the name of the language you work on), and the TypeCraft user names of all members of the group that you would like to start. The system administrator will create the group for you. This will not take very long, and when the group is created, you can start to assign texts to your group, by selecting in your TypeCraft Editor from the *Share with group* line your group.
+
only in your own data, or if you intend a general search in TypeCraft data.
  
==Help with the TCwiki==
+
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.
  
===How to start a TCwiki-page===
+
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.
  
There several ways to start a new page in the TCwiki:
+
Also strings or sub-strings contained in the Note field can be used to search for texts.
  
* Write the name of the page you want to create into the search-box on your navigation bar. You write for example: '' Noun Phrases in Luganda''. Then press *GO*. A special page opens for you. It mentions ''Search Results''. If there does not yet exist a page with the title you choose for the page you are about to create, the search result is empty, and it says:"There is no page titled "Noun Phrases in Luganda. You now can create your page." That means that nobody else on the TCwiki has written about Noun Phrases in Luganda using the same title as you plan to use. The text: "You can create this page" is a link. Press this link. A new page appears with the title: ''Editing Noun Phrases in Luganda''. On top of this page you see a tool-bar. Go there and press the button *CREATE*. You now have created that page and can start to edit it.
+
Go to the [[:Special:TypeCraft/SearchText/ |Text search]] on your navigation bar to look for the other search options.
  
* Another way to create a new page is to start that page from your homepage at TC. You go to your homepage by pressing on your name in the upper right corner of your browser window. Remember you must be logged in to edit the TCwiki. On your homepage you go to the tool-bar above your page and press the *EDIT* button. You see a white field with the text and other material that you have put on your homepage. Go to the tool-bar right above your edit-box. The third button from the left is the button that creates an internal link for you. Press that button. The following code will be appear in your edit box: <nowiki>[[Link title]]</nowiki>. Replace the text ''Link title'' by the name of the page that you would like to create; so ''Noun Phrases in Luganda''. Save your page and press the internal link that you just created. Again you come to a page called 'Editing Noun Phrases in Luganda', and again you want to go to the top of that page and press the button *CREATE*. You now have created that page and can start to edit it. Notice also that this new page in now linked to your homepage.
+
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).
  
===Help with editing in the TC wiki===
 
The TCwiki is a customised mediawiki. Mediawiki has published a series of good Editing User's Guide that you can access by following the links below.
 
  
A quick reference guide can be found here: [http://upload.wikimedia.org/wikipedia/meta/e/e7/MediaWikiRefCard.png  Reference Sheet]
 
(You can enlarge the reference sheet by clicking on it!)
 
  
*General editing help for beginners can be found here: [http://meta.wikimedia.org/wiki/Help:Editing User's Guide]
+
====Phrase search====
* How to integrate pictures into your wiki page is explained here: [http://en.wikipedia.org/wiki/Wikipedia:Picture_tutorial Picture tutorial]
+
* How to edit tables can be found here: [http://www.mediawiki.org/wiki/Help:Tables#XHTML_attributes  Tables tutorial]
+
* How to integrate a google map into your page is explained here: ...more follows...
+
  
===How to find things in the TC wiki===
+
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.
The easiest way to find things on the TCwiki is to use the search window on the navigation bar. Type for example *annotation* and click *GO*. You will get up many pages containing the word ''(A,a)nnotat...'' in the page title.
+
  
THe scope of you search depends on in which namespace you search. For the search in the TCwiki it might be best to search in the following four
+
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
namespaces:
+
for the 3SG and PRES gloss tags relative to the English verb suffix ''-s'' in the word ''goe-s''.
[[File:Preferences.png|thumb|400px|left|click on the picture to see a larger version]]
+
  
* Main
+
You might instead define that certain search terms should occur on the same word, or occur in the same phrase.
* User
+
* TypeCraft
+
* Category
+
* Classroom
+
  
You customise your search by going to *my preference* in the right upper corner of your browser window. Select my preferences -> User profile -> *SEARCH*. Select the relevant namespaces by ticking of boxes. Save your preferences.
+
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.
  
===How to write an e-mail to another TypeCraft user===
 
Many TypeCraft users have enabled a function called ''enable e-mail from other users''. If you have not done that yet, you can go so by going to *my preferences* which you find in the left upper corner of your browser, next to your name. When in *my preferences* scroll down to the section '' E-mail''.
 
  
In order to mail other users, go to the user's homepage. You find home pages by searching for the users name. A list of users that have entered data into the TypeCraft database can be found at [http://typecraft.org/tc2wiki/Special:TypeCraft/Contributors/TypeCraft_contributors TypeCraft contributors].
 
  
===Upload a file===
+
===Search in the TypeCraft wiki===
# Prepare the file for upload.
+
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.  
# In the [[Help:Navigation#Sidebar|sidebar]], under “{{lcfirst:{{int:toolbox}}}}”, click “'''{{int:upload}}'''.”
+
# Click “'''Browse'''” next to the “'''{{int:sourcefilename}}'''” to locate the file on your computer (the name of the “browse” button depends on your web browser).
+
# Change the '''{{int:destfilename}}'''” to something descriptive, if necessary.
+
# Fill in the '''{{int:filedesc}}''', if necessary.
+
# Click the '''{{int:uploadbtn}}'''” button.
+
  
If it is a large file, you may need to wait several seconds for the upload to complete.  
+
For further specification of the search domain, see [[Help:Searching_in_the_TypeCraft_Wiki|'''Searching''' ]].
  
The file has been loaded to the '''Gallery of new files''' under '''Special Pages'''.
+
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.
  
====Embed a file in your TCwiki page====
 
  
To embed your loaded file in a TCwiki page, you have to specify its file name inside of an internal link (<code>[[ ]]</code>). Thus, <code><nowiki>[[Media:test.pdf]]</nowiki></code> for example makes it possible to download the PDF document with the name ''test'' from your
 
TCwiki page.
 
  
===How to embed audio files in already existing pages===
+
===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.
  
You can play TyepCraft internal mp3 audiofiles by embedding the mp3 file into a TC wiki page.
+
Your files or the material that you provide in the Importer's text area will after import be accessible
You use the following notation: <nowiki><flashmp3>YOUR_FILE_NAME.mp3</flashmp3></nowiki>.
+
in '''*Your text*''' which you access from the TypeCraft navigation bar after login.
  
You choose ''edit'' for the page into which you would like to embed the audio, and embed the <nowiki><flashmp3>YOUR_FILE_NAME.mp3</flashmp3></nowiki> string at the place where the audio should appear.
+
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.
  
===How to edit the title of an already exiting article===
+
For a more detailed description of the TypeCraft Importer go [[Help: The TypeCraft Importer]]
You can change the title of your article my using the '''Move''' tab at the top of your wiki-page. When you press the tab a new window appears. The picture of such a page which you see to the right shows how to rename (=move) a page.
+
[[File:MovePage.png|thumb|200px|right|An example for renaming a page]]
+
In the field with the name: '''To new title:''' you fill in the new title of your page. You may also fill in a reason for renaming your page in the field below, but that is not obligatory. Press the '''Move''' button and you will come to a new screen which tells you that the page has now been 'moved' to the new title. The new title at this page is a link to your page. Pressing this link will bring you again to your page which now carries its new title.
+

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