Документация по приложению “Погода” (v1.6.0)

Добро пожаловать в документацию приложения “Погода”! Это приложение предоставляет актуальную информацию о погоде и прогнозы от нескольких поставщиков метеоданных.

Возможности

Последние обновления

Подробный список изменений смотрите в файле CHANGELOG.md.

Начало работы

  1. Руководство по установке - как установить и настроить приложение
  2. Руководство пользователя - как пользоваться приложением
  3. Конфигурация - как настроить приложение

Продвинутые темы

Поддержка

По вопросам поддержки создайте issue в нашем репозитории GitHub.

Лицензия

Этот проект распространяется под лицензией GPLv3 - подробности смотрите в файле LICENSE.

Руководство пользователя

Начало работы

  1. Запуск приложения
  2. Поиск местоположения

Основной интерфейс

Отображение погоды

Навигация

Карты погоды и радар

Функция “Карты погоды и радар” предоставляет интерактивную визуализацию погодных условий и закономерностей.

Доступ к картам погоды

  1. Нажмите на Вид в строке меню
  2. Выберите Карты погоды и радар
  3. Откроется диалоговое окно с несколькими вкладками

Функции

Вкладка “Радар”

Вкладка “Температура”

Вкладка “Осадки”

Вкладка “Ветер”

Использование карты

Советы

Функции

Избранное

Настройки

  1. Нажмите на значок шестеренки (⚙️) или перейдите в Меню > Настройки
  2. Настройте такие параметры, как:
  3. Нажмите “Сохранить”, чтобы применить изменения

Командная строка

# Базовое использование
weather-app [местоположение] [параметры]

# Примеры
weather-app "Москва, RU"
weather-app --provider openweathermap --units metric
weather-app --config ~/.config/weather/config.ini

# Параметры
  -h, --help            Показать справку и выйти
  -v, --version         Показать информацию о версии
  -c, --config ФАЙЛ     Указать файл конфигурации
  -d, --debug           Включить режим отладки
  --provider ПРОВАЙДЕР  Установить поставщика погодных данных
  --units {metric,imperial}
                        Установить систему единиц измерения
  --lang ЯЗЫК           Установить код языка
  --theme {light,dark,system}
                        Установить цветовую тему
  --no-gui              Запустить в консольном режиме

Горячие клавиши

Глобальные горячие клавиши

Сочетание Действие
Ctrl + F Перейти к строке поиска
Ctrl + , Открыть настройки
F5 Обновить данные о погоде
Ctrl + Q Выйти из приложения

Навигация по карте

Сочетание Действие
+ Увеличить масштаб
- Уменьшить масштаб
Стрелки Прокрутка карты
R Сбросить вид карты
F Найти мое местоположение

Устранение неполадок

Частые проблемы

  1. Нет данных о местоположении
  2. Устаревшие данные
  3. Проблемы с картами

Сброс приложения

  1. Очистка кэша: 
    # Linux/macOS
rm -rf ~/.cache/weatherapp
   
# Windows
del /s /q %APPDATA%\WeatherApp\cache
  2. Сброс настроек: 
    # Linux/macOS
rm ~/.config/WeatherApp/config.ini
   
# Windows
del %APPDATA%\WeatherApp\config.ini
  3. Полная переустановка: 
    # Сначала создайте резервную копию ваших данных
# Затем удалите каталог приложения

Разработка

Сборка из исходников

  1. Клонируйте репозиторий: 
    git clone https://github.com/Nsfr750/weather.git
cd weather
  2. Установите зависимости: 
    pip install -r requirements.txt
  3. Запустите в режиме разработки: 
    python -m weatherapp

Создание пакетов

Windows

pyinstaller --onefile --windowed --icon=assets/icon.ico weatherapp/__main__.py

Linux

pyinstaller --onefile --windowed --icon=assets/icon.png weatherapp/__main__.py

macOS

pyinstaller --onefile --windowed --icon=assets/icon.icns --osx-bundle-identifier com.example.weatherapp weatherapp/__main__.py

Лицензия

Это программное обеспечение распространяется под лицензией GPLv3. См. файл LICENSE для получения полного текста лицензии.

Благодарности

© 2023 Nsfr750. Все права защищены.