問題の報告方法

ドキュメントやチュートリアルを確認したにもかかわらず、予期せぬ動作が発生している場合は、このページの手順に従ってください。なお、動作しないからといって、必ずしもバグであるとは限りませんのでご注意ください。多くの場合、問題は誤った使用方法に起因しています。そのような場合、それがバグなのか、それとも誤解によるものなのかを判断するために、問題に関する正確な情報を提供することが極めて重要です。具体的な手順については、有用な情報の送信方法 の節を参照してください。単に「動作しない」と伝えるだけでは、解決策を見つけるのに役立ちません。私たちは予言者ではありません。問題を特定し、解決策を考案するためには情報が必要です。そのため、問題が発生した際の操作内容、使用しているオペレーティングシステム、Sirilのバージョン、そして何よりも重要なログを、ぜひお知らせください！

変更履歴とバグトラッカーを確認する

まず、Sirilにバグを見つけたと思われる場合でも、すでに報告されている可能性があります（時には文字通り数十回も報告されていることもあります）。そのため、まずは changelogs や、すでに オープン されている、あるいは クローズ された チケット などを確認するようお願いします。

有益な情報を送る

はじめに述べたように、この問題を解決するには、役立つ情報が必要です:

  1. お使いのOSは？SirilはWindows、Linux、macOSで動作が大きく異なるため、この情報が必要です。できるだけ正確に記入してください。

  2. どのバージョンのSirilをお使いですか？また、どのように入手されましたか？公式サイトからパッケージをダウンロードしましたか？サードパーティ経由ですか？それともご自身でコンパイルされましたか？ここでも、できるだけ詳しく教えてください。

  3. スクリーンショットを共有すると便利な場合があります。ただし、スマートフォンでスクリーンショットを撮らないでください。文字が判読できないからです。お使いのOSには簡単にスクリーンショットを撮る機能があります（Google を検索すると参考になります）。また、Sirilにも同様の機能（カメラのアイコン）が用意されています。最後に、推奨される形式は画像形式（jpg、bmp、または png）ですが、絶対に pdf 形式は使用しないでください。

  4. ログを送ってください。できれば、英語のログが望ましいです！Sirilの設定画面を開き、ユーザーインタフェース タブで言語を英語に変更してください。また、ログには2種類あります。1つはSirilコンソールに表示されるログで、ソフトウェアが実行した手順が記録されており、デバッグに役立ちます。もう1つは、Sirilをコマンドラインから実行した際に表示される内部ログです:

    • 前者はほとんどの場合に非常に役立ち、右下のボタンを使って簡単にエクスポートできます。これにより、私たちに簡単に送信できるファイルが作成されます。

    • ただし、ソフトウェアがクラッシュした場合（つまり、警告なしに突然終了した場合）、コマンドラインからSirilを起動し、クラッシュを再現させてログを取得することが必要です。この際の手順は、オペレーティングシステムによって異なります。

      • Microsoft Windows: コマンドウインドウを開き（Windows の検索バーに cmd と入力）、次のように入力します:

        "C:\Program Files\Siril\bin\siril.exe" 2>&1 >output.log

        これにより、ファイル output.log がターミナルを起動したフォルダー（多くの場合、%USERPROFILE% フォルダー）に保存されます。

      • macOS: 一般に推奨されているように、Sirilをアプリケーションフォルダにインストールした場合、まずアプリケーション内のユーティリティフォルダからターミナルアプリケーションを開き、以下の行をコピー＆ペーストします:

        /Applications/Siril.app/Contents/MacOS/siril > ~/Desktop/output.log 2>&1

        クラッシュ後、ログはデスクトップ上の output.log というファイルで確認できます。

      • GNU/Linux: ターミナルでSirilを起動するだけです。通常、バイナリは $PATH 変数に設定されたパスにあります。その場合は、次のように入力してください:

        siril > output.log 2>&1

        これで、ログが output.log ファイルにリダイレクトされるようになります。これにより、output.log ファイルはターミナルが起動されたフォルダに保存されます

  5. 画像を送ってください。もし何か変わった画像を見つけたら、遠慮なく私たちに共有してください。通常はFITS形式でお願いします。スクリーンショットよりもずっと興味深いものです。そのためには、大容量ファイル転送サービスを利用することが必要です。そのようなサービスは数多くありますが、例えば WeTransfer をお勧めします。その場合は、WeTransferにデータをアップロードし、共有用のダウンロードリンクを取得してください。

問い合わせ方法

問い合わせやバグの報告には、いくつかの方法があります。最も簡単なのは、フォーラム を利用することです。また、私たちの GitLab リポジトリ でチケットを開くことも可能です。その場合は、まず同じチケットがすでに作成されていないか確認してください。解決済みでクローズされている可能性もあります。その場合、Changelog にチケット番号付きの簡単な説明が表示されます。チケット（クローズ済みのものも含む）を表示し、同じ問題が発生しているかどうかを確認するには、https://gitlab.com/free-astro/siril/-/issues/XXXX（XXXXはチケット番号）にアクセスしてください。

Tip

Sirilのユーザーや開発者はさまざまな国籍の方々がいますので、バグ報告には英語を使用してください。