Skip to content

Latest commit

 

History

History
209 lines (161 loc) · 12.5 KB

File metadata and controls

209 lines (161 loc) · 12.5 KB
Красивый настраиваемый генератор посадочных талонов с настоящими QR-кодами IATA BCBP

GitHub Stars GitHub Forks GitHub Issues GitHub last commit GitHub License

📝 Статус перевода: Этот русский README в настоящее время является заполнителем. Требуется полный перевод.

🤖 Уведомление о переводе: Эта документация была переведена с использованием искусственного интеллекта (LLM). Она может содержать ошибки или неточности. Исправления и улучшения приветствуются.

🎯 Живой просмотр: https://one-boarding.linkyou.top/


简体中文 | English | 日本語 | 한국어 | Français | Deutsch | Español


Обзор проекта ✨

One-boarding генерирует красивые, настраиваемые интерфейсы посадочных талонов с настоящими QR-кодами посадки, созданными в соответствии с форматом IATA Bar Coded Boarding Pass.

Скриншоты ✨

One-boarding Interface

Основные функции 🎯

✈️ Отображение информации посадочного талона

  • Информация о рейсе: Номер рейса, дата рейса, аэропорты вылета и прилета
  • Информация о пассажире: Имя пассажира, номер билета, ID участника, уровень участника
  • Информация о посадке: Время посадки, код класса салона, номер места, выход
  • QR-код: Настоящие QR-коды посадки, соответствующие стандартам IATA BCBP

🌍 Поддержка Интернационализации (i18n)

Этот проект поддерживает 14 языков с выбором языка на странице посадочного талона:

Поддерживаемые Языки

  • zh-Hans: 简体中文 🇨🇳
  • zh-Hant: 繁體中文 🇹🇼
  • en-US: English (United States) 🇺🇸
  • fr-FR: Français (France) 🇫🇷
  • de-DE: Deutsch (Deutschland) 🇩🇪
  • es-ES: Español (España) 🇪🇸
  • pt-PT: Português (Portugal) 🇵🇹
  • it-IT: Italiano (Italia) 🇮🇹
  • ru-RU: Русский (Россия) 🇷🇺
  • ja-JP: 日本語 (日本) 🇯🇵
  • ko-KR: 한국어 (대한민국) 🇰🇷
  • tr-TR: Türkçe (Türkiye) 🇹🇷
  • pl-PL: Polski (Polska) 🇵🇱
  • hu-HU: Magyar (Magyarország) 🇭🇺

Методы Переключения Языка

  1. Автоопределение: Автоматически выбирает язык на основе настроек браузера
  2. URL-параметр: Указать язык используя ?lang=код-языка, например, ?lang=en-US
  3. Селектор страницы: Использовать выпадающее меню языка в правом верхнем углу
  4. Локальное хранилище: Выбранный язык сохраняется в браузере для будущих посещений

Содержание Перевода

Вся авиационная терминология, связанная с посадочными талонами, профессионально переведена согласно региональным конвенциям, включая:

  • Заголовки посадочных талонов и метки полей
  • Авиационная терминология (номер рейса, выход, место и т.д.)
  • Метки форм и текст заполнителей
  • Текст кнопок и уведомления

🏗️ Технические Функции

  • Развертывание одного файла: Основная функциональность содержится в одном HTML-файле для простого развертывания
  • Адаптивный дизайн: Совместим с настольными и мобильными устройствами
  • Предварительный просмотр в реальном времени: Мгновенный просмотр посадочного талона
  • Пользовательская информация: Поддержка настройки всех полей посадочного талона
  • Поддержка авиакомпаний: Поддержка логотипов нескольких авиакомпаний

Структура Проекта 📁

Проект использует минималистичную архитектуру с внешними JavaScript-библиотеками и JSON-файлами переводов для интернационализации:

