pydoc.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# python-doc bot, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.15\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-01 14:54+0000\n"
"PO-Revision-Date: 2025-09-16 00:01+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Japanese (https://app.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ja\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/pydoc.rst:2
msgid ":mod:`!pydoc` --- Documentation generator and online help system"
msgstr ":mod:`!pydoc` --- ドキュメント生成とオンラインヘルプシステム"

#: ../../library/pydoc.rst:7
msgid "**Source code:** :source:`Lib/pydoc.py`"
msgstr "**ソースコード:** :source:`Lib/pydoc.py`"

#: ../../library/pydoc.rst:16
msgid ""
"The :mod:`!pydoc` module automatically generates documentation from Python "
"modules.  The documentation can be presented as pages of text on the "
"console, served to a web browser, or saved to HTML files."
msgstr ""

#: ../../library/pydoc.rst:20
msgid ""
"For modules, classes, functions and methods, the displayed documentation is "
"derived from the docstring (i.e. the :attr:`~definition.__doc__` attribute) "
"of the object, and recursively of its documentable members.  If there is no "
"docstring, :mod:`!pydoc` tries to obtain a description from the block of "
"comment lines just above the definition of the class, function or method in "
"the source file, or at the top of the module (see :func:`inspect."
"getcomments`)."
msgstr ""

#: ../../library/pydoc.rst:27
msgid ""
"The built-in function :func:`help` invokes the online help system in the "
"interactive interpreter, which uses :mod:`!pydoc` to generate its "
"documentation as text on the console.  The same text documentation can also "
"be viewed from outside the Python interpreter by running :program:`pydoc` as "
"a script at the operating system's command prompt. For example, running ::"
msgstr ""

#: ../../library/pydoc.rst:33
msgid "python -m pydoc sys"
msgstr ""

#: ../../library/pydoc.rst:35
msgid ""
"at a shell prompt will display documentation on the :mod:`sys` module, in a "
"style similar to the manual pages shown by the Unix :program:`man` command.  "
"The argument to :program:`pydoc` can be the name of a function, module, or "
"package, or a dotted reference to a class, method, or function within a "
"module or module in a package.  If the argument to :program:`pydoc` looks "
"like a path (that is, it contains the path separator for your operating "
"system, such as a slash in Unix), and refers to an existing Python source "
"file, then documentation is produced for that file."
msgstr ""
"シェルから行うと :mod:`sys` モジュールのドキュメントを、Unix の :program:"
"`man` コマンドのような形式で表示させることができます。 :program:`pydoc` の引"
"数として与えることができるのは、関数名・モジュール名・パッケージ名、また、モ"
"ジュールやパッケージ内のモジュールに含まれるクラス・メソッド・関数へのドット"
"形式での参照です。 :program:`pydoc` への引数がパスと解釈されるような場合で(オ"
"ペレーティングシステムのパス区切り記号を含む場合です。例えばUnixならばスラッ"
"シュ含む場合になります)、さらに、そのパスがPythonのソースファイルを指している"
"なら、そのファイルに対するドキュメントが生成されます。"

#: ../../library/pydoc.rst:46
msgid ""
"In order to find objects and their documentation, :mod:`!pydoc` imports the "
"module(s) to be documented.  Therefore, any code on module level will be "
"executed on that occasion.  Use an ``if __name__ == '__main__':`` guard to "
"only execute code when a file is invoked as a script and not just imported."
msgstr ""

#: ../../library/pydoc.rst:51
msgid ""
"When printing output to the console, :program:`pydoc` attempts to paginate "
"the output for easier reading.  If either the :envvar:`MANPAGER` or the :"
"envvar:`PAGER` environment variable is set, :program:`pydoc` will use its "
"value as a pagination program. When both are set, :envvar:`MANPAGER` is used."
msgstr ""

#: ../../library/pydoc.rst:56
msgid ""
"Specifying a ``-w`` flag before the argument will cause HTML documentation "
"to be written out to a file in the current directory, instead of displaying "
"text on the console."
msgstr ""
"引数の前に ``-w`` フラグを指定すると、コンソールにテキストを表示させるかわり"
"にカレントディレクトリにHTMLドキュメントを生成します。"

#: ../../library/pydoc.rst:60
msgid ""
"Specifying a ``-k`` flag before the argument will search the synopsis lines "
"of all available modules for the keyword given as the argument, again in a "
"manner similar to the Unix :program:`man` command.  The synopsis line of a "
"module is the first line of its documentation string."
msgstr ""
"引数の前に ``-k`` フラグを指定すると、引数をキーワードとして利用可能な全ての"
"モジュールの概要を検索します。検索のやりかたは、Unixの :program:`man` コマン"
"ドと同様です。モジュールの概要というのは、モジュールのドキュメントの一行目の"
"ことです。"

