重要

翻訳は あなたが参加できる コミュニティの取り組みです。このページは現在 96.83% 翻訳されています。

4. 翻訳ガイドライン

このマニュアルは翻訳者の手助けとなることを目的としています。まず、翻訳チームに参加する方法を説明します。次に、技術的にどのように翻訳が行なわれるのかの一般的なプロセスを説明します。その後、実際の英語の .rst ドキュメントからオランダ語に翻訳された、その翻訳について説明します。最後に、翻訳のルール の概要を示します。

注釈

このガイドラインでは QGIS ドキュメントに焦点を当てますが、下記の方法やルールは QGIS アプリケーションにも適用可能です。

4.1. 翻訳者になる

QGISプロジェクトでは、QGISを外国語に翻訳する作業に時間を割いてくださる方 - 場合によっては、翻訳作業を調整してくださる方を常に募集しています。

私たちはプロジェクト管理プロセスの改善に努め、特定の責任範囲を持つ人々の間で負荷をより均等に分散しようとしているので、皆様からのご協力は大変ありがたいです。

新しい言語のコーディネーターに立候補したい方は、どうぞご応募ください。同じ言語のコーディネーターに複数の応募者が名乗りを上げた場合は、お互いに連絡を取り合い、どのように作業を分担するかを決めてください。

4.1.1. Transifex

ウェブベースの翻訳プラットフォームである Transifex は、QGISのすべての翻訳: デスクトップアプリケーション自体（またはGUI）とドキュメントに使用されています。ですから最初に必要なのは、ログインして始めるためのアカウントです。

4.1.2. プロジェクトへ参加

  1. https://explore.transifex.com/qgis/ に行きます

  2. 私たちが翻訳しているプロジェクトを調べたり、さまざまな統計情報から対象言語を特定したりすることができます:

    • QGIS Desktop は、QGISアプリ（QGIS DesktopとQGIS Server）で利用できる全てのテキスト部品、

    • QGIS Documentation は、公式のLTRドキュメント

  3. 翻訳を手伝いたいプロジェクトをクリックしてください

  4. 右側の JOIN THIS PROJECT をクリックします。登録を促す画面が表示されます。

  5. アカウントを作成するか、サードパーティのプラットフォームのアカウントで接続します。受信するメールに記載されたリンクからアカウントを認証します。

  6. ログインします

  7. 次に、翻訳を手伝いたい言語を選択するポップアップが表示されます。なお、プロセスをできるだけ単純にしようとしているため、国パラメータに関係なく、対象となる言語のみを表示しています（例 French (France) (fr_FR) ではなく French (fr)）。 言語に顕著な違いがある場合（例 ポルトガル対ブラジルのポルトガル語）のみ、異なるバージョンを許容します。

    対象言語、つまりQGISの翻訳を手伝いたい言語、を検索します。あなたが話せる言語全てを検索する必要はありません:

    • 既に追加されています と表示されていれば、それを選択して Join Project を押してください。

    • 既に追加されていますと表示されない場合は、それを選択して 言語を申請 を押します。プロジェクト全体を翻訳するには、数週間はかかると覚悟してください。繰り返しになってすみませんが、話せる言語を全て選択するということではありません。

  8. 次に、言語コーディネーターまたはプロジェクトのメンテナが申請を処理するのを待つ必要があります。申請が受理されると、電子メールで通知が届きます。申請に1週間ほど回答がない場合は、Transifexか QGIS 翻訳者メーリングリスト にいる言語コーディネーターに書き送ることを検討してください。

  9. また、他のQGISプロジェクトに参加して手伝うこともできます。

4.1.3. 翻訳

申請が承認されると、選択したプロジェクト内のテキストを翻訳できるようになります。あなたの言語をクリックし、翻訳したい章を選択し、翻訳をクリックするだけです。簡単でしょう？

良い翻訳をしていただくために、以下にいくつか指示があります。一読を強くお勧めします。

Tip

Transifexにある翻訳可能なファイルへの簡単なアクセス

現在のドキュメントに誤訳や抜けを見つけた場合は、そのページ左下のドロップダウンメニューにある Translate page リンクを使ってTransifexのソースにアクセスし、必要な更新を行うことができます。

4.2. 翻訳プロセス

