Difference between revisions of "Translating with Pootle"

From Creative Commons
Jump to: navigation, search
m (hugenghilman)
Line 12: Line 12:
 
* [[CcHost|ccHost]]
 
* [[CcHost|ccHost]]
  
= Setting up your account =
+
= Atur akun milik Anda =
  
The next two subsections explain how to properly register with Pootle. If you already have an account that lets you translate or make suggestions, skip to section 2, "Making translations and suggestions." (In this document, we italicize things to look for, like ''button names'' or the words ''used in a link'', and we mark '''page names''' in bold.)
+
Dua seksi berikut menjelaskan bagaimana mendaftar dengan baik dengan Pootle. Jika Anda siap mempunyai akun yang akan membuat anda menerjemahkan ata membuat sugesti, lewati seksi 2, "Makin translation and suggestion." (Pada dokumen ini, kami menulis dengan huruf miring seperti yang dilihat ''button names'' atau kata ''gunakan link'', dan Kami tandai '''nama halaman''' dengan huruf tebal.)
  
== Creating an account ==
+
== Membuat akun ==
  
Before you can contribute translations or suggestions, you need to create an account. Go to http://translate.creativecommons.org and click the ''Log in'' link in the upper right-hand cornerEnter your desired username and password and click ''Register''. This will take you to the full registration page, which will ask you for your password again, your full name, and your email address. Click ''Register'' once more, and Pootle will send an activation code to the email address you specified. Follow the link to the activation page, and copy your activation code into the ''Activation Code'' box. Click ''Activate Account'', and your account is now activated.
+
Sebelum Anda bisa ikut serta menerjemahkan atau saran, Anda membutuhkan untuk membuat akun. Tuju ke http://translate.creativecommons.org dan klik ''Log in'' link pada bagian pojok atas sebelah kananMasukkan username yang diinginkan dan password dan klik ''Register''. Ini akan mengantarkan Anda ke registrasi halaman penuh, yang mana meminta password anda kembali, nama lengkap Anda dan alamat email anda. Klik ''Register'' sekali lagi, dan Pootle akan mengirimkan kode aktivasi ke alamat email anda secepatnya. Ikuti link ke aktivasi halaman, dan kopi aktivasi kode anda ke ''Activation Code''. Klik ''Activate Account'', dan akun anda  sekarang diaktifkan.
  
Now you can log in by clicking the ''Log in'' button in the upper-right corner.
+
Sekarang Anda bisa masuk dengan menekan tombol ''Log in'' disebelah pojok atas bagian kanan.
  
== Your user page ==
+
== User page Anda==
 
 
Every time you log in, you will be taken to your user page:
 
  
 +
Setiap kali Anda masuk, Anda akan diantarkan ke user page milik Anda:
 
[[Image:Pootle_user_page.png|frame|A clean user page in Pootle.]]
 
[[Image:Pootle_user_page.png|frame|A clean user page in Pootle.]]
  
If you would like to translate a particular language or project, you need to let us know by choosing it in your user preferences. You must do this before we can grant you permissions to save and commit your work.
+
Jika anda akan melakukan penerjemahan bahasa khusus atau proyek, Anda butuh untuk mengikutkan kami mengetahui yang Pilih pada user preferences. Anda harus melakukan ini sebelum kami memberikan hadiah atas persembahan Anda untuk menyimpan dan memasukkan pekerjaan Anda.
 
+
Untuk melakukan hal itu, lihat kolom Quick Links pada sebelah kiri halaman "My Account". Karena Anda tidak bisa menetapkannya, Pottle berkata kepada anda ''Pilih bahasa dan proyek anda''. Ini mengambil tempat yang sama pada link ''Save options''. Ini mengantarkan anda ke '''Page options'''.
To do that, look in the Quick Links column on the left side of your "My Account" page. Because you have nothing specified yet, Pootle tells you to  ''choose your languages and projects''. This takes you to the same place a the ''Change options'' link. This takes you to the '''Options page'''.  
 
  
 
