Loading...
 

Translating the Wiki

 

Summary

Translating the Wiki is a very simple process:

1. Log in to the wiki

2. Go to the English page you want to translate.

3. Switch to the version of the page in the target language. You'll see an already translated title and everything else will be in English.

4. Click Edit and edit the page.

5. Save frequently your work using the Save button at the bottom ( It's ok to save work-in-progress translations)

 

The detailed instructions on how to do each of the steps are outlined below with screenshots. Please note that at no point there's any need to do anything or click on anything not explicitly mentioned here. If something is not working as described in the guide, send us a note before continuing.

 

Logging In

Start by going to https://wiki.agoraspeakers.org. After that, click on the  "Member Login" button at the top (NOT the Login as admin)

 

Translations 01

 

You will be redirected to a Single Sign On page that looks like the screenshot below. Sign in with your user name and assigned password:

 

Translations 02

 

After signing in, you should be redirected to the wiki, and should be able to edit articles

Translating a Page

Most of the pages that need translation will already exist with a title in the target language and the core text in English. To translate a page, simply click on "Edit" at the bottom and translate the text inside.

For example, imagine that you want to translate the "Meeting Leader" page to German. You always start by going to the English page you want to translate. After going to that page, click on the "Translations" button and select the German language:

 

Translation New 0

 

Do not continue if you do not see the target language in that list. Instead, notify us that the page stub is missing.


Once you switch to the target language, you'll see a page that has some parts translated, but most of the text will be in English.

The title of the page to translate will always be in the target language, already translated. This is an indication that you're at the right place. If you instead see the title in English on in some other language that is not the one you're translating to, then you're not in the right place. 

If you do not agree with the translated title, send us a message before continuing.


In the example below, the title is the German  "Meeting - Leiter".

Translation New 1

 

Editing the page

Go to the bottom of the page and click on "Edit", then simply start translating the text. Please always observe the General Translation Guidelines.

You will also see that all pages have a text that says:

***English text below. Remove this message when translating, otherwise, the page may be overwritten:***

Please remove this text and save as soon as you start working on an article. This text is a marker that notifies our automated processes that it's safe to overwrite the article with a more recent version, so if you do not remove it, you risk your work being overwritten by our scheduled maintenance updates.

 

Translation New 2

 

Important: Make sure that you don't alter any special commands such as:

Translation New 3

Remember that if something goes wrong, you can always use CTRL-Z to undo an action, or simply cancel the edits and start anew.

Do NOT rename the title of the page, as that title is used elsewhere in the system and those references will become orphan. If you need to change the title of a page, or any other elements not directly on the wiki (such as texts in the automatically generated evaluation cards, or headers and footers of the different pages) please send us a note to info at agoraspeakers.org with a screenshot of what you want to change and the new translation you want to suggest.

 

Do not paste text into the wiki from other editors, unless they are plain text editors (such as NotePad). Especially, do not paste from Microsoft Word, Openoffice Writer,  or other similar Office-type packages. These programs add a lot of styling tags to the wiki that completely disrupt the rendering.

 

Saving your work

Saving is done via the Save button at the bottom of the page.

 

Translate 04

 

Save periodically and often. even if your translation is not complete.

Translating Image Captions

 

Sometimes inside the pages, you will see images that contain footers with text:

 

Translation 07

 

These need to be translated as well. To do that, double click on the image, and then translate the text in the "Caption" field (and copy and paste the translation into the "Alternate Text" field):

 

Translation 08

 

Translating Links

There will be many pages that have links to other pages in English.

In those cases, you only need to translate the text of the link. Leave the page to which the link points unchanged (i.e. : leave it pointing to whatever English page it was pointing to)

We have an automated process that will automatically fix all links to point to the corresponding translated page, once all the translation is finished.

To change the link text, either change it directly in the text itself, or you can select the link you want to translate with the mouse and click on the "Link" button in the Edit toolbar:

Translation 12

 

The link properties will appear, where you can change the text of the link and point to the translated equivalent of the original wiki page:

 

Translationa 13

 

Again, please remember that only the "Link Text" needs to be translated. Do not change the page it points to.

 

Images or Diagrams with embedded text

 

Sometimes, an image will have text on it, such as:

 

Translation 09

 

In this case, there are two possibilities.

  • At the bottom of the page, you'll see a section for translators with the source image files (usually Photoshop or Powerpoint). With them, you can edit the text and create a new image with the translation.
  • If you don't have access to the software used to create a translation, you can also send us a note with the translated words and we'll create a translated image with them. Please also send us the link to the wiki page where the image is present.

 

Switching to Source Code View

The editor has a "Source" code view that allows you to see the HTML code of the page being translated. Sometimes (for example when you're translating tables, or image captions, etc.) you may find it easier to work in that mode.  Also, if you use software that helps translations such as TRADOS or similar, you may find it easier in general to copy and paste the whole source into TRADOS as an HTML page, then copy the translated result back into the HTML source. Either way, make sure you don't modify any tags or special codes.

Source View

 

Important Information for RTL languages (i.e.: Urdu, Arabic, etc.)

If the language is written from Right to Left, the Wiki software should be able to handle it automatically.

Be extra careful not to insert text alignment tags anywhere.

 


Contributors to this page: admin , agora and puspa.khanal .
Page last modified on Tuesday May 25, 2021 12:37:50 CEST by admin.