QGIS のドキュメントは .rst ファイルを使い英語で書かれています。翻訳を提供するには次のようにします。

  1. 事前ビルドスクリプトによって .po ファイルと呼ばれる翻訳用のファイルが、 /QGIS-Documentation/locale/en フォルダーの中に作成されます。

  2. .po ファイルの中の文が Transifex のウェブプラットフォームにプッシュされ、英語から各言語へと、翻訳者がエディターを使って翻訳できるようになります。

  3. ファイルが100%翻訳されると、翻訳された文字列は自動的にドキュメントリポジトリの /QGIS-Documentation/locale/ <language> 配下にプルバックされます。

  4. 次のドキュメントのビルド（1日に1回以上発生します－時刻はページの下部を参照）で、スクリプトが文章を再利用して翻訳出力を作成します。

  5. 完全に翻訳されていないファイルについては、2週間ごとにスクリプトがTransifexからGithubに翻訳された文字列を取り込み、次のビルドで同様に公開されます。

  6. .rst ファイルが更新されるたびに、英語の .po ファイルが更新され、その変更が Transifex の対応するファイルにプッシュされます。つまり、すでに翻訳された .rst 文書に新しい段落が追加されたとき、新しい/更新された文章だけが翻訳された .po ファイルに追加され、翻訳する必要があることを意味します。

注釈

QGISデスクトップの仕様を翻訳する

QGISアプリケーションの翻訳と大きく異なる点は、 .po ファイルの代わりに、特定のバージョンのアプリケーションを構成する .py, .cpp, .yaml ファイル内のすべての翻訳可能文字列が、単一の .ts ファイル（例：qgis-application/qgis_jp (branch release-3_30)` ）として Transifex へプッシュ、プルすることです。翻訳は、開発ブランチ（毎日）、とリリース時（リリースされたバージョンごとに）にGithubにプルされます。

現在、2つの異なるツールが、 QGIS での翻訳を行うために使用されています。

  • ``Transifexウェブプラットフォーム <https://www.transifex.com/>`_ は、QGISを翻訳する上で 最も簡単で推奨される方法 であり、上記のプロセスを透明に行い、翻訳者のために翻訳可能なテキストをすべて1か所に集めます。欲しいファイルを選択して翻訳するだけです。翻訳されたファイルは、次のリリースが公開されるまでプラットフォームに保存されます。

  • Qt Linguist は Qt の開発ツールです。翻訳者は .po (もしくは .ts) ファイルをソースコードからローカル環境に取得し、翻訳した後は送り返す必要があります。

どちらのツールを選ぼうと、翻訳のルールは同じであることに注意してください。

4.3. ファイルを翻訳する

ヒートマッププラグインの例を使って翻訳の作業を説明します。この例では英語からオランダ語に翻訳を行いますが、他のドキュメントや言語でもほぼ同じでしょう。

ヒートマッププラグインのドキュメントのソースは以下の場所にあります。

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

なんでこのドキュメントを例として選んだのかですって？

  1. このドキュメントには画像、キャプション、ヘッダー、参照、置換があるからです

  2. このドキュメントを書いたのは私なので、私には翻訳が容易だからです (^o^;)

ビルドプロセスが英語の .po ファイルを以下の場所に生成しています。

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

これに対応するオランダ語の .po ファイル（基本的にコピーです）は以下の場所にあります。

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

このファイルと並んでごく小さなサイズの .mo ファイルがあるのに気づかれると思いますが、今のところ、このファイルにはなんの翻訳も含まれていません。

4.3.1. Transifexでの翻訳

Transifex を使って翻訳するには、以下のようにしてください。

  1. Transifex でアカウントを作成し、QGIS プロジェクトに参加してください。

  2. Languages チームの一員となったら、該当するプロジェクト（ここでは QGIS Documentation です）をクリックします。翻訳が可能な言語の一覧が、その進捗の割合とともに表示されます。

    ../../_images/transifex_choose_language.png

    図 4.22 Transifex のメニューで翻訳する言語を選ぶ

  3. 翻訳する言語の上にカーソルを持ってきて、次のいずれかをクリックしてください。

    • リソースを表示: 翻訳可能な .po ファイルが、その翻訳の割合と文字列数とその他のメタデータとともに表示されます。

    • 翻訳: 翻訳可能なすべての .po ファイルと翻訳インターフェースが開きます。

  4. 翻訳したいファイル（この例では docs_user-manual_plugins_plugins-heatmap という名前のheatmap pluginのファイルを探します）か、もしくはなんでもいいので翻訳の終わっていないファイルを見つけて、それをクリックしてください。するとそのファイル中の文字列が読み込まれ、絞り込みや翻訳、提案などのインターフェースを利用できるようになります。

    Tip

    ページの左下にあるドロップダウンメニューの Translate page リンクをクリックすると、Transifexの対応する翻訳ページに直接移動します。

  5. あとは個々のテキストを選んで、下記の ガイドライン に従って翻訳するだけです。

