History: collaborative_terminology_platform_include_user_guide

View page

Source of version: 88 (current)

!Still to be done
^__IMPORTANT MESSAGE: installation of this profile is not yet over.__

Next steps are described at the bottom of the ((Admin Guide-- Collaborative Terminology Profile|administrator guide)) (section __Finalizing installation of the terminology profile__). Instructions in the present box should then be deleted (but instructions on the ((Admin Guide-- Collaborative Terminology Profile|Administrator's Guide)) should be preserved for future reference.^

{maketoc}

!Instructions for new users
This site supports multilingual collaborative terminology. If this is your first time here, please register so that you can  [#Specifying_your_language_preferences|specify your language preferences].

Specifying your language preferences allows for the display of records side by side in your first two preferred languages (the wiki allows for more than two languages at once).

First, register:
* Click on the __Register__ link.
* Fill-in the form and click on the __Register__ button.
* One or two minutes later, you will receive an e-mail with a confirmation link. Click on that link.
* Now that you are registered, you may [#Specifying_your_language_preferences|specify your language preferences].

Please note that registration alone does not give you the right to modify records. One of the administrators may add you in the list of the __Editors__  if it is necessary. If you think you should be an editor, please [#Contacting_the_administrators|contact the administrators].

!Specifying your language preferences
If you work mostly in a few languages (e.g. English and French), then you should specify your language preferences. The advantage of doing this is that when displaying a term in multiple languages, the system put your first two preferred languages side by side, for easier comparison.

Note however that you must first [#Instructions_for_users_who_have_just_registered|register on the site].

To change your language preferences:
* [tiki-user_preferences.php|Go here] (or click on the link __Preferences__ of the left menu)
* Choose your mother tongue as your __Preferred language__, instructions of the site will then be displayed in that language. 
* Click on __Can you read more languages?__
* Click on __Select language....__, and then on your second language.
* You can repeat that step to add additional languages. Make sure you add the languages in the order that you most frequently use them.
* Click on the __Change preferences__ button located at the very bottom of the page.

!Searching for a term
To search a term:
* Type the term in the __Search a term__  field of the __Terminology__ module (usually located on the top right corner).
* Select the the language for the search.
* Click on the __Go__ button.

If only one term is found, it is automatically displayed.

If you specified a second language in your [#Specifying_your_language_preferences|language preferences], the system will display the terms side by side in those two languages.

When the system finds more than one term, it will displays the list of all terms matching your query.

!Modifying an existing term
First, you must [#Searching_for_a_term|search for a term].

Then, simply click on the  __Modify__ button located under the term you want to modify.

If you do not see the __Modify__ button, it means you are not in the __Editors__ group. If you think you should be allowed to modify the records, please [#Contacting_the_administrators|contact the administrators] and ask them to add you to that group.

!Creating a new term
To create a new term in a given language:
* Type the term in the __Search a term__ field of the __Terminology__ module (usually located on the top right corner).
* Click on the __Go__ button.
* If the term does not already exist, a button starting  with caption __Create the page__ appears.  Click on that button.
* This will create a page pre-filled with template fields.  Simply fill the provided fields. For example, if you want to add a definition, simply erase the word __None__ (located at the right of the __~np~__Definition__~/np~__ tag), and replace it by your own definition.

^__Tip:__ The content of a terminology entry uses something called "wiki markup", to indicate where bold, italics, etc should appear. For example, the double underscores found in __~np~__Definition__~/np~__, simply indicate that this word should be displayed in bold. In general, you will not need to modify or use such markup to enter data into a term entry. If you see some markup that you do not understand, simply leave it as is. 

The one case where you may need to use wiki markups, is when you specify a new equivalent in the __Synonyms and Acronyms__ section. See [#Adding_more_equivalents_for_a_term|Adding more equivalents for a term] section for details.

If you wish to use markup inside a term entry, there are several buttons located above the edit box, which can help you (for example, if you select some text and click on the big __B__ icon, the appropriate markup will be inserted to make your selection bold).
^

!Creating an equivalent in another language
When a term has no equivalent in a target language, you may proceed as follows:

* Go to the chosen term.
* Click on the __Translate__ button located under the term.
* Select the language for the new equivalent in the __Language of the new page__ list.
* Enter the equivalent in the  __Name of the new page__ field.
* Click on the __Create the translation__ button.
* Delete the __Translation in progress__ mention.
* Write over or simply rewrite from scratch as you prefer.
* Click on the __Translation complete__ button.

^__Note:__ When you create a record based on existing content from another language, field names will remain in that language, unless you translate them yourself. 

For example, if you create a record based on a French record, the __Definition__ field will appear as __DÃ©finition__ (i.e. with an accent).

The system will be modified in a near future, so that it translates the field names automatically.^

!Asking a question:
If you want to know how a term translates in a given language, you have two options:

__Option 1:__ Ask your question on one of the [tiki-forums.php|forums]. Once you know the answer, you may also wish to help the community by creating a page for this term. See section  [#Creating_an_equivalent_in_another_language|Create an equivalent in another language].


__Option 2:__ Go to the term's page in the source language (or [#Creating_a_new_term|create it] if it does not already exists), and add a comment asking for the equivalent in the target language. Click on the "watch this page" icon (the eye located at the top of the page) to tell the system that you want to be notified when this page is modified. The system will notify you when the record is modified, including when someone answers your comment.

^__Note:__ If you cannot create a message in the forum or insert a comment, it means you are not member of the __Editors__ group. If you think you should be par of that group, please [#Contacting_the_administrators|contact the administrators]^

!Adding more equivalents for a term
If you know another translation for a term found, you can proceed as follows.

Simply modify the page for this term and add an alias in the section __Synonyms and Acronyms__.

To add an alias, you must enter ~np~(alias(other equivalent))~/np~, where "alias" is the word "alias" as such, while "other equivalent" is the new equivalent you want to add.

As an example, if you see a page "email client" and want to add "email reader", you modify the page "email client", and add ~np~(alias(email reader))~/np~.

^__Note:__ Do not put spaces between the word __alias__ and the opening parenthesis.^
!Creating a record for a different meaning of an existing term
Very often, meaning of a term will be different according to the context or the domain. However, in the terminology tool that you are currently using, each word or expression is associated to a given record, and each record can only define one and only one meaning.

To deal with that while achieving the goal of having two records, simply create a new record for the new meaning. The name of the new record will have to be different from the existing one, which can be achieved by adding a few words prefixed by a double dash to avoid the ambiguity.

For example, suppose you want to create a record for term "terminal", in the context of transportation (i.e., the place where people get in or out of an aircraft or train), but find that you already have a record for "terminal" which captures the meaning of that word in the networking context (i.e., a node of a network).

You would create a term called "terminal~np~ --transports~/np~", and write the appropriate definition in it. It might also be a good idea to rename the other record from "terminal" to something like "terminal~np~--computer science~/np~" (simply go to the "terminal" record and click on the __Rename__ button).

^__IMPORTANT: Do not use parentheses!!!__

Avoid creating a term such as "terminal (computer science)", as it is likely to cause problems. In particular, it will make it impossible to create hyperlinks to that term.^

!Contacting the administrators
Documentation to come...

Latest Changes

...more

Like almost all *.tiki.org sites, you can log in with your login from https://tiki.org (register over there)

Search

Most Popular Tags

admin agenda alias antibot antibot captcha app archive articles banning batch blogs calculations calendars cart categories cluster codemirror comments computation contact us datachannel debug debug console dropdown with other error messages features file galleries forums geo geocms geolocation group homepages group watches header i18n images item link items list jquery languages location map maps maths menu menupage multilingual ol3 ol5 openlayers paypal plugin plugin alias plugin datachannel plugin fade plugin tabs plugin trackerlist pretty trackers print project management r r project realnames rss static static text statistics stats structures syntax highlighter tablesorter template trackers user watches visualization watches webservice wiki wiki argument variables wiki structures

History: collaborative_terminology_platform_include_user_guide

Source of version: 88 (current)

Menu

Current Profiles

Latest Changes

Search

Most Popular Tags

About Tiki

Support

Community

Documentation

Development

Legal

Tiki Project Sites

Networks

History: collaborative_terminology_platform_include_user_guide

Source of version: 88 (current)

Menu

Current Profiles

Latest Changes

Search

Most Popular Tags

Tiki Newsletter

About Tiki

Support

Community

Documentation

Development

Legal

Tiki Project Sites

Networks