developers-reference - en to ja translation catalogue (52 entries)

en: Overview of Debian Maintainer Tools
ja: Debian メンテナツールの概要

en: This section contains a rough overview of the tools available to maintainers. The following is by no means complete or definitive, but just a guide to some of the more popular tools.
ja: この章には、メンテナが利用できるツールについて大まかな概要が含まれています。以下は完全なものでも決定版的なものでもありませんが、よく使われているツールについての説明です。

en: Debian maintainer tools are meant to aid developers and free their time for critical tasks. As Larry Wall says, there's more than one way to do it.
ja: Debian メンテナツールは、開発者を手助けし、重要な作業のために時間を作れるようにしてくれるものです。Larry Wall が言うように、やり方は一つではありません (there's more than one way to do it)。

en: Most of the descriptions of these packages come from the actual package descriptions themselves. Further information can be found in the package documentation itself. You can also see more info with the command ``apt-cache show`` *package-name*.
ja: パッケージの説明文のほとんどは実際のパッケージの説明から取ったものです。より詳細な情報はパッケージ内のドキュメントで確認できます。\ ``apt-cache show``\ *パッケージ名* コマンドでも情報を得られます。

en: Core tools
ja: 主要なツール

en: The following tools are pretty much required for any maintainer.
ja: 以下のツールはどのメンテナであっても、必ず必要とするものです。

en: ``dpkg-dev`` contains the tools (including ``dpkg-source``) required to unpack, build, and upload Debian source packages. These utilities contain the fundamental, low-level functionality required to create and manipulate packages; as such, they are essential for any Debian maintainer.
ja: ``dpkg-dev`` は、パッケージを展開、ビルド、Debian ソースパッケージをアップロードするのに必要なツールを含んでいます (``dpkg-source`` を含む) 。これらのユーティリティはパッケージを作成・操作するのに必要な基礎的で、低レイヤの機能を含んでいます。そのため、これらはあらゆる Debian メンテナにとって必要不可欠なものです。

en: ``debconf`` provides a consistent interface to configuring packages interactively. It is user interface independent, allowing end-users to configure packages with a text-only interface, an HTML interface, or a dialog interface. New interfaces can be added as modules.
ja: ``debconf`` は、パッケージを対話形式で設定できる一貫したインターフェイスを提供します。これはユーザインターフェイスに依存せず、エンドユーザがテキストのみのインターフェイス、HTML インターフェイス、ダイアログ形式のインターフェイスでパッケージを設定できます。新たなインターフェイスはモジュールとして追加できます。

en: You can find documentation for this package in the ``debconf-doc`` package.
ja: このパッケージに関するドキュメントは ``debconf-doc`` パッケージ中で確認できます。

en: ``fakeroot`` simulates root privileges. This enables you to build packages without being root (packages usually want to install files with root ownership). If you have ``fakeroot`` installed, ``dpkg-buildpackage`` will use it automatically.
ja: ``fakeroot`` は root 特権をシミュレートします。これは root になること無しにパッケージをビルドできるようにしてくれます (パッケージは通常 root の所有権でファイルをインストールしようとします)。\ ``fakeroot`` をインストールしていれば、\ ``dpkg-buildpackage`` で自動的に利用します。

en: Package lint tools
ja: パッケージチェック (lint) 用ツール

en: ``lintian`` dissects Debian packages and emits information about bugs and policy violations. It contains automated checks for many aspects of Debian policy as well as some checks for common errors.
ja: ``lintian`` は Debian パッケージを解剖してバグやポリシー違反の情報を出力します。一般的なエラーへのチェック同様にDebian ポリシーの多くの部分を自動チェックする機能を含んでいます。

en: You should periodically get the newest ``lintian`` from ``unstable`` and check over all your packages. Notice that the ``-i`` option provides detailed explanations of what each error or warning means, what its basis in Policy is, and commonly how you can fix the problem.
ja: 定期的に最新の ``lintian`` を ``unstable`` から取得し、パッケージを全てチェックするべきです。\ ``-i`` オプションは、各エラーや警告が何を意味しているのか、ポリシーを元に、詳細な説明を提供してくれ、一般的に問題をどのように修正するべきかを説明してくれることに留意してください。

en: Refer to :ref:`sanitycheck` for more information on how and when to use Lintian.
ja: 何時、どのようにして Lintian を使うのか、詳細については :ref:`sanitycheck` を参照してください。

en: You can also see a summary of all problems reported by Lintian on your packages at https://lintian.debian.org/\ . These reports contain the latest ``lintian`` output for the whole development distribution (``unstable``).
ja: あなたのパッケージに対して Lintian によって報告されたの問題の要約はすべて https://lintian.debian.org/\ から確認することもできます。このレポートは、最新の ``lintian`` による開発版ディストリビューション　(\ ``unstable``) 全体についての出力を含んでいます。

en: ``debdiff`` (from the ``devscripts`` package, :ref:`devscripts`) compares file lists and control files of two packages. It is a simple regression test, as it will help you notice if the number of binary packages has changed since the last upload, or if something has changed in the control file. Of course, some of the changes it reports will be all right, but it can help you prevent various accidents.
ja: (``devscripts`` パッケージ、\ :ref:`devscripts` より) ``debdiff`` は二つのパッケージのファイルのリストと control ファイルを比較します。前回のアップロードからバイナリパッケージ数が変わったことや、control ファイル内で何が変わったのかなどに気付く手助けをしてくれるなど、簡単なリグレッションテストとなります。もちろん、報告される変更の多くは問題ありませんが、様々なアクシデントを防止するのに役立ってくれるでしょう。

en: You can run it over a pair of binary packages:
ja: バイナリパッケージのペアに対して実行することができます:

en: Or even a pair of changes files:
ja: changes ファイルのペアに対してさえも実行できます:

en: For more information please see debdiff 1.
ja: より詳細については、debdiff 1を参照してください。

en: Helpers for ``debian/rules``
ja: ``debian/rules`` の補助ツール

en: Package building tools make the process of writing ``debian/rules`` files easier. See :ref:`helper-scripts` for more information about why these might or might not be desired.
ja: パッケージ構築ツールは ``debian/rules`` ファイルを書く作業を楽にしてくれます。これらが望ましい、あるいは望ましくない理由の詳細については :ref:`helper-scripts` を参照してください。

en: There are a number of little ``debhelper`` add-on packages, too transient to document. You can see the list of most of them by doing ``apt-cache search ^dh-``.
ja: ここに記すには一時的な、大量の小さな ``debhelper`` のアドオンパッケージがあります。\ ``apt-cache search ^dh-`` と実行することで一覧の多くを参照できます。

en: While the rules files generated by ``dh_make`` are in general a sufficient basis for a working package, they are still just the groundwork: the burden still lies on the maintainer to finely tune the generated files and make the package entirely functional and Policy-compliant.
ja: ``dh_make`` によって生成された rules ファイルは、大抵の場合作業するパッケージに対して十分な基礎にはなりますが、まだこれは下地でしかありません。メンテナに残っている責務は、生成されたファイルをきれいに整理して、完全に動作してポリシーに準拠したパッケージにすることです。

en: ``equivs`` is another package for making packages. It is often suggested for local use if you need to make a package simply to fulfill dependencies. It is also sometimes used when making *meta-packages*, which are packages whose only purpose is to depend on other packages.
ja: ``equivs`` はパッケージ作成用のもう一つのパッケージです。単純に依存関係を満たしたいだけのパッケージを作成する必要がある場合に、しばしばローカルでの使用を勧められます。時折、他のパッケージに依存することだけが目的のパッケージ、「メタパッケージ (meta-packages)」を作る際にも使われます。

en: Package builders
ja: パッケージ作成ツール

en: ``git-buildpackage`` provides the capability to inject or import Debian source packages into a Git repository, build a Debian package from the Git repository, and helps in integrating upstream changes into the repository.
ja: ``git-buildpackage`` は、Debian ソースパッケージを Git リポジトリに挿入あるいはインポートし、Debian パッケージを Git リポジトリから生成、そして開発元での変更をリポジトリに統合するのに役立つ機能を提供します。

en: These utilities provide an infrastructure to facilitate the use of Git by Debian maintainers. This allows one to keep separate Git branches of a package for ``stable``, ``unstable`` and possibly ``experimental`` distributions, along with the other benefits of a version control system.
ja: これらのユーティリティは、Debian メンテナによる Git の利用を促進するインフラストラクチャを提供します。これは、バージョンコントロールシステムの他の利点と同様に、\ ``stable``\ 、\ ``unstable``\ 、おそらく ``experimental`` ディストリビューション用にパッケージに個々の Git ブランチを持つことができます。

en: The ``debootstrap`` package and script allows you to bootstrap a Debian base system into any part of your filesystem. By base system, we mean the bare minimum of packages required to operate and install the rest of the system.
ja: ``debootstrap`` パッケージとスクリプトは、システムのどこででも Debian ベースシステムをブートストラップできるようにしてくれます。ベースシステムとは、操作するのに必要となる素の最小限パッケージ群を意味し、それに加えてシステムの残りの部分をインストールします。

en: Having a system like this can be useful in many ways. For instance, you can ``chroot`` into it if you want to test your build dependencies. Or you can test how your package behaves when installed into a bare base system. Chroot builders use this package; see below.
ja: この様なシステムを持つことは、様々な面で役に立つでしょう。例えば、ビルドの依存関係をテストしたい場合に ``chroot`` でそのシステムの中に入ることができます。あるいは素のベースシステムにインストールした際にパッケージがどのように振る舞うかをテストできます。chroot 作成ツールはこのパッケージを使います。以下を参照ください。

en: ``sbuild`` is another automated builder. It can use chrooted environments as well. It can be used stand-alone, or as part of a networked, distributed build environment. As the latter, it is part of the system used by porters to build binary packages for all the available architectures. See :ref:`wanna-build` for more information, and https://buildd.debian.org/\  to see the system in action.
ja: ``sbuild`` はもう一つの自動ビルドシステムです。同様に chroot された環境を使うことが出来ます。単独で使うことも、分散ビルド環境のネットワークの一部として使うこともできます。文字通り、移植者たちによって利用可能な全アーキテクチャのバイナリパッケージをビルドするのに使われているシステムの一部です。詳細については\ :ref:`wanna-build` を参照してください。それからシステムの動作については https://buildd.debian.org/\  を参照してください。

en: Package uploaders
ja: パッケージのアップロード用ツール

en: The following packages help automate or simplify the process of uploading packages into the official archive.
ja: 以下のパッケージはパッケージを公式アーカイブにアップロードする作業を自動化、あるいは単純化してくれるのに役立ちます。

en: The ``dcut`` script (part of the package ``dput``, :ref:`dput`) helps in removing files from the ftp upload directory.
ja: ``dcut`` スクリプト (``dput`` パッケージの一部、\ :ref:`dput` 参照)は、ftp アップロードディレクトリからファイルを削除するのに役立ちます。

en: Maintenance automation
ja: メンテナンスの自動化

en: The following tools help automate different maintenance tasks, from adding changelog entries or signature lines and looking up bugs in Emacs to making use of the newest and official ``config.sub``.
ja: 以下のツールは changelog のエントリや署名行の追加、Emacs 内でのバグの参照から最新かつ公式の ``config.sub`` を使うようにするまで、様々なメンテナンス作業を自動化するのに役立ちます。

en: See the devscripts 1 manual page for a complete list of available scripts.
ja: 利用可能なスクリプトの全リストについては devscripts 1 マニュアルページを参照してください。

en: ``alien`` converts binary packages between various packaging formats, including Debian, RPM (RedHat), LSB (Linux Standard Base), Solaris, and Slackware packages.
ja: ``alien`` は、Debian、RPM (RedHat)、LSB (Linux Standard Base)、Solaris、Slackware などの各種バイナリパッケージのパッケージ形式を変換します。

en: ``dpkg-depcheck`` (from the ``devscripts`` package, :ref:`devscripts`) runs a command under ``strace`` to determine all the packages that were used by the said command.
ja: (``devscripts`` パッケージ、\ :ref:`devscripts` より) ``dpkg-depcheck`` は、指定されたコマンドによって使われた全てのパッケージを確認するため、コマンドを ``strace`` の下で実行します。

en: For Debian packages, this is useful when you have to compose a ``Build-Depends`` line for your new package: running the build process through ``dpkg-depcheck`` will provide you with a good first approximation of the build-dependencies. For example:
ja: Debian パッケージについていうと、これは新しいパッケージの ``Build-Depends`` 行を構成するのが必要になった際に役立ちます。\ ``dpkg-depcheck`` を通してビルド作業を実行すると、最初の大まかなビルドの依存関係を良い形で得られます。例えば以下の様にします:

en: ``dpkg-depcheck`` can also be used to check for run-time dependencies, especially if your package uses exec 2 to run other programs.
ja: ``dpkg-depcheck`` は、特にパッケージが他のプログラムを実行するのに exec 2 を使っている場合に実行時の依存性を確認するのにも使えます。

en: For more information please see dpkg-depcheck 1.
ja: より詳細については、dpkg-depcheck 1 を参照してください。

en: Porting tools
ja: 移植用ツール

en: The following tools are helpful for porters and for cross-compilation.
ja: 以下のツールが、移植作業者やクロスコンパイル作業に役立ちます。

en: ``dpkg-cross`` is a tool for installing libraries and headers for cross-compiling in a way similar to ``dpkg``. Furthermore, the functionality of ``dpkg-buildpackage`` and ``dpkg-shlibdeps`` is enhanced to support cross-compiling.
ja: ``dpkg-cross`` は、\ ``dpkg`` に似た方法でクロスコンパイルするためのライブラリとヘッダをインストールするツールです。さらに、\ ``dpkg-buildpackage`` および ``dpkg-shlibdeps`` の機能がクロスコンパイルをサポートするように拡張されます。

en: Documentation and information
ja: ドキュメントと情報について

en: The following packages provide information for maintainers or help with building documentation.
ja: 以下のパッケージが、メンテナへの情報提供やドキュメントの作成に役立ちます。

en: ``docbook-xml`` provides the DocBook XML DTDs, which are commonly used for Debian documentation (as is the older debiandoc SGML DTD). This manual, for instance, is written in DocBook XML.
ja: ``docbook-xml`` は Debian のドキュメントで一般的に使われている DocBook XML DTD を提供します (古いものは debiandoc SGML DTD を使っています) 。例えば、このマニュアルは DocBook XML で書かれています。

en: The ``docbook-xsl`` package provides the XSL files for building and styling the source to various output formats. You will need an XSLT processor, such as ``xsltproc``, to use the XSL stylesheets. Documentation for the stylesheets can be found in the various ``docbook-xsl-doc-*`` packages.
ja: ``docbook-xsl`` パッケージは、ソースをビルドして様々な出力フォーマットに整形する XSL ファイルを提供します。XSL スタイルシートを使うには ``xsltproc`` のような XSLT プロセッサが必要になります。スタイルシートのドキュメントは各種 ``docbook-xsl-doc-*`` パッケージで確認できます。

en: To produce PDF from FO, you need an FO processor, such as ``xmlroff`` or ``fop``. Another tool to generate PDF from DocBook XML is ``dblatex``.
ja: FO から PDF を生成するには、\ ``xmlroff`` や ``fop`` のような FO プロセッサが必要です。他に DocBook XML から PDF を生成するツールとしては ``dblatex`` があります。

en: ``debiandoc-sgml`` provides the DebianDoc SGML DTD, which has been commonly used for Debian documentation, but is now deprecated (``docbook-xml`` or ``python3-sphinx`` should be used instead).
ja: ``debiandoc-sgml`` は Debian のドキュメントで一般的に使われている DebianDoc SGML DTD を提供します。しかし、現在は非推奨 (deprecated) となっています (代わりに ``docbook-xml`` か ``python3-sphinx`` を使うようにしてください)。これも、ソースをビルドして様々な出力フォーマットに整形するスクリプトを提供します。

en: Contains the public OpenPGP keys of Debian Developers and Maintainers. See :ref:`key-maint` and the package documentation for more information.
ja: Debian 開発者および Debian メンテナの公開 GPG 鍵を含んでいます。詳細については :ref:`key-maint` とパッケージ内のドキュメントを参照してください。

en: ``debian-el`` provides an Emacs mode for viewing Debian binary packages. This lets you examine a package without unpacking it.
ja: ``debian-el`` は、Debian バイナリパッケージを参照する Emacs モードを提供します。これを使うと、パッケージを展開しなくても実行できるようになります。