[[Image:Pootle_options_page.png|frame|A blank user options page in Pootle.]]
 
[[Image:Pootle_options_page.png|frame|A blank user options page in Pootle.]]
  
There are three sections to this page, each with their own separate ''Save changes'' buttons. This is a little counter-intuitive.
+
Disana terdapat tiga seksi halaman ini, tiap-tiap memiliki halaman terpisah sendiri ''Save options''. Ini adalah perhitungan intuitif.
 
+
''Personal Details'' merupakan seksi yang akan membiarkan Anda mengganti relasi informasi untuk mengetahui bagaimana log in ke Pootle. Jika Anda membuat berbagai perubahan, yakinlah untuk menekan ''Save changes'' dan yakinkan sekali lagi setelah halaman dimuat ulang.
The ''Personal Details'' section lets you change information related to how you log in to Pootle. If you make any changes, be sure to hit ''Save changes'' and ensure they appear again after the page reloads.
 
 
 
The ''Translation Interface Configuration'' section is worth a look. We urge you to configure an ''alternative source language''. Pootle generally shows you the English text when doing translations; the language you choose here as an alternative source will appear underneath the English. This can be very useful if you are, for example, localizing Spanish into Colombian Spanish, or if you are fluent in two languages. Again, if you make changes, be sure to ''Save changes''.
 
  
The ''Projects and languages configuration'' section is crucial.
+
Seksi ''Translation Interface Configuration'' terlihat berharga. Kami menginginkan anda untuk  mengatur ''sumber bahasa alternatir''. Umumnya Pootle memperlihatkan kepada anda teks berbahasa Inggris ketika melakukan penerjemahan; bahasa yang anda pilih disini adalah sumber alternatif dalam bahasa Inggris. Ini akan sangat berguna, sebagai contoh, melokalkan bahasa Spanyol ke Bahasa Kolombia, atau jika anda lancar dengan keduanya. Sekali lagi, jika anda membuat perubahan yakinkanlah diri Anda untuk menekan ''Save changes''.
  
Select all the ''projects'' you are interested in. (You can choose more than one by pressing and holding Ctrl on the keyboard and clicking on many, or by just dragging the mouse over the ones you want to select.) We suggest choosing all of our projects. Do the same to select the ''languages'' you wish to translate. '''Note''' that we cannot grant you special privileges on a language until you have selected it here.
+
Seksi ''Projects and languages configuration'' adalah kritis.
  
