差分

このページの2つのバージョン間の差分を表示します。

--- ja:plugin:extension [2014-05-10 20:20] – 作成 125.55.214.60
+++ ja:plugin:extension [2014-09-07 22:06] (現在) – 2014-09-05 16:16 版 sawachan
@@ 行 1: / 行 1: @@
-====== 拡張機能プラグイン ======
+====== 拡張機能管理プラグイン ======
 ---- plugin ----
-description: プラグインとテンプレートを管理・インストールする（DokuWiki に同梱）。
+description: プラグインとテンプレートの管理・インストール機能（DokuWiki に同梱）
 author     : Michael Hamann
 email      : michael@content-space.de
 type       : admin
-lastupdate :
+lastupdate : 2014-06-15
 compatible : (bundled)
 depends    :
@@ 行 23: / 行 23: @@
 ===== 概要 =====
-拡張機能管理プラグインは、[[ja:config:superusers|スーパーユーザー]]がインストール済プラグインとテンプレートを管理し、新規プラグインとテンプレートをインストールできるようにします。
+拡張機能管理プラグインは、インストール済プラグイン・テンプレートの管理機能と新規プラグイン・テンプレートをインストール機能を、[[ja:config:superusers|スーパーユーザー]]に提供します。
 ===== 使用方法 =====
@@ 行 29: / 行 29: @@
 拡張機能管理は管理画面からアクセスできます（スーパーユーザーでログイン、「管理」をクリック、「拡張機能管理」を選択します）。
-==== インストール済プラグインとテンプレートの一覧表示=====
+==== インストール済プラグイン・テンプレートの一覧表示=====
 インストール済プラグイン一覧は、拡張機能管理のデフォルトの動作です。
 二つ目のタブがインストール済テンプレート一覧です。
 各プラグインやテンプレートは、一行毎に表示されます。
-右側の列には、無効化／有効化、インストール／アンインストール／再インストール／更新のような操作ボタンが含まれます。
+右側の列には、無効化／有効化、インストール／アンインストール／再インストール／更新のような操作ボタンがあります。
-灰色フォントのプラグインとテンプレートは現在無効化されています。
+灰色フォント状態ののプラグインとテンプレートは現在無効化されています。
 ==== プラグインの有効化・無効化 ====
@@ 行 42: / 行 42: @@
 プラグインを無効化／有効化にするには、右側の無効化と有効化ボタンを使用します。
-無効なプラグインは DokuWiki に読み込まれず、[[ja:devel:css|スタイルシート]]や[[ja:devel:JavaScript|JavaScript]]は読み込まれず、構文も無効になります。
+無効なプラグインは DokuWiki に読み込まれず、[[ja:devel:css|スタイルシート]]や[[ja:devel:JavaScript|JavaScript]]も読み込まれず、構文も無効になります。
 ==== 拡張機能の詳細表示 ====