#: ../../library/pydoc.rst:65
msgid ""
"You can also use :program:`pydoc` to start an HTTP server on the local "
"machine that will serve documentation to visiting web browsers.  :program:"
"`python -m pydoc -p 1234` will start a HTTP server on port 1234, allowing "
"you to browse the documentation at ``http://localhost:1234/`` in your "
"preferred web browser. Specifying ``0`` as the port number will select an "
"arbitrary unused port."
msgstr ""
"また、 :program:`pydoc` を使うことでローカルマシンにウェブブラウザから閲覧可"
"能なドキュメントを提供するHTTPサーバーを起動することもできます。 :program:"
"`python -m pydoc -p 1234` とすると、HTTPサーバーをポート1234に起動します。こ"
"れで、お好きなウェブブラウザを使って ``http://localhost:1234/`` からドキュメ"
"ントを見ることができます。ポート番号に ``0`` を指定すると、任意の空きポートが"
"選択されます。"

#: ../../library/pydoc.rst:73
msgid ""
"The :mod:`!pydoc` HTTP server is intended for local use during development "
"and is not suitable for production use."
msgstr ""

#: ../../library/pydoc.rst:76
msgid ""
":program:`python -m pydoc -n <hostname>` will start the server listening at "
"the given hostname.  By default the hostname is 'localhost' but if you want "
"the server to be reached from other machines, you may want to change the "
"host name that the server responds to.  During development this is "
"especially useful if you want to run pydoc from within a container."
msgstr ""
":program:`python -m pydoc -n <hostname>` は、与えられたホスト名で listen する"
"サーバーを起動します。\n"
"デフォルトではホスト名は 'localhost' ですが、他のマシンからサーバーへ疎通でき"
"るようにしたい場合は、サーバーが応答するホスト名を変更したいと思うでしょ"
"う。\n"
"開発作業中に、コンテナ内で pydoc を走らせたい場合は、これは特に便利です。"

#: ../../library/pydoc.rst:82
msgid ""
":program:`python -m pydoc -b` will start the server and additionally open a "
"web browser to a module index page.  Each served page has a navigation bar "
"at the top where you can *Get* help on an individual item, *Search* all "
"modules with a keyword in their synopsis line, and go to the *Module index*, "
"*Topics* and *Keywords* pages."
msgstr ""
":program:`python -m pydoc -b` では、サーバとして起動するとともにブラウザも起"
"動し、モジュールインデクスページを開きます。提供されるページには、個別のヘル"
"プページに飛ぶための *Get* ボタン、全モジュールから概要行に基くキーワード検索"
"するための *Search* ボタン、と、*Module index*, *Topics* , *Keywords* へのそ"
"れぞれリンクがついたナビゲーションバーがページの一番上に付きます。"

#: ../../library/pydoc.rst:88
msgid ""
"When :program:`pydoc` generates documentation, it uses the current "
"environment and path to locate modules.  Thus, invoking :program:`pydoc "
"spam` documents precisely the version of the module you would get if you "
"started the Python interpreter and typed ``import spam``."
msgstr ""
":program:`pydoc` でドキュメントを生成する場合、その時点での環境とパス情報に基"
"づいてモジュールがどこにあるのか決定されます。そのため、 :program:`pydoc "
"spam` を実行した場合につくられるドキュメントは、 Pythonインタプリタを起動し"
"て ``import spam`` と入力したときに読み込まれるモジュールに対するドキュメント"
"になります。"

#: ../../library/pydoc.rst:93
msgid ""
"Module docs for core modules are assumed to reside in ``https://docs.python."
"org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor version "
"numbers of the Python interpreter.  This can be overridden by setting the :"
"envvar:`!PYTHONDOCS` environment variable to a different URL or to a local "
"directory containing the Library Reference Manual pages."
msgstr ""

#: ../../library/pydoc.rst:100
msgid "Added the ``-b`` option."
msgstr "``-b`` オプションが追加されました。"

#: ../../library/pydoc.rst:103
msgid "The ``-g`` command line option was removed."
msgstr "``-g`` コマンドラインオプションが削除されました。"

#: ../../library/pydoc.rst:106
msgid ""
":mod:`!pydoc` now uses :func:`inspect.signature` rather than :func:`inspect."
"getfullargspec` to extract signature information from callables."
msgstr ""

#: ../../library/pydoc.rst:111
msgid "Added the ``-n`` option."
msgstr "``-n`` オプションが追加されました。"

#: ../../library/pydoc.rst:9
msgid "documentation"
msgstr ""

#: ../../library/pydoc.rst:9
msgid "generation"
msgstr ""

#: ../../library/pydoc.rst:9
msgid "online"
msgstr ""

#: ../../library/pydoc.rst:9
msgid "help"
msgstr "help"