Transifex の Web エディターについてのより詳しい情報は、https://help.transifex.com/en/articles/6318216-translating-with-the-web-editor を参照してください。

4.3.2. Qt Linguist による翻訳

Qt Linguist を使って翻訳するには、以下に従ってください。

  1. 手動で .po または .ts ファイルを取得します。Transifex プラットフォームから、またはソースリポジトリ (GitHub) の locale/$language フォルダーから、ファイルをダウンロードすることで実現できます。

  2. ローカルで翻訳に取りかかります。

  3. 修正を行ったファイルを元の場所 (Transifex または GitHub) へアップロードします。

翻訳可能なファイルを Transifex を使ってダウンロードしたりアップロードしたりすることも可能ですが、この手順はお勧めできません。というのも、 Transifex にはバージョン管理システムがないために、あなたがアップロードしたファイルは単純に既存のファイルを置き換えるだけなので、その間に Transifex で他の人によって行われた変更を上書きしてしまう可能性があるからです。

Qt Linguist で初めてそのファイルを開くときは、次のようなダイアログが表示されます。

../../_images/linguist_choose_language.png

図 4.23 linguist メニューから翻訳する言語を選ぶ

Target language は正しく選択する必要があります。 Source language は POSIX、Country/Region はAny Country のままでかまいません。

OK ボタンを押すと、 Qt Linguist は文を埋め、翻訳を始めることができます。 図 4.24 を参照してください。

../../_images/linguist_menu.png

図 4.24 Qt Linguist のメニューを使用して翻訳

メニューには使うと便利な以下のようなボタンがあります。

  • linguist_done_next [翻訳を完了して次へ] ボタンは、最も重要なボタンです。翻訳が必要な項目では、テキストフィールドに翻訳を入力してこのボタンを押してください。翻訳を必要としない項目では、テキストフィールドは空のままでこのボタンを押してください。これで翻訳完了となり、次の項目に進みます。

  • linguist_previous [前へ行く] ボタンで、その前の翻訳項目に移動することができます。

  • linguist_next [次へ行く] ボタンで、その次の翻訳項目に移動することができます。

  • linguist_next_todo [次のするべき] ボタンは、翻訳が必要な次の翻訳項目にジャンプします。ソースファイルの変更によって追加や修正が行われた文だけを翻訳する必要があるときに便利です。

  • linguist_previous_todo [前のするべき] ボタンは逆方向に検索を行い、最初に見つかった未翻訳の項目にジャンプします。

Qt Linguist の使い方についての詳しい情報は、 https://doc.qt.io/qt-5/linguist-translators.html を参照してください。

警告

翻訳のためにソースリポジトリからファイルをダウンロードするときは、絶対に master ブランチで行わないでください。ある特定のバージョンで英語での更新が完了した後は、常に翻訳用ブランチが有効になっています。翻訳のためにはそのブランチを使用してください。例えばQGIS 2.8 の翻訳では、manual_en_v2.8 ブランチを使用してください。

4.3.3. マニュアルを翻訳する

それでは plugin_heatmap のマニュアルの翻訳を始めましょう！

大部分の文は、そのまま翻訳してください。特別な翻訳をしなければならない部分（rst 文）を、この翻訳セッションの中で挙げていきます。

以下で翻訳の対象として興味深い文を見ていきましょう。

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.

このセンテンスには2つの rst 構文があります。

  1. |heatmap| のように | に挟まれた言葉は、置換されるので決して翻訳してはいけません。ここではヒートマッププラグインのアイコンに置換されます。

  2. :sup:`Heatmap` のような :sup: 文は上付き文です。続くテキストを少し高く出力します。これはツールバー項目の上にマウスを当てた時に表示されるポップアップテキストを表示するために使用されますが、実際の QGIS アプリケーションでの翻訳とは異なる場合があります。オランダ語の場合はそうではありません。

この文中のそれ以外のプレーンテキストは、すべて翻訳してかまいません。

次の文には 、マニュアルの別のセクションをを参照するためによく使われる :ref: 文が含まれています。 :ref: 文に続くテキストは一意の識別子であるため、 変更してはいけません。

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.