-右下隅にある矢印ボタンを押すと、オンライン上のプラグインリポジトリやローカルのプラグイン情報ファイルから取得したプラグインについての基本的な情報を表示します。
+右下隅にある矢印ボタンを押すと、二種類の情報源から取得したプラグインについての基本的な情報を表示します。
-ダウンロード URL は、作者からプラグインリポジトリを経由して提供されます。
-==== 管理画面からの検索とインストール ====
+  - オンライン上の DokuWiki リポジトリ
+    * プラグイン：[[https://www.dokuwiki.org/plugin]]
+    * テンプレート：[[https://www.dokuwiki.org/template]]
+  - 拡張機能と同時にインストールした、ローカルの情報ファイル
+    * プラグイン比較用：[[devel:plugin_info|Plugin Information]]
+    * テンプレート比較用：[[devel:template_info|Template Information]]
-拡張機能管理の三つ目のタブ「検索とインストール」の中で、プラグインとテンプレートを検索し、「インストール」ボタンを利用してインストールできます。
+リポジトリの情報を最初に表示し、次にローカルの情報ファイルの情報と比較されます。
-第三者の作成したコードのインストールには、セキュリティ上の危険の可能性があることに注意して下さい。
+このローカル情報は古いかもしれません。
-==== 手動インストール ====
+==== 拡張機能のインストール ====
+拡張機能は、便利な機能を追加しますが、第三者の作成したコードのインストールには、セキュリティ上の危険の可能性があることに注意して下さい。
+=== 管理画面からの検索とインストール ===
+拡張機能管理の三つ目のタブ「検索とインストール」の中で、dokuwiki.org の拡張機能リポジトリからプラグインとテンプレートを検索し、「インストール」ボタンを使ってインストールできます。
+=== 手動インストール ===
 オンラインリポジトリ経由では未提供提供、別のダウンロード元にあるバージョンのプラグインとテンプレートは、四つ目のタブ「手動インストール」からインストールできます。
 URL を指定するか、コンピュータ内のアーカイブを選択できます。
-==== 拡張機能の更新 ====
+==== 再インストールと更新 ====
+インストール済み拡張機能に関して[[#拡張機能の詳細表示|自動的に収集された情報]]に応じて、「再インストール」や「更新」ボタンが表示されます。
+:!: オンラインリポジトリと同じ名前の異なる拡張機能をインストールしている場合、この機能は**使用しない**でください。
+オンラインリポジトリが利用できない拡張機能にはこのようなボタンは表示されません。
+サポートの終了、リポジトリへの未登録、代替インストールソースの使用が原因と考えられます。
+最後は、[[wpjp>Git]] を利用してインストールした拡張機能の場合が多いです。
+=== 拡張機能の再インストール ===
+拡張機能がおかしい理由がわからない場合、再インストールは有効かもしれません。
+=== 拡張機能の更新 ===
 「更新」を押した場合、アップデートを取得するため拡張機能管理はオンラインリポジトリから提供されたダウンロード URL を使用します。
-最新のダウンロード URL を検索することで、拡張機能の最新バージョンを保証します。
+拡張機能管理は、拡張機能を再ダウンロード・再インストールして、古いバージョンを上書きします。
-拡張機能管理は、古いバージョンを上書きするために、拡張機能を再ダウンロードして再インストールします。
+更新処理が正常に機能するには、Dokuwiki の拡張機能リポジトリ内の「最終更新日」とソースの tarbal/zip ファイル内のプラグインの [[devel:plugin_info|plugin.info.txt]] ファイルやテンプレートの　[[devel:template_info|template.info.txt]] ファイルの日付が一致している必要があります。
+そうでない場合：アップデートは実施されないか、「更新」状態が継続します。
+==== 拡張機能のアンインストール ====
+すべてのインストール済み拡張機能には、「アンインストール」ボタンがあります。
+=== 手動アンインストール ===
+欠陥のあるインストール、競合する拡張機能が「アンインストール」ボタンを壊した、Wiki 全体が使用不能になった場合、拡張機能のディレクトリを削除する（または管理者に削除を要求する）ことで拡張機能を削除できます：
-[ここに注意：拡張機能管理を使ってインストールされなかった拡張機能は、この方法で更新できません。この拡張機能の「更新」ボタンは無効になっています。FIXME]
+  - wiki のファイルシステムを入力する。
+  - ''/lib/tpl''（テンプレートの場合）または ''/lib/plugins'' フォルダーに移動します。
+  - 該当する拡張機能フォルダーを探し、削除します。
 ===== ファイルのアクセス権 =====
@@ 行 73: / 行 112: @@
 拡張機能管理は足りないファイルのアクセス権を検出し、プラグインやテンプレートがインストールできない場合は警告します。
-この場合には、''lib/plugins'' や ''lib/tpl'' に自分でダウンロードと解凍して、手動で拡張機能をインストールする必要があります。
+この場合には、拡張機能を自分でダウンロードと解凍して、''lib/plugins'' や ''lib/tpl'' に手動でインストールする必要があります。
-===== 可能性のあるエラー原因 =====
+===== Possible Error Sources =====
 If you try to install extensions using the automatic download and install tool and get the error message "//No plugins found, or there has been an unknown problem during downloading and installing.//", then you should check:
   * whether your server has activated the zlib (and/or bzip2) extension for php.  To be sure, try the following: Download an extension, extract it, and rearchive it into a .tar file (without compression). Now try to use the download and install tool on that .tar file. If it works now, it is most likely that you just need to install the ''php-zlib'' package.
-  * whether your server is able to retrieve files over SSL (%%https://%%).  Many extensions (correctly) use secure download links, including all those hosted on github. If your server is incorrectly setup to use SSL for file retrieval, try dropping SSL by deleting the 's' and changing the schema to '%%http://%%' or see [[#another_error_source_for_failed_downloadsssl|below]].
+  * whether your server is able to retrieve files over SSL (%%https://%%).  Many extensions (correctly) use secure download links, including all those hosted on github. If your server is incorrectly setup to use SSL for file retrieval, try dropping SSL by deleting the 's' and changing the schema to '%%http://%%'.