qgis-documentation - en to ja translation catalogue (40 entries)

en: Introduction
ja: はじめに

en: This document is intended to work both as a tutorial and a reference guide. While it does not list all possible use cases, it should give a good overview of the principal functionality.
ja: このドキュメントはチュートリアルとリファレンスガイドの両方の役割を意図して書かれています。すべてのユースケースを満たしてはいませんが、主要な機能の良い概要となるでしょう。

en: Starting from 0.9 release, QGIS has optional scripting support using Python language. We've decided for Python as it's one of the most favourite languages for scripting. PyQGIS bindings depend on SIP and PyQt4. The reason for using SIP instead of more widely used SWIG is that the whole QGIS code depends on Qt libraries. Python bindings for Qt (PyQt) are done also using SIP and this allows seamless integration of PyQGIS with PyQt.
ja: 0.9リリースからQGISはPythonを使ったスクリプト処理をサポートしました。Pythonはスクリプト処理でもっとも好まれている言語の一つだと思います。PyQGISバインディングはSIPとPyQt4に依存しています。これはSIPはSWIGの代わりに広く使われていて、QGISのコードはQtライブラリに依存しています。QtのPythonバインディング(PyQt)もSIPを使っていて、これによりPyQtによるPyQGISの実装がシームレスに実現しています。

en: Getting PyQGIS to work (Manual compilation, Troubleshooting)
ja: PyQGISが動かせるまで(マニュアルの補完、トラブルシューティング)

en: There are several ways how to use QGIS python bindings, they are covered in detail in the following sections:
ja: QGIS python バインディングを使う方法はいくつかあり、ここでは次の内容をカバーします:

en: issue commands in Python console within QGIS
ja: QGIS の中の Python コンソールのコマンドについて

en: create and use plugins in Python
ja: Pythonでプラグインを作り、使う方法

en: create custom applications based on QGIS API
ja: QGIS APIベースのカスタムアプリケーションの作成

en: There is a `complete QGIS API <http://qgis.org/api/>`_ reference that documents the classes from the QGIS libraries. Pythonic QGIS API is nearly identical to the API in C++.
ja: QGIS ライブラリのクラスのドキュメントは`完全な QGIS API <http://doc.qgis.org/>`_ のリファレンスにあります。PythonのQGIS APIは C++ のAPIとほぼ同じです。

en: There are some resources about programming with PyQGIS on `QGIS blog <http://blog.qgis.org/>`_. See `QGIS tutorial ported to Python <http://blog.qgis.org/?q=node/59>`_ for some examples of simple 3rd party apps. A good resource when dealing with plugins is to download some plugins from `plugin repository <http://plugins.qgis.org/>`_ and examine their code.
ja: `QGIS blog <http://blog.qgis.org/>`_ にPyQGIS を使ったプログラミングのいくつかのリソースがあります。`Python 版 QGIS チュートリアル <http://blog.qgis.org/?q=node/59>`_ にいくつかサードパーティアプリのサンプルを見つけることができます。プラグインを取り扱うのに良いリソースは、いくつかのプラグインを `プラグインレポジトリ <http://plugins.qgis.org/>`_ からダウンロードして、それらのソースコードを参考にすることです。

en: Python Console
ja: Python コンソール

en: For scripting, it is possible to take advantage of integrated Python console. It can be opened from menu: :menuselection:`Plugins --> Python Console`. The console opens as a non-modal utility window:
ja: スクリプト処理をする上で、(QGISに)統合されているPython コンソールから多くの利点を得られるでしょう。これはメニューの :menuselection:`プラグイン --> Pythonコンソール`から開くことができます。コンソールはモーダルではないユーティリティウィンドウに開きます:

en: The screenshot above illustrates how to get the layer currntly selected in the layer list, show its ID and optionally, if it is a vector layer, show the feature count. For interaction with QGIS environment, there is :data:`qgis.utils.iface` variable, which is instance of :class:`QgisInterface`. This interface allows access to the map canvas, menus, toolbars and other parts of the QGIS application.
ja: 上記のスクリーンショットはレイヤーのリストから現在選択中のレイヤーを取得して、IDや他の情報を表示してるところを見せていて、もしベクターレイヤーであれば、フューチャーの数を表示することができます。QGIS環境とやりとりするには :class:`QgisInterface` のインスタンスである :data:`qgis.utils.iface` 変数を使います。このインターフェイスはマップキャンバス、メニュー、ツールバーやその他のQGISアプリケーションのパーツにアクセスすることができます。