(Languages currently need to be assigned to projects by server administrators. If you are interested in translating a project into a new language, or adding a completely new language, email the project you're interested in and the language to webmaster@creativecommons.org.)
+
Pilih semua ''projects'' yang anda inginkan. (Anda bisa memilih lebih dari satu dengan menekan dan menahan tombol Ctrl pada keyboard dan klik lebih banyak, atau hanya mendrag keseluruhan mouse lebih dari satu yang anda pilih.) Kami menyarankan anda memilih semua proyek kami. Melakukan pilihan ''languages'' yang ingin diterjemahkan.  '''Note''' yang tidak bisa Kami berikan hadiah sebagai kehormatan spesial sampai anda memilihnya disini.
 +
(Bahasa saat ini butuh persetujuan oleh server administrators. Jika anda senang menerjemahkan proyek kebahasa baru atau menambah dengan lengkap, email proyek yang anda inginkan ke  webmaster@creativecommons.org.)
  
 
= Making translations and suggestions =
 
= Making translations and suggestions =

Revision as of 10:51, 23 February 2009


Creative Commons uses the online tool Pootle to manage translations of our software projects. The Creative Commons installation of Pootle is maintained at http://translate.creativecommons.org. This page describes how to use Pootle to edit translations, make suggestions, and see what the changes look like.

Applications currently managed by translate.creativecommons.org are:

Atur akun milik Anda

Dua seksi berikut menjelaskan bagaimana mendaftar dengan baik dengan Pootle. Jika Anda siap mempunyai akun yang akan membuat anda menerjemahkan ata membuat sugesti, lewati seksi 2, "Makin translation and suggestion." (Pada dokumen ini, kami menulis dengan huruf miring seperti yang dilihat button names atau kata gunakan link, dan Kami tandai nama halaman dengan huruf tebal.)

Membuat akun

Sebelum Anda bisa ikut serta menerjemahkan atau saran, Anda membutuhkan untuk membuat akun. Tuju ke http://translate.creativecommons.org dan klik Log in link pada bagian pojok atas sebelah kanan. Masukkan username yang diinginkan dan password dan klik Register. Ini akan mengantarkan Anda ke registrasi halaman penuh, yang mana meminta password anda kembali, nama lengkap Anda dan alamat email anda. Klik Register sekali lagi, dan Pootle akan mengirimkan kode aktivasi ke alamat email anda secepatnya. Ikuti link ke aktivasi halaman, dan kopi aktivasi kode anda ke Activation Code. Klik Activate Account, dan akun anda sekarang diaktifkan.

Sekarang Anda bisa masuk dengan menekan tombol Log in disebelah pojok atas bagian kanan.

User page Anda

Setiap kali Anda masuk, Anda akan diantarkan ke user page milik Anda:

A clean user page in Pootle.

Jika anda akan melakukan penerjemahan bahasa khusus atau proyek, Anda butuh untuk mengikutkan kami mengetahui yang Pilih pada user preferences. Anda harus melakukan ini sebelum kami memberikan hadiah atas persembahan Anda untuk menyimpan dan memasukkan pekerjaan Anda. Untuk melakukan hal itu, lihat kolom Quick Links pada sebelah kiri halaman "My Account". Karena Anda tidak bisa menetapkannya, Pottle berkata kepada anda Pilih bahasa dan proyek anda. Ini mengambil tempat yang sama pada link Save options. Ini mengantarkan anda ke Page options.

A blank user options page in Pootle.

Disana terdapat tiga seksi halaman ini, tiap-tiap memiliki halaman terpisah sendiri Save options. Ini adalah perhitungan intuitif. Personal Details merupakan seksi yang akan membiarkan Anda mengganti relasi informasi untuk mengetahui bagaimana log in ke Pootle. Jika Anda membuat berbagai perubahan, yakinlah untuk menekan Save changes dan yakinkan sekali lagi setelah halaman dimuat ulang.

Seksi Translation Interface Configuration terlihat berharga. Kami menginginkan anda untuk mengatur sumber bahasa alternatir. Umumnya Pootle memperlihatkan kepada anda teks berbahasa Inggris ketika melakukan penerjemahan; bahasa yang anda pilih disini adalah sumber alternatif dalam bahasa Inggris. Ini akan sangat berguna, sebagai contoh, melokalkan bahasa Spanyol ke Bahasa Kolombia, atau jika anda lancar dengan keduanya. Sekali lagi, jika anda membuat perubahan yakinkanlah diri Anda untuk menekan Save changes.

Seksi Projects and languages configuration adalah kritis.

Pilih semua projects yang anda inginkan. (Anda bisa memilih lebih dari satu dengan menekan dan menahan tombol Ctrl pada keyboard dan klik lebih banyak, atau hanya mendrag keseluruhan mouse lebih dari satu yang anda pilih.) Kami menyarankan anda memilih semua proyek kami. Melakukan pilihan languages yang ingin diterjemahkan. Note yang tidak bisa Kami berikan hadiah sebagai kehormatan spesial sampai anda memilihnya disini. (Bahasa saat ini butuh persetujuan oleh server administrators. Jika anda senang menerjemahkan proyek kebahasa baru atau menambah dengan lengkap, email proyek yang anda inginkan ke webmaster@creativecommons.org.)

Making translations and suggestions

This section covers the steps needed to make basic use of the Pootle translation service once you have registered.

Starting from the front page: Choosing what to translate

Be sure that you are logged in when you start translating.

When you load the Pootle front page, you will see a list of available projects and languages.

Project list displayed after logging into Pootle.

Every table on the front page has a neat feature: Click on a column, and the table will be sorted by that column. For example, after one click on "Overall completion" in the projects table, we see:

Projects list sorted by overall completion

One more click would reverse the order of the sort.

You can approach the task of translating either by starting with the languages you want to translate into, or by starting with the project you wish to translate.

The project page

We'll start by clicking on the cc_org project. Pootle presents us with the list of available languages for the project.

List of available languages for the cc_org project.

Click on the language you would like to work on translating. If you do not see the language you want to work on listed, see the instructions below on adding a new language.

Permissions

Note that by default, all you can do is make suggestions. If you want to be able to contribute translations without having someone else approve them, or if you want the ability to grant those privileges to tohers, please email us at webmaster@creativecommons.org.

The message catalogs page

When you click on the language you'll be shown a list of message catalogs (.po files) for the selected project. (Most projects have a single message catalog; ccPublisher has two; in that project, each is listed, along with links for translating them.)

Translation details and links for the project language.

The translation screen

If you want to edit or view all strings, you can simply click on the .po file you wish to edit. If you wish to view only the untranslated strings, click the link showing how many words are not yet translated. For this demonstration, we will review the untranslated strings.

Quick translating untranslated strings.

You can double-click any entry to quickly modify it (but note that your alternative source language will not appear). An untranslated string will be marked with Add translation. Once you have written a translation, you can Submit it (or suggest if you do not have translate privileges). The standard editing interface is always available from the Edit link on the right-hand side.

Language administrator tasks

There are a few things that only administrators of the language can do: accepting suggestions as translations, and committing translations to see how they look at staging.creativecommons.org.

Accepting suggestions

Handling suggestions in Pootle is very easy. If on in the translation screen you see a message reading, View Suggestions, you can click it to show the suggestions that have been made as well as the name of the user who made the suggestion.

The View Suggestions option available next to a message.

If you want to act on those suggestions, click the Edit link at the end of the row. This will bring you to the full edit screen with that message selected.

The edit screen with a suggestion visible.

You can click on the green check-mark or the red X; they will accept or reject the suggestion respectively. If you want to accept a modified version of the suggestion, you can click the green check-mark to accept the suggestion and then edit it in the translation field. Be sure to hit submit afterwards.

Creative Commons' "Staging" website

We run an experimental clone of the Creative Commons website at http://staging.creativecommons.org/. The cc_org translation catalog is made available in near-real-time in two places.

For both of these, appending ?lang=no lets you see the Norwegian translation; that should work for any short language code.

Committing translations

Language editors can use the commit facility in Pootle to permanently store their changes. Each commit is a permanent snapshot of the PO file. In addition, we only update staging.creativecommons.org once you commit.

As a result, the commit feature is very useful as as "preview" feature. To use it, you must have the commit privilege to a language in Pootle.

Start at the message catalogs page, as seen below:

The message catalogs page with Show Editing Functions highlighted

Follow the link to 'Show Editing Functions, and you arrive at a page like this:

The editing functions page

Click on "Commit," and after a somewhat substantial wait, you will see a message indicating that some files were committed. (If there are no changes, then Pootle will not actually perform a commit.) You can then expect that staging.creativecommons.org is up-to-date with respect to the language you are working on.

Pushing to the live site

WHen you are happy with your changes as they appear on staging.creativecommons.org, email webmaster@creativecommons.org to request that we update the main creativecommons.org website with your translations. You should expect a response saying it's done within a couple of work days at the longest.

Granting permissions

As a language administrator, you can grant privileges to other translators who have shown their ability to provide good-quality text. To do that,

Other information

Getting Help

If you have questions about using Pootle or about the translation process, you can ask in the IRC channel, or by sending an email to webmaster@creativecommons.org. If you are a CC affiliate on the CCi mailing list, you can use that instead.

Administering translations

Using suggestions

  •  ?