FavoriteLinks (Избранные ссылки)

• Автор: Edilberto Fonseca (edilberto.fonseca@outlook.com)
• Дата создания: 04/11/2024
• Лицензия: GPL 2.0

Введение

Дополнение FavoriteLinks — это инструмент для управления избранными ссылками организованно и эффективно. Оно позволяет сохранять, редактировать и удалять ссылки в категоризированном списке, предлагая интуитивно понятный интерфейс с такими функциями, как добавление новых ссылок, переименование заголовков, удаление ненужных записей и управление категориями. Кроме того, дополнение позволяет импортировать закладки непосредственно из HTML-файлов, экспортированных браузерами.

Когда вы открываете дополнение, вы получаете быстрый доступ к вашим ссылкам и можете открывать их прямо в браузере по умолчанию. Теперь также есть поддержка открытия ссылок в дополнительном браузере, если вам нужна большая гибкость.

Установка

Выполните следующие шаги для установки дополнения FavoriteLinks в NVDA:

1. В NVDA откройте меню Сервис и выберите Магазин дополнений.
2. На вкладке Доступные дополнения перейдите к полю Поиск.
3. Найдите «favoriteLinks». В результатах нажмите Enter или Применить, а затем выберите Установить.
4. Перезапустите NVDA для применения изменений.

Настройка

У вас есть полный контроль над тем, где сохраняются ваши ссылки и какой браузер их открывает.

1. Получите доступ к меню NVDA: NVDA+N > Параметры > Настройки.
2. В списке категорий выберите Избранные ссылки.

Вы можете выбрать пользовательское местоположение для сохранения файла ссылок с помощью кнопки «Выбрать или добавить папку» (Alt+S).

Чтобы определить дополнительный браузер, который может быть как установленным, так и портативным:

1. Перейдите с помощью клавиши Tab к полю Путь к браузеру.
2. Используйте кнопку «Выбрать путь к браузеру» (Alt+N), чтобы добавить исполняемый файл желаемого браузера.

Использование

Доступ к дополнению

• Нажмите Alt+Windows+K.
• Или получите доступ через NVDA+N > Сервис > Избранные ссылки.

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

Основной интерфейс состоит из двух основных полей, между которыми можно перемещаться с помощью клавиши Tab:

1. Категория: Поле выбора с существующими категориями.
2. Список ссылок: Список, который показывает ссылки, связанные с выбранной категорией.

Используйте контекстное меню (клавиша Applications) в любом из этих полей для доступа к дополнительным опциям.

Доступные действия

В поле выбора категории

• Добавить категорию: Создаёт новую категорию.
• Редактировать категорию: Переименовывает выбранную категорию.
• Удалить категорию: Удаляет категорию и все её ссылки.
• Экспорт ссылок: Сохраняет все ссылки и категории в файл .json.
• Импорт ссылок: Загружает ссылки и категории из файла .json.

В списке ссылок

• Открыть ссылку: Открывает ссылку в настроенном вами браузере.

  Примечание: Необходимо предварительно настроить дополнительный браузер в параметрах.

• Добавить ссылку: Позволяет вставить новый URL. Заголовок будет получен автоматически, но вы можете ввести его вручную, если поиск не удастся.
• Редактировать ссылку: Изменяет заголовок и URL существующей ссылки.
• Удалить ссылку: Удаляет выбранную ссылку.
• Экспорт ссылок / Импорт ссылок: То же, что и опции категории.
• Импорт HTML-закладок: Импортирует ссылки из HTML-файла, экспортированного браузерами.
• Сортировать ссылки: Организует ссылки в текущей категории по алфавиту.

Импорт HTML-закладок

FavoriteLinks также позволяет импортировать закладки непосредственно из HTML-файлов, например, экспортированных браузерами (Chrome, Firefox, Edge и другими).

Эта функция полезна для быстрого и организованного переноса существующих закладок в дополнение.

Как импортировать закладки из HTML-файла

1. Откройте дополнение Избранные ссылки.
2. Получите доступ к контекстному меню в поле выбора категории или используйте опцию, доступную в главном меню.
3. Выберите Импорт HTML-закладок.
4. Выберите HTML-файл, экспортированный из вашего браузера.
5. Дождитесь обработки ссылок.

Во время импорта:

• Ход выполнения отображается в индикаторе прогресса.
• Вы можете отменить операцию в любое время.
• NVDA остаётся отзывчивой на протяжении всего процесса.

Организация импортированных ссылок

• Импортированные ссылки автоматически добавляются в JSON-файл, настроенный в параметрах дополнения.
• По умолчанию закладки вставляются в категорию «Импортированные закладки».
• Дублирующиеся ссылки (с одинаковым URL) не добавляются повторно.

По окончании импорта отображается сообщение с подтверждением, и интерфейс дополнения обновляется автоматически.

Сочетания клавиш

Диалог «Добавить новую ссылку»

1. Категория: Выберите желаемую категорию.
2. URL: Вставьте или введите адрес ссылки.

   Если вы уже скопировали URL, он будет вставлен автоматически.

3. OK (Alt+O): Добавляет ссылку.

   Заголовок будет получен автоматически. Если поиск не удастся, вы сможете ввести его вручную.

4. Отмена (Alt+C): Закрывает диалог. Esc или Alt+F4 также работают.

Диалог «Редактировать ссылку»

1. Категория: Изменяя категорию здесь, вы перемещаете ссылку в новую категорию.
2. Заголовок: Отредактируйте заголовок ссылки.
3. URL: Измените адрес ссылки.
4. OK (Alt+O): Сохраняет изменения.
5. Отмена (Alt+C): Закрывает без сохранения. Esc или Alt+F4 также работают.

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

Особая благодарность Rue Fontes и Ângelo Abrantes за проведённые тесты и ценные предложения, которые значительно способствовали улучшению этого проекта.

Я также благодарю Abel Passos за вклад в функциональность импорта закладок из HTML-файлов.

Дополнение FavoriteLinks было разработано с помощью ChatGPT и Google Gemini, которые использовались для создания функций, оптимизации и рефакторинга кода, а также улучшения документации.

🌍 Переводчики

• 🇸🇦 Арабский — Ahmed Bakr
• 🇧🇷 Португальский (Бразилия) — Edilberto Fonseca
• 🇵🇹 Португальский (Португалия) — Edilberto Fonseca
• 🇷🇺 Русский (Россия) — Valentin Kupriyanov
• 🇹🇷 Турецкий (Турция) — Umut KORKMAZ
• 🇺🇦 Украинский (Украина) — Heorhii Halas