Typecraft v2.5
Jump to: navigation, search

Difference between revisions of "Help:QuickStart"

(This is the TypeCraft QuickStart Guide)
Line 5: Line 5:
 
=This is the TypeCraft QuickStart Guide=
 
=This is the TypeCraft QuickStart Guide=
  
For more information about linguistic online editing with TypeCraft, search in the TypeCraft database, exporting TypeCraft data, oe editing the TypeCraft wiki, please consult
+
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:
 
one of the following TypeCraft wiki pages:
  
Line 22: Line 22:
 
===Annotation using the TypeCraft 2.0 editor===   
 
===Annotation using the TypeCraft 2.0 editor===   
  
RECOMMANDED
+
RECOMMENDED
 
            
 
            
 
===Annotation using the TypeCraft 1.0 editor===
 
===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.  
 
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 morpheme boundaries at this point. At this point the TC Editor only accepts text strings.Before you start to tokenize your text strings,
+
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
 
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 selecting 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.   
+
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'''
 
'''Tokenization'''
You can tokenise your text into sentences. This generally works quite well. TypeCraft has at this point still problems with periods 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.   
+
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.   
  
'''Morpheme break-up'''
+
'''Morph break-up'''
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 morpheme boundaries into the annotation table.
+
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'''
 
'''Annotation Table'''
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 appears when you click on the field in these 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.
+
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===
 
===Export===

Revision as of 19:26, 21 September 2014


This is the TypeCraft QuickStart Guide

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 Search in Typecraft data
  • Help with Editing the TypeCraft wiki


Help with the TC Editors

Annotation using the TypeCraft 2.0 editor

RECOMMENDED

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 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 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 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

The TypeCraft user-interface allows for several forms of export:

  • 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*.

Export to the TCwiki

For a description of the export to the TCwiki, please follow this link: 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 on of your text and open it. This can look for example like this:


click on the picture to enlarge

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). 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 to export 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

This is a feature of your TypeCraft editor that must be set by the 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.

Help with the TCwiki

How to start a TCwiki-page

There several ways to start a new page in the TCwiki:

  • 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 exit 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.
  • 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 you homepage you go to the tool-bar above you 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 you 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: [[Link title]]. 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.

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: Reference Sheet (You can enlarge the reference sheet by clicking on it!)

  • General editing help for beginners can be found here: User's Guide
  • How to integrate pictures into your wiki page is explained here: Picture tutorial
  • How to edit tables can be found here: Tables tutorial
  • How to integrate a google map into your page is explained here: ...more follows...

How to find things in the TC wiki

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 namespaces:

click on the picture to see a larger version
  • Main
  • 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.

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 TypeCraft contributors.

Upload a file

  1. Prepare the file for upload.
  2. In the sidebar, under “tools”, click “Upload file.”
  3. Click “Browse” next to the “Source filename:” to locate the file on your computer (the name of the “browse” button depends on your web browser).
  4. Change the “Destination filename:” to something descriptive, if necessary.
  5. Fill in the “Summary”, if necessary.
  6. Click the “Upload file” button.

If it is a large file, you may need to wait several seconds for the upload to complete.

The file has been loaded to the Gallery of new files under Special Pages.

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 ([[ ]]). Thus, [[Media:test.pdf]] 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

You can play TyepCraft internal mp3 audiofiles by embedding the mp3 file into a TC wiki page. You use the following notation: <flashmp3>YOUR_FILE_NAME.mp3</flashmp3>.

You choose edit for the page into which you would like to embed the audio, and embed the <flashmp3>YOUR_FILE_NAME.mp3</flashmp3> string at the place where the audio should appear.

How to edit the title of an already exiting article

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.

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.