discordpy - en to ja_JP translation catalogue (14 entries)

en: Extensions
ja_JP: エクステンション

en: There comes a time in the bot development when you want to extend the bot functionality at run-time and quickly unload and reload code (also called hot-reloading). The command framework comes with this ability built-in, with a concept called **extensions**.
ja_JP: ボット開発ではボットを起動している間にコードを素早くアンロードし、再度ロードし直したい (ホットリロードとも呼ばれます) という時があります。コマンドフレームワークでは **エクステンション** と呼ばれる概念でこの機能が組み込まれています。

en: Primer
ja_JP: はじめに

en: An extension at its core is a python file with an entry point called ``setup``. This setup function must be a Python coroutine. It takes a single parameter -- the :class:`~.commands.Bot` that loads the extension.
ja_JP: その中核となるエクステンションは ``setup`` というエントリポイントを持つPythonファイルです。このsetupはPythonのコルーチンである必要があります。この関数はエクステンションをロードする :class:`~.commands.Bot` を受け取るための単一のパラメータを持ちます。

en: An example extension looks like this:
ja_JP: エクステンションの例は以下のとおりです:

en: In this example we define a simple command, and when the extension is loaded this command is added to the bot. Now the final step to this is loading the extension, which we do by calling :meth:`.Bot.load_extension`. To load this extension we call ``await bot.load_extension('hello')``.
ja_JP: この例では簡単なコマンドを定義し、エクステンションが読み込まれた際に、コマンドがボットに追加されるようにします。最後にエクステンションを読み込むために、 :meth:`.Bot.load_extension` を呼び出します。このエクステンションを読み込むためには、 ``await bot.load_extension('hello')`` を呼び出します。

en: Cogs
ja_JP: コグ

en: Extensions are usually used in conjunction with cogs. To read more about them, check out the documentation, :ref:`ext_commands_cogs`.
ja_JP: エクステンションは通常、コグと組み合わせて使用します。詳細については :ref:`ext_commands_cogs` のドキュメントを参照してください。

en: Extension paths are ultimately similar to the import mechanism. What this means is that if there is a folder, then it must be dot-qualified. For example to load an extension in ``plugins/hello.py`` then we use the string ``plugins.hello``.
ja_JP: エクステンションのパスは究極的にはimportのメカニズムと似ています。これはフォルダ等がある場合、それをドットで区切らなければならないということです。例えば ``plugins/hello.py`` というエクステンションをロードする場合は、 ``plugins.hello`` という文字列を使います。

en: Reloading
ja_JP: リロード

en: When you make a change to the extension and want to reload the references, the library comes with a function to do this for you, :meth:`.Bot.reload_extension`.
ja_JP: エクステンションに変更を加えて、その変更を再読み込みしたい場合があります。このためにライブラリには :meth:`.Bot.reload_extension` という関数が用意されています。

en: Once the extension reloads, any changes that we did will be applied. This is useful if we want to add or remove functionality without restarting our bot. If an error occurred during the reloading process, the bot will pretend as if the reload never happened.
ja_JP: エクステンションを再読込みすると、その変更が適用されます。ボットを再起動せずに機能の追加や削除を行いたい場合に便利です。再読込処理中にエラーが発生した場合、ボットは再読込処理をする前の状態に戻ります。

en: Cleaning Up
ja_JP: クリーンアップ

en: Although rare, sometimes an extension needs to clean-up or know when it's being unloaded. For cases like these, there is another entry point named ``teardown`` which is similar to ``setup`` except called when the extension is unloaded.
ja_JP: 稀ではありますが、エクステンションにクリーンアップが必要だったり、いつアンロードするかを確認したい場合があります。このために ``setup`` に似たエクステンションがアンロードされるときに呼び出される ``teardown`` というエントリポイントが用意されています。