この場合、 load_core_plugin は一意の参照識別子であり、キャプションのある rst アイテムの前に配置されます。この ref 文は見出しのテキストに置換され、ハイパーリンクに変換されます。 参照されている見出しが翻訳された時は、この見出しを参照しているすべての ref 文も自動的に同じように翻訳されます。

次の文には rst タグ :menuselection: があります。続くテキストは実際に QGIS アプリケーションのメニューで表示されるテキストです。これはアプリケーションでは翻訳されているかもしれませんので、その場合は変更すべきです。

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

ここではオランダ語へローカライズされた QGIS アプリケーションで使用される翻訳ですので、上記の "View -->" は実際には "Beeld -->" と翻訳されます。

次のように、トリッキーな翻訳アイテムを見かけることもあります。

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

この文には、図 figure_heatmap_settings_ への参照があります。セクションへの参照と同様に、この参照を変更してはいけません。 rst ドキュメントでの参照定義は .po ファイルには含まれていないため、これを変更することはできません。このことは図への参照は翻訳できないことを意味します。 HTML 生成時には figure_heatmap_settings と表示されます。 PDF 生成の際には figure_heatmap_settings_ は図番号に置き換えられます。

次の rst 属性付きの文はこのようなものです。

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

上の行内の二重星印を削除しないでください。二重星印に挟まれたテキストは太字で表示されます。テキストそのものは多くの場合、ダイアログ中のテキストであり、アプリケーションでは翻訳されているかもしれません。

以下の文章には :guilabel: rst タグが含まれています。

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

guilabel タグのテキスト Advanced は QGIS アプリケーション中でおそらく翻訳されるのでたぶん変更する必要があります。

以下の文章には ``airports`` が含まれています。引用符は、テキストに別のテキストフォントを設定するために使用されています。このケースでは、リテラル値であり、翻訳を必要としません。

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
`https://www.qgistutorials.com
<https://www.qgistutorials.com/en/docs/creating_heatmaps.html>`_.

この文には、URL と表示テキストの両方を持つハイパーリンクも含まれています。URL はもちろん手をつけずそのまま残すべきですが、読者に表示される方のテキストである https://www.qgistutorials.com は変更することができます。ハイパーリンクの末尾のアンダースコアは本質的な部分なので決して削除してはいけません。

4.3.4. 翻訳ルールのまとめ

  1. |bronze| 、 |checkbox| 、|labels| 、|selectString| 、|addLayer| ... のような、2つの | の文字に挟まれたテキストは変更しないでください。これらは、画像に置換するために使用される特殊なタグです

  2. :ref:, :file:, :numref: などで始まる役割を持つ参照は、タイトルが含まれていない限り変更しないでください。タイトルが含まれている場合は、タイトルを翻訳することはできますが、リンク（すなわち < と > で囲まれたテキスト）は変更せずにおいてください

    Tip

    参照にタイトルが提供されている場合、Transifex は英語の原文にリンク部分を数字に置き換えて表示することがあります。原文の数字をクリックすると、翻訳中のタイトルの横に参照のリンクが追加されます。

  3. figure_labels_1_ のようなアンダースコアで終わる参照を変更しないでください。

  4. ハイパーリンクの URL を変更しないでください。ただし読者に表示される記述は変更できます。ハイパーリンクの末尾のアンダースコア (>`_) は空白を加えたりせずそのまま残しておいてください。

  5. :index: 、 :sup: 、 :guilabel: 、 :menuselection: タグに続く引用符内のテキストは変更してください。それが QGIS アプリケーションで翻訳されているかどうか、どう翻訳されているかを確認してください。タグ自体は変更しないでください。

  6. 二重星と二重引用符の間のテキストは多くの場合、値もしくはフィールド名を示しています。翻訳の必要があることもあれば、ないこともあります。

  7. `, ``, *, **, :: などの特殊文字は、正確に元のテキストと同じ文字を（同じ数だけ）使用するよう注意してください 。これらは情報の見た目を整えるのに貢献しています。

  8. 特殊文字やタグで囲まれた部分のテキストを、スペースで始めたり終わらせたりしないでください。

  9. 翻訳文字列の後に段落を開始して終了しないでください。そうすると HTML 生成時にテキストが翻訳されません。

以上のルールを守ってドキュメントの品質を良くしましょう！

何か質問があれば QGIS コミュニティチーム または QGIS 翻訳チーム までご連絡ください。