Первоначальный выпуск.

WCAGReporter (Анализ доступности WCAG)

WCAG Reporter — это расширенное дополнение для NVDA, которое анализирует элементы веб-страниц и HTML-содержимое на соответствие стандартам доступности WCAG с использованием AI-моделей Ollama. Оно предоставляет подробные отчёты с предложениями по улучшению на английском и турецком языках.

Содержание

• 1. Требования
• 2. Установка
• 3. Возможности
• 4. Быстрый старт
• 5. Пункты меню
• 6. Интерфейс HTML Analyst
• 7. Настройка
• 8. Горячие клавиши
• 9. Окно результатов
• 10. Устранение неполадок
• 11. Информация о разработчике
• 12. Лицензия

1. Требования

• NVDA 2023.1 или новее
• Ollama установлена и запущена на вашем компьютере
• Загружена как минимум одна модель Ollama (например, llama3.2, mistral)

Примечание: Чтобы загрузить модель Ollama, откройте командную строку и выполните:
ollama pull llama3.2

2. Установка

1. Скачайте файл дополнения WCAG Analyst (.nvda-addon)
2. Дважды щёлкните по файлу, чтобы установить его в NVDA
3. Перезапустите NVDA
4. Убедитесь, что Ollama запущена на вашем компьютере

3. Возможности

• Интерфейс HTML Analyst: Двухпанельный интерфейс для ввода HTML и просмотра результатов анализа
• Анализ элемента: Анализ текущего элемента в фокусе по одной горячей клавише
• Задать вопрос: Возможность задавать уточняющие вопросы по результатам анализа
• Поддержка WCAG 2.0/2.1/2.2: Анализ с учётом разных версий стандарта WCAG
• Уровни A/AA/AAA: Выбор уровня соответствия
• Многоязычность: Поддержка турецкого и английского языков

4. Быстрый старт

1. Установите дополнение WCAG Analyst в NVDA
2. Убедитесь, что Ollama запущена на вашем компьютере
3. Перейдите к любому элементу на веб-странице
4. Нажмите горячую клавишу для анализа:

NVDA + Shift + W

Или используйте пункт «WCAG HTML Analyst» в меню «Сервис» NVDA.

5. Пункты меню

В меню «Сервис» NVDA доступны следующие пункты:

6. Интерфейс HTML Analyst

HTML Analyst предоставляет современный двухпанельный интерфейс:

Левая панель — HTML-содержимое

• Вставьте HTML-код для анализа в эту область
• Нажмите кнопку «Analyze», чтобы начать анализ

Правая панель — Улучшения и предложения

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

Задать вопрос

• Задайте уточняющие вопросы по результатам анализа
• При вводе вопроса ответ заменяет предыдущее содержимое
• История диалога сохраняется, что позволяет задавать контекстные вопросы

7. Настройка

Доступ к настройкам: Меню NVDA → Настройки → Параметры → WCAG Reporter или пункт «WCAG Analyst Settings» в меню «Сервис».

Настройки сервера Ollama

Настройки анализа WCAG

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

9. Окно результатов

Окно результатов анализа полностью доступно для скринридеров:

• Tab — переход между разделами и кнопками
• Copy — копирование результата анализа в буфер обмена
• Ask — задать уточняющий вопрос
• Escape или Close — закрыть окно

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

Ошибка подключения

Если отображается «Connection failed»:

1. Убедитесь, что Ollama запущена: откройте командную строку и введите ollama serve
2. Проверьте URL сервера в настройках (по умолчанию: http://localhost:11434)
3. Используйте кнопку Refresh Models, чтобы обновить список моделей

Нет моделей

Если список моделей пуст:

1. Откройте командную строку
2. Выполните: ollama pull llama3.2
3. Нажмите кнопку «Refresh Models» в настройках

Анализ выполняется слишком долго

Большие или сложные элементы могут анализироваться дольше. Попробуйте следующее:

• Используйте более быструю модель (например, llama3.2:1b)
• Увеличьте время ожидания в настройках
• Сначала проанализируйте более простые элементы

11. Информация о разработчике

Разработчик: Sarper Arıkan
Веб-сайт: https://sarperarikan.net
Email: sarperarikan@gmail.com
Версия: 1.0.0

12. Лицензия

Это дополнение является свободным программным обеспечением с открытым исходным кодом. Вы можете распространять и/или изменять его в соответствии с условиями Стандартной общественной лицензии GNU, опубликованной Фондом свободного программного обеспечения.