差分

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

--- ja:bugs [2009-12-10 16:32] – created kazmiya
+++ ja:bugs [2023-03-05 15:47] (現在) – Aleksandr
@@ 行 1: / 行 1: @@
+====== DokuWikiのバグ報告 ======
-====== バグトラッキングシステム ======
+どんなソフトウェアにもバグがあります。
+私たちは、毎回 DokuWiki の可能な限り最高のバージョンを出荷しようとしますが、エラーは発生します。
+このページは、遭遇する可能性のあるバグの報告に関してあなたを助けます。
-DokuWiki は[[http://bugs.splitbrain.org/index.php?project=1|バグトラッキングシステム]] (BTS) を持っています。すべてのバグと機能の要望はそこに報告してください。バグを報告する場合は必ず、使用している OS、Web サーバ、そして Web ブラウザの情報を報告に含めるようにしてください。要求された場合は ''doku.php?do=debug'' を実行し、出力結果を添付してください。
+===== バグであることを確認してください =====
-**テストの作成依頼**: バグ報告の際に、もし可能であれば失敗する[[:ja:devel:unittesting|ユニットテスト]]を添付してください。これは本当に//大いに//役立ちます。
+何かを報告する前に、自分が遭遇した問題が本当にバグなのかを調査してください。
+何らかの理由でそれが意図されている動作ではないですか？
+調整できる[[ja:config|設定]]はありませんか？
-バグを報告する前に、[[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html|How to Report Bugs Effectively]] を読んでおいてください。
+また、既に他人が同じ問題を抱えていなかったかどうか[[https://forum.dokuwiki.org/|フォーラム]]を検索してください。
+修正が既にありませんか？
-こちらも忘れずに: [[http://www.grassouille.org/blogmax/041009.html|Every time you submit a bad bug report, god kills a kitten]]
+まだ疑問が残る場合、バグ報告を開きます。
+そのバグ報告はいつでも閉じることができますし、バグではないと判明するかもしれません。
-===== バグトラッキングシステムの使い方 =====
+===== 問題が既に報告されていないかを確認してください =====
-最初に、そのバグや機能要望が既に登録されていないことを確認してください。ページ上部の検索ボックスにキーワードをいくつか入力し、**''All Statuses'' を選択します**。こうすることにより、既にクローズされたバグなども検索できるようになります。あなたのバグは既に解決済みかもしれません。;-)
+すべてのバグはバグ追跡システムに報告する必要があります。
+GitHub の以下の場所にあります：
+[[https://github.com/dokuwiki/dokuwiki/issues]]
-もし「あなたの」バグに関する既存の報告が見つかったら、役に立つ追加情報を提供できる場合はコメントもしくは添付ファイルをそこに追加してください。そのバグのステータスが変更されたときにお知らせを受け取るため、通知リストにあなた自身を追加することもできます。
+問題が既に報告されているかを確認するために検索を使用します。
+また、同様に閉じたバグを検索確認してください。
+開発バージョンではバグが既に修正されている可能性があります。
-もしあなたのバグに関する報告が見つからなかった場合は、ページの一番上にある ''Add new task'' からバグを報告してください。入力を求められたフィールドをすべて埋めるために、少しお時間をいただきます。
+バグが既に報告されていた場合、バグ修正を支援するための追加情報を提供できるかどうか、確認してください。
+方法については、以下を参照してください。
-===== 最近オープンされたタスク =====
+===== バグを報告します =====
-{{rss>http://bugs.splitbrain.org/feed.php?feed_type=rss2&project=1 1h}}
+前述したように、バグは [[https://github.com/dokuwiki/dokuwiki/issues]] に報告**すべき**で、このためには無料 GitHub アカウントが必要です。
+他の場所（IRC・Twitter・フォーラム）でバグ報告を**しないでください**。
+GitHub のバグ追跡システムがバグ報告の唯一の標準的な方法です。
+バグを報告するとき、できるだけ多くの情報を含めるようにしてください。
+それが問題を特定する開発者の助けになります。
+以下を含めるべきです：
+  * DokuWiki のバージョン
+  * サーバとクライアントのオペレーティングシステム
+  * 使用した Web サーバー
+  * 使用した PHP のバージョン
+  * 使用したブラウザ（複数試してください）
+  * 自分の設定に関する特記事項全て（プラグイン・認証バックエンド・ネットワーク設定等）
+  * 問題を再現する正確な手順
+  * スクリーンショット
+正確なエラーメッセージを収集することは特に重要です！
+Web サーバーと JavaScript コンソール（下記参照）からエラーログを見つけることができないか見て下さい。
+また、有益なバグレポートを提出する上でのヒントのために [[https://www.chiark.greenend.org.uk/~sgtatham/bugs-jp.html|効果的にバグを報告する方法]]をお読みください。
+===== 追加情報の取得方法 =====
+上記のように、DokuWiki の開発者が問題をデバッグするために詳細なエラーメッセージが必要です。
+エラーメッセージは画面に直接印刷される場合もありますが、そうでないこともあります。
+この場合、次のオプションを確認することをお勧めします：
+==== サーバー・PHP のエラーログ ====
+何かが致命的にうまくいかない場合、PHP は要求の処理を停止します。
+通常は[[:ja:faq:blankpage|空のページもしくはページの一部しか表示されないページ]]が結果になります。
+エラーはそれほど重大ではないかもしれませんが、物事はまだ不足しています。
+これらすべての場合、PHP はいくつかのログファイルにエラーメッセージを記録します。
+ログファイルが存在する正確な場所は、システムによって異なります。
+エラーは、Web サーバーのエラーログ・システムのグローバルログ・個別の PHP のエラーログに記録されます。
+これは、 ''php.ini'' の [[phpfn>error_log]] 宣言で設定されます。
+一般的な場所は以下のとおりです：
+  * /var/log/apache2/error.log
+  * /var/log/apache/error.log
+  * /var/log/httpd/error.log
+  * /var/log/syslog
+レンタルサーバー上にある場合は、ログを検索する場所のプロバイダに問い合わせるべきです。
+''php.ini'' へのアクセス権がなくログファイルが見つからない場合、DokuWiki ルートフォルダ内の ''.htaccess'' ファイルに以下を追加してみてください：
+<code>
+php_value display_errors 1
+php_value display_startup_errors 1
+</code>
+ブラウザにエラーメッセージを送信することができます。
+==== JavaScript コンソールログ ====
+クライアント側（ブラウザ内）で間違っている場合もあります。
+把握するためには、ブラウザの JavaScript コンソールにアクセスする必要があります。
+そのために次のキーボードショートカットを使用します：
+^ ブラウザ ^ Windows/Linux                ^ Mac                       ^
+| Chrome   | ''Ctrl'' + ''Shift'' + ''J'' | ''Cmd'' + ''Opt'' + ''J'' |
+| Firefox  | ''Ctrl'' + ''Shift'' + ''K'' | ''Cmd'' + ''Opt'' + ''K'' |
+| Internet Explorer | ''F12'', then click on the “Console” tab      ||
+| Safari   |                              | ''Cmd'' + ''Opt'' + ''C'' |
+コンソールですべてのエラー（通常は赤で表示）を参照する場合、[[ja:plugin:config|設定管理]]に移動し、[[ja:config:compress|設定項目: compress]] を無効にします。
+ページを再読み込みして、もう一度エラーの JavaScript コンソールを確認してください。
+JavaScript コンソールにエラーを見つけた場合、常にバグレポートに添付する必要があります。
+できれば、[[ja:config:compress|設定項目: compress]] を無効にして探して下さい。
+しかし、[[ja:config:compress|設定項目: compress]] を有効にした場合しかエラーを表示しないことがあります。
+そのような場合は、これらのエラーメッセージを送って下さい。
+===== 最近オープンしたタスク =====
+{{rss>https://feeds.feedburner.com/dokuwiki-recently-opened-tasks date}}