Tools

1.1.4 Update Manager

1.2 Assumptions

(top)

2. Tools manager overview

tools_open.png

The opening screen is split in two parts, the menu part and the management part.

• Menu: The Menu part has two modes:
  • Task selection: You can select a specific management task, Translate Tool, Backup Tool, Log View and Update Manager. By clicking on one of the items it's chosen, becomes underlined and is opened in the managing part.
  • Managing a task: When Translate Tool, Backup Tool, Log View or Update Manager is chosen, its configuration fields become available.

(top)

3. Translate Tool

NEW USERS:

What you need to successfully translate

• You know how to type on a keyboard, how to use, for example, an e-mail program and send and receive e-mails, or browse on the Internet. That is, you must have basic computer skills.
• You need a connection to the Internet, preferably an ADSL or cable Internet connection. Better not use a telephone connection with a telphone modem. Translating takes time. That means that in the end, we end up with a fine translation and you end up with a huge telephone bill. That's not our intention!
• The computer must have a browser program, like Firefox, Inernet EXplorer, Safari, Opera or some other program which you use to look around on the Internet. You translate in your browser. By saving your work, you send what you have done from your computer to our server in the Netherlands. We do not put anything on your computer.
• To actually translate you have to login to the translation website. This is the login page: http://wyxs.net/was1/admin.php. Please, don't go there yet.
• You have received a username and password. If not, and you want to translate a part, please write to: or schoutdi at knoware dot nl.

When you have a login name and a passwordd, proceed as follows:

• Switch on your computer (Ah... it's already on) and start your web browser (Internet Explorer, Firefox, et cetera).
• Enter the the website log in page on:
  http://wyxs.net/was1/admin.php.

tools_translatee_tool_log_in.png

This is the login 'dialogue'; terrible computer jargon, used to describe a sort of communication or 'dialog' between a computer and its user.
Anyhow, enter your login name and password in the fiields. Below is an example. The password is invisible, you only see ********.

tools_translatee_tool_log_in_name_passw.png

After entering your login name and password, click the [OK] button. If you have entered the correct login name and password, you etner the Website@School Welcome page:

tools_translatee_tool_startcenter.png

In the upper left part of the screen, please click on the Tools Manager icon to open the Tools dialogue:

tools_translatee_tool_all_tools.png

In the Menu click on the Translate Tool link to open the Translate Tool dialogue, which is explained in the next paragraph.

NEW USERS:
Please read on.

3.1 Translate Tool Overview

You are now in the Translate Tool itself and can select a language:

tools_translatee_tool_open.png

Most times we will already have created the new language you are gointg to create.
Look for the name of the language in your language. Click on the language name you are going to translate, for example: Français (French).

NEW USERS:
Please read on by immediately going to paragraph 3.3 Translate a language (please click the link).

Explanation:

• Menu: The selected item is underlined. The other tools are greyed out, i.e. not accessible.
• Translate Tool: An overview of its options:
  • Add a language: Clicking on this link brings you to the Add a new language dialogue. Adding a language is discussed in section 3.2 Add a new language.
  • Pencil icon: Clicking on the pencil brings you to the Edit language properties dialogue. These options will be discussed below in sections 3.4 Edit language properties.
  • Language name: This link has the form:
    Lanaguagename (xx). The language name is shown in the name of that language in that language, So, not 'Polish', but 'Polski'. This options will be discussed below in section 3.4 Edit language properties.

3.2 Add a new language

tools_translatee_tool_add_language.png

Explanation:

• Language code (ISO 639): A two or three character code must be entered here that corresponds with the language to be created. For details on the country codes see: http://www.w3.org/WAI/ER/brIG/ert/iso639.htm to choose the correct code. Don't mind the 'obsolete' in the above web page; it works fine. For further details on this matter, see Wikipedia on http://en.wikipedia.org/wiki/ISO_639.
• Name (expressed in the language itself): Enter the name of the language, for example: Deutsch, Français, Polski.
• Parent language: The dropdown menu enables you to select a language (if available). By replacing these words and sentences, you replace the chosen language with the translation you make.
  If the default (none) is selected, English will be the parent language.

  NOTICE:
  Carefully choose the Parent language. The choise of the parent language (for example Español) is a permanent choise and cannot be changed.

• Mark the language as active: When the box is checked the language is selectable by the users in their language selection. See Account manager, section 3.2 Grant the user access permissions.
• Save: To save your results. After saving your work, the newly created language will appear in the list of languages, ready for further action.
• Cancel: To cancel your action and return to the Translate Tool overview.

When the results are saved, the language is added:

tools_translatee_tool_language_added.png

By selecting the (added) language, you can start translating. This is discussed in the next paragraph.

3.3 Translate a language

tools_translatee_tool_translate_language_new_user.png

In the Menu the different parts of Website@School to be translated can be selected. The selection is underlined General. That's the one to start with. By clicking the other blue links in the Menu, yoiu can translate other parts of Website@School.

On the right side of the Menu, the Translation for 'Language-'Part' can be seen. Below, as example, French:

NEW USERS: Do not be frightended by by the text below. It is difficult indeed and we can explain it via mail or Skype. Just start translating and forget the '~' (tilde) stuff for the moment. Your translation is more important! We will come back on the tilde stuff later. Pleas do read about things not to touch, like texts in RED.

Translation for Français (fr) - General

NOTICE:
The best way of working is to not even touch things like {HOTKEY}, {SITENAME}, {ALERTS}, etcetera. In short: stay out of stuff in RED!

Also note the '~' (tilde) is used as a shorthand notation to define hotkeys in dialogs. For example, a field labeled ~File could be selected by pressing the keycombination [Alt-F] or [Cmnd-F]. The German translation could be ~Datei, with hotkey [Alt-D] or [Cmnd-D].
It is important that a hotkey is unique within a dialog, i.e. if you, the translator, have used the letter D already in that dialog, your German translation might become Dat~ei, yielding hotkey [Alt-E] or [Cmnd-E].
In short: it is up to you, the translator, to choose a good set of hotkeys by carefully placing the tildes.

NEW USERS: Do not be scared by this text above. It is difficult indeed and we can explain it via mail or Skype. Just start translating and forget the '~' (tilde) for the moment. Your translation is more important! We will come back on the tilde stuff later.

tools_translatee_tool_translate_language_top.png

Let's take, as example, sentence number 2:

tools_semtemce2_en+es.png

The first line is in English. That's the basic language, the mother language of Website@School.
The second line is the line to be translated. It is now in Spanish. That was the language the translator of French prefeered to replace with French words. This language was selected for you when we created your account. It cannot be changed any more.

Another example. It could be that the picture above is also fine for a translator who understands Spanish and a bit of English. She can now replace the language in Chinese, by replacing the Spanish text:

tools_semtemce2_en+zh.png

You also see text and signs in RED or something like {MIN_LENGTH}, {MIN_DIGIT} and similar stuff. Please, please, when translating leave those parts untouched. It is computer code! Here is an example:

tools_translatee_tool_translate_language_red_text.png

NOTICE:
Please save often (every quarter of an hour or even more). This is done by going to the bottom of the page and clicking the [Save] button. Remember, your work is only on your computer and has to be send to the server sonwhere in Amsterdam, the Neterlands. It would be a small disaster if you haave translated for a couple of hours and the connection was lost during translating. All your precious work gone!

NOTICE:
Saving takes time. Please wait.

After saving your text, you can continue translating untill that part is done. At the bottom of the text you can send notes to us:

tools_translatee_tool_translate_language_bottom.png

Explanation:

• Submit this translation: Leave this option checked. Better submit a an unfinished translation than to forget it accidentally.
• Translator name: Enter your name here.
• Translator email address: Enter your email address, so we can reach you if necessary.
• Translator notes: Space for your own notes or message(s) to us.
• Save: To save your results and submit the translation. After saving you stay in the same dialogue.
• Cancel: To cancel your action and return to the translate tool overview.

Now please read what is on top of the page where you started. Here is that difficult text again:

Translation for Français (fr) - General

Also note the '~' (tilde) is used as a shorthand notation to define hotkeys in dialogs. For example, a field labeled ~File could be selected by pressing the keycombination [Alt-F] or [Cmnd-F]. The German translation could be ~Datei, with hotkey [Alt-D] or [Cmnd-D].
It is important that a hotkey is unique within a dialog, i.e. if you, the translator, have used the letter D already in that dialog, your German translation might become Dat~ei, yielding hotkey [Alt-E] or [Cmnd-E].
In short: it is up to you, the translator, to choose a good set of hotkeys by carefully placing the tildes.

Maybe, after having translated a bit, i.e. have some working experience, the text is not that difficult to understand. If not, please mail us so we can help you.

We thank you on behalf of every pupil, parent, teacher and school in your country. You do a wonderful job for them.

3.3.1 Tips for tranalstors

DE: Geben Sie Ihre E-Mail Adresse an, und Ihr momentan gültiges Passwort wird an die Kontakt E-Mail Adresse geschickt.
HU: Írd be az e-mail címedet és hamarosan megkapod e-mailben a jelszavadat.

Please also read on http://wyxs.net/was1/ the page 'Tips'. It might contain last minute information provided by one of your colleagues.

You can also look on the internet (Goole is your friend) for computer terms dictionaries. Or ask help from another teacher or a neighbour. Everyone, like you, wants to help education.

NEW USER:
Dear new user, here ends the manual part for new translators. When you have questions, please mail us.

3.4 Edit language properties

tools_translatee_tool_edit_language_properties.png

Explanation:
NOTICE: This dialogue is the same as the Add a language dialogue. You can correct errors in the name of the language and change 'active'. The language code and parent language cannot be changed.

• Language code (ISO 639): The chosen language code cannot be changed. This is a feture.
• Name (expressed in the language itself): Errors can be corrected.
• Parent language: Once chosen, the parent language cannot be changed.
• Mark the language as active: When the box is checked the language is selectable by the users in their language selection. See Account manager, section 2.3 Give the user privileges.
• Save: To save your results. After saving you return to the Translate Tool overveiew.
• Cancel: To cancel your action and return to the Translate Tool overview.

3.5 Small language adaptations

• Go the the right place for the text you want to channge.
• Make the changes and save them.
• Log out and in.
• Inspect the changes.
• Send them to us.

(top)

4. Backup tool

4.1 Database backup

tools_backup_tool_open.png

Explanation:
To create a backup, proceed as follows:

• Click on the link 'Download Backup'.
• A window on your own computer opens.
• Select a directory to save the backup. The backup has a name like:
  exemplum.eu-was-was-20110104-185127.zip Which reads as: [ebsite]-[database name]-[prefix]-[YYYMMDD]-[hhmmss].zip.
• Ready!

4.2 Data backup

All docs and pics are not backed up.
They are in the CMS data foler. Example:
/home/httpd/wasdata/md5/ 

(top)

5. Log viewer

tools_log_viewer_open.png

(top)

6. Update manager

Download the upgrade (either a program update, or a manual, language or module update ) and unzip or untgz jin the CMS Root Folder. After unzipping, log in wiht the root account (webmaster, Wilhelmina Bladergroen). For a core update you are directly sent to the Update Manager dialogue.
For other updates, go Tools > Update manager.

6.1 Core update

Log in as webmaster to be directed to the Update Managerdialogue:

tools_update_manager_core_update.png

Depending on the performed upgrade differences in internal and external version numbers can be observed, as well as, in the Status column Update:

tools_update_manager_core_updated.png

WRONG PIC

After pressing the Update link, the internal and external versn numbers correspond and your Website@School is updated, up and running.

NOTICE:
Further information on the internal version number can be found in chapter Configuration Manager, paragraph 6. Site

6.2 Other updates

tools_update_manager_language_update.png

(top)

7. Concluding remarks

(top)