one-boarding/
├── index.html          # Основной HTML-файл, содержащий полный генератор посадочных талонов
├── js/
│   ├── i18n.js        # Реализация интернационализации, обрабатывает загрузку языков и замену текста
│   ├── bcbp.min.js    # Библиотека генерации QR-кодов IATA BCBP
│   └── qrcode.min.js  # Библиотека генерации QR-кодов
├── locales/           # Файлы переводов для каждого языка
│   ├── zh-Hans.json   # Упрощенный китайский
│   ├── en-US.json     # Английский
│   └── ...            # Другие языковые файлы
├── img/               # Файлы логотипов авиакомпаний
│   ├── 3u.png        # Sichuan Airlines
│   ├── ca.png        # Air China
│   └── ...           # Другие логотипы авиакомпаний
└── readme/           # Ресурсы, связанные с README
    └── main.png      # Скриншот проекта

Быстрый старт 🚀

Установка и развертывание

  1. Клонировать репозиторий:

    git clone https://github.com/cornjosh/one-boarding.git
    cd one-boarding
  2. Локальная разработка:

    # Открыть index.html напрямую в браузере
    open index.html
    
    # Или использовать локальный сервер
    python -m http.server 8000
    # Посетить http://localhost:8000
  3. Онлайн-опыт: Посетить напрямую: https://one-boarding.linkyou.top/

Инструкции по Использованию

  1. Открыть файл index.html для просмотра страницы посадочного талона в браузере
  2. Нажать кнопку "Использовать Демо Информацию" для открытия модального диалога
  3. Ввести соответствующую информацию в модальном окне для генерации посадочного талона с вашими данными
  4. Сгенерированные QR-коды соответствуют стандартам IATA BCBP и могут использоваться для фактической проверки посадки

Пользовательские Авиакомпании

Проект поддерживает логотипы для следующих авиакомпаний:

  • Sichuan Airlines (3u)
  • Spring Airlines (9c)
  • Air China (ca)
  • China Southern Airlines (cz)
  • Hainan Airlines (hu)
  • Xiamen Airlines (mf)
  • China Eastern Airlines (mu)

Вы можете добавить поддержку для большего количества авиакомпаний, добавив соответствующие файлы логотипов в директорию img/.

Совместимость 🔧

Протестировано в современных браузерах (Chrome, Firefox, Safari и т.д.). Более старые версии браузеров могут испытывать проблемы со стилизацией или функциональностью.

Системные требования:

  • Современные браузеры (Chrome 60+, Firefox 55+, Safari 12+, Edge 79+)
  • Поддержка JavaScript
  • Интернет-соединение (для загрузки шрифтов и ресурсов)

Вклад 🤝

Вклад в проект One-boarding приветствуется!

🐛 Отчеты об Ошибках

  • Создать issue на GitHub с описанием проблемы
  • Включить информацию о версии браузера и операционной системе
  • Предоставить шаги воспроизведения и скриншоты ошибок

💡 Предложения Функций

  • Предложить новые функции или улучшения
  • Объяснить случаи использования и ожидаемые результаты

🌍 Вклад в Переводы

  • Помочь улучшить существующие переводы языков
  • Добавить поддержку новых языков
  • Обновить переводы документации

💻 Вклад в Код

  • Форкнуть репозиторий проекта
  • Создать ветку функций
  • Отправить Pull Request с четкими описаниями

Дорожная Карта Разработки 📋

Текущая Версия (v2.0)

  • Добавлена поддержка интернационализации с 14 языковыми опциями
  • Реализована генерация QR-кодов стандарта IATA BCBP
  • Оптимизация адаптивного дизайна

Будущие Планы

  • Функциональность обмена WeChat
  • Поддержка большего количества логотипов авиакомпаний
  • Версия мобильного приложения
  • Функции пакетной генерации
  • Пользовательские темы и стилизация

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

Этот проект был вдохновлен и поддержан следующими отличными проектами:

Ссылки на проекты

  • @georgesmith46/bcbp - Библиотека кодирования/декодирования IATA Bar Coded Boarding Pass
  • @mavinii/boarding-pass - Справочник дизайна посадочного талона

Особая благодарность всем участникам и тестировщикам за их поддержку! 🙏


🎫 One-boarding ©Josh Zeng. Выпущено под лицензией MIT.

Создано и поддерживается Josh Zeng.

@Blog · @GitHub · Живое Демо