en: For convenience of the user, the following statements are executed when the console is started (in future it will be possible to set further initial commands)::
ja: 利便性を上げるためには、コンソールがスタートしたときに次の命令を入力してください(将来的には初期実行されるコマンドになるかもしれません)::

en: For those which use the console often, it may be useful to set a shortcut for triggering the console (within menu :menuselection:`Settings --> Configure shortcuts...`)
ja: このコンソールをたびたび使うなら、ショートカットを設定しておくとよいでしょう(メニューの :menuselection:`設定 --> ショートカットの構成...` から行えます)

en: Python Plugins
ja: Python プラグイン

en: Quantum GIS allows enhancement of its functionality using plugins. This was originally possible only with C++ language. With the addition of Python support to QGIS, it is also possible to use plugins written in Python. Great advantages over C++ plugins is the simplicity of distribution (no compiling for each platform needed) and easier development.
ja: Quantum GIS はプラグインによる機能拡張が可能です。元々はC++でのみ可能でした。QGISにPythonサポートを追加したことで、Pythonでもプラグインを書く事ができるようになりました。C++プラグインよりもよりよい利点は簡単な配布(プラットフォームごとのコンパイルする必要がありません)ができ、また簡単に開発ができます。

en: Many plugins covering various functionality have been written since the introduction of Python support. Plugin installer allows users to easily fetch, upgrade and remove Python plugins. See `Python Plugin Repositories <http://www.qgis.org/wiki/Python_Plugin_Repositories>`_ page for various sources of plugins.
ja: 様々な機能をカバーする多くのプラグインはPythonサポートが導入されてから書かれました。プラグインのインストーラはPythonプラグインの取得、アップグレード、削除を簡単に行えます。様々なプラグインのソースが `Python Plugin Repositories <http://www.qgis.org/wiki/Python_Plugin_Repositories>`_ から見つけることができます。

en: Creating plugins in Python is simple, see :ref:`developing_plugins` for detailed instructions.
ja: Pythonでプラグインを作るのはとても簡単です。詳細は:ref:`plugins`を見てください。

en: Python Applications
ja: Python アプリケーション

en: Often when processing some GIS data, it is handy to create some scripts for automating the process instead of doing the same task again and again. With PyQGIS, this is perfectly possible --- import the :mod:`qgis.core` module, initialize it and you are ready for the processing.
ja: GISデータを処理するときは、繰り返し同じタスクを実行するのに簡単なスクリプトを書いて自動化することがたびたびあります。PyQGISなら完璧に行えます --- :mod:`qgis.core` モジュールを import すれば、初期化が行われて処理を行う準備が完了します。

en: Or you may want to create an interactive application that uses some GIS functionality --- measure some data, export a map in PDF or any other functionality. The :mod:`qgis.gui` module additionally brings various GUI components, most notably the map canvas widget that can be very easily incorporated into the application with support for zooming, panning and/or any further custom map tools.
ja: もしくはいくつかのGISの機能 --- いくつかのデータの距離を測ったり、地図をPDFに変換したり、または他の機能など -- を使ったインタラクティブなアプリケーションを作りたいのかもしれません。 :mod:`qgis.gui` モジュールは様々なGUIコンポーネントを追加することができ、とりわけマップキャンバスのwidgetはズームやパンや他のマップを制御するツールと一緒にアプリケーションに簡単に組み込むことができます。

en: Using PyQGIS in custom application
ja: PyQGISをカスタムアプリケーションで使う

en: Note: do *not* use :file:`qgis.py` as a name for your test script --- Python will not be able to import the bindings as the script's name will shadow them.
ja: 注意: :file:`qgis.py` という名前をあなたのテストスクリプトで*使わないでください* --- このスクリプトの名前がバインディングを隠蔽してしまってpythonでimportできなくなるでしょう。

en: First of all you have to import qgis module, set QGIS path where to search for resources --- database of projections, providers etc. When you set prefix path with second argument set as :const:`True`, QGIS will initialize all paths with standard dir under the prefix directory. Calling :func:`initQgis` function is important to let QGIS search for the available providers.
ja: まずはじめに、qgisモジュールをimportする必要があります。リソース - プロジェクションのデータベースやプロバイダなど --- を読み込めるようにQGISのパスを通します。もし set prefix path の２つ目の引数に :const:`True` をセットしたら、QGISは prefix ディレクトリの下の全てのパスを初期化するでしょう。 :func:`initQgis` 関数を呼ぶことは QGIS が存在するプロバイダを探すのにとても重要な事です。

