Как сообщать о проблемах

Если, несмотря на изучение документации и руководств, вы столкнулись со странным поведением, эта страница подскажет вам, как действовать дальше. Имейте в виду, что если что-то не работает, это не обязательно означает, что есть ошибка. Чаще всего проблемы возникают из-за неправильного использования. В таких случаях крайне важно предоставить точную информацию о проблеме, которая поможет нам определить, является ли это ошибкой или недоразумением. Обратитесь за рекомендациями к разделу о том, как отправить нам полезную информацию. Действительно, простое заявление, что это не работает, не поможет нам найти решение. Мы не предсказатели, и нам нужна информация, чтобы определить проблему и найти решение. Поэтому важно, чтобы вы рассказали нам, что вы делали в момент возникновения проблемы, какую операционную систему вы используете, какую версию Siril вы используете и, самое главное, журнал выполнения программы!

Проверьте журналы изменений и системы отслеживания ошибок

Прежде всего, если вы думаете, что нашли ошибку в Siril, о ней уже могли сообщить (иногда буквально десятки раз). Поэтому мы просим вас сначала проверить, например, просмотрев журналы изменений или замечания <https://gitlab.com/free-astro/siril/-/issues>, которые уже были открыты и даже закрыты.

Предоставьте нам полезную информацию

Как уже упоминалось во введении, нам нужна полезная информация, которая поможет решить проблему:

1. Какую операционную систему вы используете? Поскольку Siril может вести себя по-разному в Windows, Linux или macOS, нам необходимо знать эту информацию. Пожалуйста, будьте максимально точны.

2. Какую версию Siril вы используете? И как вы ее получили? Пакет скачали на сайте? Через третье лицо? Скомпилировали сами? И здесь, пожалуйста, будьте максимально точны.

3. Иногда полезно делиться скриншотами. Однако, пожалуйста, НЕ ДЕЛАЙТЕ СВОИ СКРИНШОТЫ НА СМАРТФОН — это неразборчиво. Ваша операционная система умеет делать скриншоты очень легко (Google поможет вам в этом), и Siril также предлагает такую функцию (кнопка с камерой). Наконец, желаемые форматы — это форматы изображений: jpg, bmp или png, но ни в коем случае не pdf.

4. Отправьте нам журналы выполнения программы (логи). В идеале мы предпочитаем логи на английском языке! Просто перейдите в настройки Siril и измените язык на английский на вкладке Интерфейс. Кроме того, существует два типа журналов: один отображается в консоли Siril, который описывает шаги, выполняемые программным обеспечением, и может помочь нам в отладке, и внутренние журналы, которые видны при запуске Siril из командной строки:

   • Первые очень полезны в большинстве случаев и могут быть экспортированы очень легко с помощью кнопки в правом нижнем углу. Это создает файл, который можно легко отправить нам.

   • Однако, когда программное обеспечение зависает (т.е. внезапно закрывается без предупреждения), вам нужно запустить Siril из командной строки, пытаясь воспроизвести сбой и получить журналы. Здесь метод зависит от операционной системы.

     • Microsoft Windows: Откройте окно cmd (введите cmd в строке поиска Windows) и введите следующее:

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

       Это сохранит файл output.log в папке, в которой был запущено окно командной строки (в большинстве случаев в папке %USERPROFILE%).

     • macOS: Если вы установили Siril в папку Applications, как обычно рекомендуется, то для начала откройте приложение Terminal из папки Utilities в разделе Applications, затем скопируйте и вставьте следующую строку:

       /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 номера запроса.

Совет

Поскольку пользователи и разработчики Siril принадлежат к разным национальностям, языком, используемым для сообщения об ошибке, должен быть английский.