Shpal Docs

История изменений

Все обновления и изменения в документации Shpal Docs

История изменений документации

Здесь вы можете отслеживать все обновления и улучшения документации.


2024-11-01

✨ Добавлено

  • Новый дизайн главной страницы - полностью переработана главная страница на основе современного дизайна с интерактивным фоном, градиентами и анимациями
  • Интерактивный курсор - добавлен кастомный курсор для не-мобильных устройств
  • Анимированный фон - добавлены градиентные эффекты, сетка и плавающие частицы, которые реагируют на движение мыши
  • Фоновый текст "Shpalich" - добавлен крупный полупрозрачный текст на фоне для визуального эффекта
  • Новый favicon с иконкой книги - заменен favicon на иконку открытой книги, соответствующую дизайну главной страницы
  • Vercel Web Analytics - добавлена интеграция с Vercel Analytics для отслеживания посещений и просмотров страниц
  • Хлебные крошки (Breadcrumbs) - добавлена навигационная цепочка для удобной ориентации в разделах документации
  • Улучшенная обратная связь - добавлена кнопка "Нашли ошибку?" в форму обратной связи, все сообщения отправляются в Telegram
  • Индексные страницы разделов - созданы индексные страницы для всех разделов (GoDEX, Zebra, Brother, Additional, Other) со списками всех материалов раздела

🐛 Исправлено

  • Черная полоска сверху - убран отступ сверху у main#nd-home-layout, теперь фон начинается с самого верха страницы
  • Header на главной странице - полностью скрыт header на главной странице для чистого дизайна
  • Позиционирование контента - исправлено позиционирование элементов для корректного отображения на всех экранах
  • Темная тема для навигации - исправлена белая навигация на темной теме в мобильной версии
  • Мобильные headers - исправлена цветовая схема для #nd-subnav и #nd-tocnav в обеих темах (темная и светлая)
  • Цветовая схема - все элементы header теперь используют переменные fumadocs (--color-fd-background, --color-fd-foreground, --color-fd-border) вместо жестко заданных цветов для корректной работы с темной и светлой темами
  • Sidebar на мобильных - исправлено отображение боковой панели навигации в темной теме на мобильных устройствах
  • Header элементы - исправлены цвета текста, иконок и кнопок в header для правильного отображения в обеих темах
  • Переключатель темы - восстановлена возможность переключения между темной и светлой темами
  • Анимация фона - улучшены условия отключения анимации (теперь работает на большинстве устройств)

🎨 Улучшено

  • Консистентность цветов - все элементы интерфейса теперь используют единую систему переменных fumadocs для автоматической адаптации к выбранной теме
  • Темная тема - улучшена видимость и контрастность всех элементов в темной теме
  • Мобильная адаптация - полностью оптимизирована верстка главной страницы для мобильных устройств:
    • Адаптивные размеры текста (text-3xl на мобильных → text-8xl на десктопе)
    • Уменьшенные отступы и padding на маленьких экранах
    • Кнопки на полную ширину на мобильных для удобства нажатия
    • Статистика в grid 2x2 на мобильных вместо горизонтального списка
    • Адаптивные размеры карточек, иконок и элементов интерфейса
    • Оптимизированные gap'ы и spacing между элементами
    • Уменьшенный фоновый текст на мобильных устройствах
  • Навигация - убран logo из header, оставлен только текст для более чистого дизайна
  • Обратная связь - улучшена система обратной связи: добавлена категория "Найдена ошибка" с отправкой в Telegram бот для быстрого реагирования на проблемы в документации
  • UX улучшения - добавлены хлебные крошки для лучшей навигации, автоматическая генерация пути из URL с красивым форматированием названий разделов
  • Навигация по разделам - исправлена проблема с 404 при клике на ссылки в хлебных крошках: все разделы теперь имеют индексные страницы с полным списком материалов
  • Иконки разделов - унифицированы иконки разделов принтеров: все разделы (GoDEX, Zebra, Brother, Other) теперь используют иконку Printer для единообразия

2024-10-31

✨ Добавлено

  • Система обратной связи - добавлена функция фидбека на всех страницах документации с возможностью оценки материала (Полезно/Нужно улучшить)
  • Интеграция с Telegram - фидбеки автоматически отправляются в Telegram бот с форматированными сообщениями
  • Поле имени в фидбеке - возможность указать имя при отправке отзыва (опционально)
  • Секция "О документации" на главной странице - добавлен информационный блок с описанием всех разделов документации
  • Кнопки скачивания - добавлены ссылки для скачивания во все разделы (драйверы, утилиты, скрипты)
  • Улучшенная навигация - все карточки на главной странице стали кликабельными с hover-эффектами
  • Видео-плеер - добавлена поддержка встраивания YouTube видео в документацию
  • Zoom изображений - реализован функционал увеличения изображений при клике
  • Стиль TOC "clerk" - добавлен красивый Table of Contents с плавными изогнутыми линиями и анимацией активного индикатора
  • Новая тема vitepress - переключена цветовая тема на vitepress для более современного визуального стиля
  • Open Graph мета-теги - настроено красивое превью ссылок в Telegram, WhatsApp и других мессенджерах с изображением og-image.png
  • Мобильная адаптация - улучшена адаптивность главной страницы для мобильных устройств (размеры текста, кнопок, отступы)
  • Теги для всех страниц - добавлены теги в frontmatter для всех страниц документации (godex-80x60, brother-samoreg, brother-toner, godex-commands, zebra-badges)