en: Now you can work with QGIS API --- load layers and do some processing or fire up a GUI with a map canvas. The possibilities are endless :-)
ja: これでQGIS API --- レイヤーを読み込んだり、処理を行ったり、マップキャンバスと共にGUIを起動したり - を動かす事ができます。可能性は無限です :-)

en: When you are done with using QGIS library, call :func:`exitQgis` to make sure that everything is cleaned up (e.g. clear map layer registry and delete layers)::
ja: QGISライブラリを使い終わったら、 :func:`exitQgis` を呼んで全て終了 (例えばマップレイヤのレジストリをクリアにしてレイヤーを削除したり)　することができます。

en: Running Custom Applications
ja: カスタムアプリケーションを実行する

en: You will need to tell your system where to search for QGIS libraries and appropriate Python modules if they are not in a well-known location --- otherwise Python will complain::
ja: QGISのライブラリとPythonモジュールが一般的な場所に置かれて無ければ、システムに適切な場所を伝える必要があるでしょう --- そうしないとPythonはエラーを吐きます::

en: This can be fixed by setting the ``PYTHONPATH`` environment variable. In the following commands, ``qgispath`` should be replaced with your actual QGIS installation path:
ja: これは ``PYTHONPATH`` という環境変数をセットすれば治ります。次のコマンドで ``qgispath`` の部分を実際にQGISをインストールした場所に差し替えてください:

en: on Linux: :command:`export PYTHONPATH=/qgispath/share/qgis/python`
ja: Linuxでは: :command:`export PYTHONPATH=/qgispath/share/qgis/python`

en: on Windows: :command:`set PYTHONPATH=c:\\qgispath\\python`
ja: Windowsでは: :command:`set PYTHONPATH=c:\\qgispath\\python`

en: The path to the PyQGIS modules is now known, however they depend on ``qgis_core`` and ``qgis_gui`` libraries (the Python modules serve only as wrappers). Path to these libraries is typically unknown for the operating system, so you get an import error again (the message might vary depending on the system)::
ja: これでPyQGISモジュールのパスがわかるようになりました。一方これらは ``qgis_core`` と ``qgis_gui``ライブラリに依存します(Pythonライブラリはラッパーとして振る舞うだけです)。これらのライブラリのパスがOSで読み込めないものであれば、またもやimportエラーが発生するでしょう(このメッセージはシステムにかなり依存していることを示します)::

en: Fix this by adding the directories where the QGIS libraries reside to search path of the dynamic linker:
ja: これを修正するにはQGISライブラリが存在するディレクトリを動的リンカのパスに追加するをします:

en: on Linux: :command:`export LD_LIBRARY_PATH=/qgispath/lib`
ja: Linuxでは: :command:`export LD_LIBRARY_PATH=/qgispath/lib`

en: on Windows: :command:`set PATH=C:\\qgispath;%PATH%`
ja: Windowsでは: :command:`set PATH=C:\\qgispath;%PATH%`

en: These commands can be put into a bootstrap script that will take care of the startup. When deploying custom applications using PyQGIS, there are usually two possibilities:
ja: これらのコマンドはブートストラップスクリプトに入れておくことができます。PyQGISを使ったカスタムアプリケーションを配布するには、これらの二つの方法が可能でしょう:

en: require user to install QGIS on his platform prior to installing your application. The application installer should look for default locations of QGIS libraries and allow user to set the path if not found. This approach has the advantage of being simpler, however it requires user to do more steps.
ja: QGISを対象となるプラットフォームにインストールするのをユーザに要求します。アプリケーションのインストーラはQGISライブラリの標準的な場所を探すことができ、もし見つからなければユーザがパスをセットできるようにします。この手段はシンプルである利点がありますが、しかしながらユーザに多くの手順を要求します。

en: package QGIS together with your application. Releasing the application may be more challenging and the package will be larger, but the user will be saved from the burden of downloading and installing additional pieces of software.
ja: アプリケーションと一緒にQGISのパッケージを配布する方法です。アプリケーションのリリースにはいろいろやることがあるし、パッケージも大きくなりますが、ユーザを追加ソフトウェアをダウンロードをしてインストールする負荷から避けられるでしょう。

en: The two deployment models can be mixed - deploy standalone application on Windows and Mac OS X, for Linux leave the installation of QGIS up to user and his package manager.
ja: これらのモデルは組み合わせることができます - Windows と Mac OS Xではスタンドアローンアプリケーションとして配布をして、LinuxではQGISのインストールをユーザとユーザが使っているパッケージマネージャに任せるとか。
