Outdated version of the documentation. Find the latest one here.

Çeviri Kuralları

This manual is aiming to help the translator. First the general process of how technically a translation is done is explained. Later the translation is explained from an actual English rst document that is translated to Dutch. Finally a summary of Rules of translation is given.

Although these guidelines focus on QGIS documentation, the methods and the rules described below are also applicable to QGIS applications and website translation.

Çeviri işlemi

To create documentation first .rst documents are created. A prebuild script creates translation files named .po files for the english language in the folder /QGIS-Documentation/i18n/en.

Bu “orijinalleri” diğer diller için i18n klasörlere komut dosyası tarafından kopyalanan

The sentences in the .po files need to be translated from english to the language with a translation tool editor.

When you want to contribute, first get a .po file and add translations for the sentences in the .po file. When you are finished the .po file is placed back in the right place and during the next build the build script now creates .mo files next to the .po files. These .mo files are actually used by the script to create translated output.

When afterwards an rst document is updated a new .po file is created in the english part. The contents of this new file will be merged with already existing .po files for each language. This means that when a new line is added to an rst document that was already translated, only the new/updated sentences are added in the translated .po file and needs to be translated. The amount of work for updating translations for next versions of QGIS should be relative small.

QGIS in çevirisi için iki farklı araç kullanılıyor:

  • the Transifex web platform, the easiest and recommanded way to translate QGIS, transparently does the process described above and pulls all the translatable texts in one place for the translator. He then just picks the files he wants and does the translation
  • Qt Linguist, a Qt development tool that requires the translator to pick and replace the .po files from the source code.

Unutmayın hangi aracı kullanırsanız kullanın çeviri kuralları aynıdır.

Uyarı

An important note: If you want to translate content within the docs folder (not web), never do this in the master branch. For translations there are always translation branches available, once a document is fully updated in english for a certain version. As an example, to translate the manual of QGIS 2.8, you have to use the manual_en_v2.8 branch.

Bir dosya çevirin

Çeviri nasıl çalıştığını açıklamak için, bir örnek olarak İlgi haritası eklentisi kullanacak. Bu örnekte Hollandaca İngilizce’ den tercüme edecek, ancak tüm dillerde diğer belgeler için hemen hemen aynı olacaktır.

Belge kaynağı burada bulunabilir:

QGIS-Documentation/source/docs/user_manual/plugins/plugins_heatmap.rst

Peki neden bu belgeyi seçtin?

  1. It is considered finished for the current release. If it is not yet completed the following statement followed by an empty line can be found in the top of the document.

    |updatedisclaimer|

    This will produce a visible disclaimer in the output product. To start translating a document with an update disclaimer there is a good chance that later on it needs another finishing touch.

  2. It also includes images, captions, headers, references and replacements.

  3. Ben bu yüzden benim çevirmek için kolay yazdı;-)

İnşa işlemi için oluşturulan İngilizce .po dosyasına buradan erişebilirsiniz:

QGIS-Documentation/i18n/en/LC_MESSAGES/docs/user_manual/plugins/plugins_heatmap.po

Aynı Dutch .po dosyası (basit kopya) ya şuradan erişilebilir.

QGIS-Documentation/i18n/nl/LC_MESSAGES/docs/user_manual/plugins/plugins_heatmap.po

Bu dosyanın yanısıra henüz hiçbir çeviriyi tutmadığını gösteren bir küçük .mo dosyası göreceksiniz.

Transifex te Çeviri

In order to translate QGIS with Transifex, you first need to join the project. Once you got a team, click on the corresponding project and your language. You get a list of all translatable .po files. Click on the docs_user-manual_plugins_plugins-heatmap to select the heatmap plugin file and choose Translate in the prompted dialog. Note that you can also choose to download the file and translate it with tools like Qt Linguist. The next page lists all the sentences in the file. All you need to do is select the text and translate following the guidelines.

For further information on the use of Transifex Web Editor, see http://docs.transifex.com/tutorials/txeditor/.

Qt Dilbilimci çeviri

With Qt Linguist, you need to manually grab the .po file. When you open the file in Qt Linguist for the first time you will see the following dialog:

../../_images/linguist_choose_language.png

Select language for translation in linguist menu

Hedef dili doğru doldurulması gerekmektedir. Herhangi bir ülke dil POSIX ve Ülke / Bölge ile olduğu gibi Kaynak dil bırakılabilir.

When you press the [OK] button Qt Linguist is filled with sentences and you can start translating, see Figure_translation_menu.

../../_images/linguist_menu.png

Çeviri için dil menüsünü kullanınız

Uygulamalar için menüdeki görünen düğmeleri kullanın.

  • linguist_done_next The Translation Done Next button, is the most important button. If the item needs translation, you enter a translation in the text field, then hit this button. If the item does not need translation just leave the text field for translation empty and also hit this button which indicates the item is done and you continue with the next item.
  • Geri Git butonu linguist_previous önceki çeviri parçasına gitmek için kullanılabilir.

  • İleri Git butonu linguist_next, sonraki çeviri parçasına gitmek için kullanılabilir.

  • linguist_next_todo The Next Todo button, jumps to the first translation item that still needs a translation. Handy when the original document has changed and only several new/changed sentences need to be translated.
  • Önceki İşlem butonu linguist_previous_todo, geri arama yapar ve halen çevirilmekte olan ilk çeviri parçasına geçer.