🎨 Улучшено

  • UI/UX главной страницы - полностью переработан дизайн с улучшенными переходами и анимациями
  • Стилизация кнопок - обновлен дизайн кнопок скачивания под тему vitepress (компактные, с иконками)
  • Настроен TOC (Table of Contents) с русским интерфейсом
  • Улучшена визуальная навигация по содержимому страниц
  • Обновлена цветовая палитра интерфейса в соответствии с темой vitepress
  • Оптимизировано отображение активных разделов в TOC
  • Структура документации - улучшен информационный блок со списком всех разделов и цветовыми маркерами
  • Hero-секция - добавлены подсказки и обновлены кнопки с актуальными ссылками
  • Мобильная верстка - оптимизированы размеры текста, кнопок и отступов для лучшего отображения на телефонах
  • Отображение тегов - добавлены компоненты TagList на всех страницах для визуального отображения тегов

🔧 Технические улучшения

  • Настроен стиль TOC clerk в конфигурации страниц документации
  • Добавлена поддержка кастомного заголовка TOC
  • Улучшена структура навигации по разделам
  • Компонент Feedback - создан компонент для сбора обратной связи с сохранением в localStorage
  • API endpoint /api/feedback - реализован серверный роут для обработки фидбеков
  • Telegram Bot API интеграция - настроена отправка сообщений через Telegram Bot API с HTML-форматированием
  • Компонент DownloadButton - создан переиспользуемый компонент для кнопок скачивания
  • Компонент YouTubeVideo - добавлен компонент для встраивания видео
  • Интеграция react-medium-image-zoom для функционала zoom изображений
  • Настроены переменные окружения для Telegram бота (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID)
  • Мета-теги Open Graph - добавлены полные Open Graph и Twitter Card мета-теги в layout и на главной странице с поддержкой изображений
  • metadataBase - настроен базовый URL для правильной генерации абсолютных путей к изображениям
  • Система тегов исправлена - нормализация тегов (lowercase, trim) для корректной работы с кириллицей в URL
  • Кодировка URL тегов - исправлена обработка кириллических тегов через encodeURIComponent/decodeURIComponent
  • generateStaticParams - улучшена генерация статических путей для страниц тегов
  • Консистентность тегов - все теги в frontmatter и TagList компонентах теперь синхронизированы

🗑️ Удалено

  • API документация - удален раздел API эндпоинтов из документации и навигации

📝 Обновлено

  • Заменены все ссылки на /docs/getting-started на актуальные (/docs, /docs/godex/godex-80x60)
  • Обновлены карточки в разделе "Дополнительные материалы" на главной странице документации
  • Добавлены кнопки скачивания в разделы:
    • Драйверы Brother, GoDEX, Zebra
    • Утилиты (Port Scanner, Process Explorer, VLADOSIK PRINTERS, 7-Zip, GoLabel, GoUtility)
    • Windows скрипты и reg-файлы
    • Скрипты SPIGF2025 (исправления печати, скрипты даты, IrfanView)

2024-10-30

✨ Добавлено

  • Страница загрузок вынесена на верхний уровень: теперь Центр загрузок доступен по адресу /docs/downloads

🎨 Улучшено

  • Обновлено расположение страницы загрузок для более быстрого доступа, актуализирована навигация, улучшена логика внутренней структуры

2024-10-29

✨ Добавлено

  • Система тегов - теперь можно искать документы по тегам (#godex, #калибровка)
  • Favicon и метатеги - улучшено SEO, добавлена поддержка PWA
  • Мобильная оптимизация - улучшена производительность на мобильных устройствах
  • Страница изменений - добавлена текущая страница для отслеживания обновлений

🎨 Улучшено

  • Анимация фона теперь отключается на слабых устройствах
  • Улучшена адаптивность для мобильных экранов
  • Прозрачный header с эффектом blur

🐛 Исправлено

  • Проблемы с производительностью WebGL анимации
  • Zoom при фокусе на input на iOS
  • 404 ошибки на страницах тегов - исправлена обработка кириллических тегов и нормализация для правильной работы ссылок
  • Переходы по тегам - все теги теперь корректно ведут на страницы с фильтрацией документов
  • Отображение тегов - исправлено сравнение и фильтрация документов по тегам с учетом регистра и пробелов

2024-10-28

✨ Добавлено

  • WebGL анимация фона - красивый градиентный эффект на главной странице
  • Главная страница - EXPOFORUM с современным дизайном
  • Быстрый доступ - карточки с популярными руководствами

🎨 Улучшено

  • Обновлен дизайн навигации
  • Улучшена структура sidebar
  • Добавлены иконки для разделов

2024-10-27

✨ Добавлено

  • Раздел Brother - инструкции для принтеров Brother
  • Раздел Zebra - руководства по настройке Zebra
  • Раздел GoDEX - документация по принтерам GoDEX

📝 Документация

  • Добавлена инструкция по калибровке GoDEX
  • Добавлено руководство по настройке Brother для саморегистрации
  • Добавлены команды для принтеров GoDEX

Обратная связь

Нашли ошибку или хотите предложить улучшение? Свяжитесь с нами!

💡 Совет: Используйте теги для быстрого поиска нужной информации

Был ли полезен этот материал?