Manuel çeviri

Şimdi plugin_heatmap kullanıcı dokümanını çevirmeye başlayalım.

Translating most of the sentences should be straightforward. During this translation session I will point out which parts (rst statements) need special translation.

Aşağıda, çevirmek ilginç bir cümle görüyoruz:

The |heatmap| :sup:`Heatmap` plugin allows to create a heatmap from a
point vector map. A heatmap is a raster map showing the density or
magnitude of point related information. From the result "hotspots" can
easily be identified.

Bu cümle iki rst ifadesi içerir:

  1. |heatmap|` kelimlerinde | arasındaki kelimeler simglerin yerini alıyor ve bunlar asla çevrilmemelidir! Bunun yerine, heatmap eklentisi simgesi yerini alacak!

  2. :sup:`Heatmap`, the :sup: statement is a superposition statement and prints the following text a bit higher. This is used to show the popup texts that appear when you hover above the toolbar item and this may be different when it is actually translated in the QGIS application. In the Dutch case it is not!

Bu cümledeki diğer tüm metinler çevrilebilir!

The next translation item contains the :ref: statement that is commonly used to refer to another section somewhere in the manual! The text following a :ref: statement should never be changed because it is a unique identifier!

First this core plugin needs to be activated using the Plugin Manager
(see Section :ref:`load_core_plugin`). After activation the heatmap icon
|heatmap| can be found in the Raster Toolbar.

In this case load_core_plugin is a unique reference identifier placed before an rst item that has a caption. The ref statement will be replaced with the text of the header and turned into a hyperlink. When the header this reference is refering to is translated, all references to this header will be automatically translated as well.

The next item contains the rst-tag :menuselection: followed by text actually displayed in a menu in QGIS application, this may be translated in the application and therefore should be changed when this is the case.

Select from menu :menuselection:`View --> Toolbars --> Raster` to activate
the Raster Toolbar when it is not yet activated.

In above item “View –>” is actually translated to “Beeld –>” because this is the translation used in the Dutch localized QGIS application.

Biraz daha ilerde çeldirici çeviri parçası ile karşılaşırız:

The |heatmap| :sup:`Heatmap` tool button starts the Dialog of the Heatmap
plugin (see figure_heatmap_settings_).

It holds a reference to a figure figure_heatmap_settings_, and like a reference to section this reference should not be changed!! The reference definition itself from the rst-document is not included in the .po file and can therefore not be changed. This means the reference to figures can not be translated. When HTML is created you will see figure_heatmap_settings. When a PDF document is created figure_heatmap_settings_ is replaced with a figure number.

rst özellikli sonraki çeviri parçası sıradaki parçadır:

**Input Point dialog**: Provides a selection of loaded point vector maps.

Do not remove the stars in above line. It will print the text it holds in bold. The text itself is often text included in the dialog itself and may well be translated in the application.

Sonraki çeviri parçası :guilabel: rst etiketi içerir.

When the |checkbox| :guilabel:`Advanced` checkbox is checked it will
give access to additional advanced options.

The text Advanced of the guilabel tag may well be translated in the QGIS application and probably needs to be changed!

The following translation item contains ``airports``. The quotes are used to give the text another text font. In this case it is a literal value and does not need translation.

For the following example, we will use the ``airports`` vector point
layer from the QGIS sample dataset (see :ref:`label_sampledata`).
Another excellent QGIS tutorial on making heatmaps can be found on
`http://qgis.spatialthoughts.com
<http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html>`_.

This item also includes a hyperlink with an url and an external presentation. The url should of course be left intact, you are allowed to change the external text http://qgis.spatialthoughts.com which is visible by the reader. Never remove the underscore at the end of the hyperlink which forms an essential part of it!!

Çeviri için Kısaltma Kuralları

  1. Do not change text between two | characters like |bronze|, |checkbox|, |labels|, |selectString|, |addLayer| ... These are special tags used to replace images
  2. ``:ref: `` veya ``:file: `` etiketi ile başlayan referansları değiştirmeyin.

  3. Do not change references that end with an underscore like figure_labels_1_
  4. Do not change the url in hyperlinks, but you may change the external description. Leave the underscore at the end of the hyperlink, without additional spacing (>`_)
  5. Change the text inside quotes following :index:, :sup:, :guilabel: and :menuselection: tags. Check if/how it is translated in the QGIS Application. Do not change the tag itself.
  6. Text between double stars and double quotes often indicate values or fieldnames, sometimes they need translation sometimes not.
  7. Be aware to use exactly the same (number of) special characters of the source text such as `, ``, *, **, ::. These contribute to the cosmetics of the information provided
  8. Do not begin nor end the text hold by special characters or tags with a space
  9. Do not end the translated strings with a new paragraph, otherwise the text will not be translated during the html generation.

Yukarıdaki sunulan kurallara bağlı kalın ve çevirilen belge daha iyi olsun!

For any question, please contact the QGIS Community Team or the QGIS Translation Team.