Link Library (Библиотека ссылок)

Автор: Ibrahim Hamadeh
Скачать Версия 2.3.2
Совместимость с NVDA: 2021.1 и новее

Это дополнение помогает пользователю организовать свои ссылки или закладки в виде библиотеки.
Из главного диалогового окна библиотек вы можете добавлять, переименовывать или удалять любую существующую библиотеку.
Если у вас уже есть библиотеки, выберите понравившуюся библиотеку или категорию и нажмите на ней Enter.
В открывшемся диалоговом окне будут представлены все ссылки из этой категории в виде списка, а также доступ к исходному URL и информации (about) о каждой ссылке, если она присутствует.
Это дополнение не имеет назначенного по умолчанию жеста или сочетания клавиш.
Вы, как всегда, можете добавить жест или изменить существующий, перейдя в:
Меню NVDA > Параметры > Жесты ввода > Link Library.

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

• После назначения жеста для дополнения, используя этот жест или сочетание клавиш, вы можете открыть главное диалоговое окно дополнения.
• Откроется диалоговое окно со списком всех найденных библиотек или категорий ссылок.
• Изначально библиотеки не найдены, список пуст и готов к созданию нужных вам библиотек.
• Перемещаясь по вкладкам в этом диалоговом окне, вы можете в любое время переименовывать, удалять или добавлять любые библиотеки или категории ссылок.
• Имея несколько библиотек, в списке библиотек установите фокус на нужную и нажмите Enter.
• Откроется диалоговое окно для этой библиотеки, показывающее все содержащиеся в ней ссылки (если они есть) в виде списка (имя или метка ссылок).
• Изначально библиотека пуста и не содержит ссылок.
• Мы нажимаем контекстное меню (Shift + F10), всплывающее меню или клавишу Application, чтобы добавить ссылку, введя URL, метку и, при желании, описание (about) ссылки.
• Установив фокус на любую ссылку в этом списке и нажав на ней Enter, вы откроете её в браузере по умолчанию.
• Перемещаясь по вкладкам в этом диалоговом окне, вы можете получить доступ к описанию ссылки (некоторая информация о ссылке), если оно присутствует, к кнопке для показа исходного URL, а также к другой кнопке, которая даёт возможность открыть ссылку в одном из нескольких браузеров, если они установлены на вашем компьютере.
• Используя элемент управления фильтром, вы можете отфильтровать ссылки в библиотеке, содержащие определённые слова или фразы.
• Установите фокус на нужную ссылку в этом списке и нажмите клавишу контекстного меню.
• Оттуда вы можете добавить, редактировать, переместить ссылку в другую библиотеку, удалить эту ссылку или все ссылки.
• Хотите импортировать библиотеку в формате JSON или экспортировать любую библиотеку как JSON или HTML файл? Да, вы можете. Более того, если вы хотите импортировать все закладки Firefox в формате JSON, вы также можете это сделать.
• Например, чтобы экспортировать библиотеку, установите фокус на библиотеку, которую хотите экспортировать, и нажмите клавишу контекстного меню, стрелку вниз один раз до пункта «Export library as» (Экспортировать библиотеку как), выберите тип файла для экспорта (JSON или HTML) и нажмите Enter.
• Откроется диалоговое окно для выбора папки, в которую вы хотите экспортировать. Выберите папку и нажмите Enter или перейдите к кнопке «Select folder» (Выбрать папку) и нажмите на неё.
• Всё готово. Появится информационное сообщение, уведомляющее о том, что библиотека была экспортирована. Поздравляем!
• Ещё одна замечательная возможность: если вы экспортируете библиотеку как HTML, вы можете, при желании, включить ссылки из этого файла в закладки Firefox.
• Просто откройте Firefox, в меню «Закладки» выберите «Показать все закладки» (Ctrl+Shift+B).
• В меню открывшегося нового окна перейдите в подменю «Импорт и резервное копирование», затем выберите «Импорт закладок из HTML…» и нажмите Enter.
• В открывшемся диалоговом окне перейдите к HTML-файлу и выберите его. После этого в меню закладок Firefox появится запись или папка с тем же именем, что и у импортированной библиотеки, содержащая все ссылки из импортированной библиотеки.
• Последнее по счёту, но, возможно, самое важное: у вас есть возможность выбрать расположение файлов данных вашего дополнения.
• Во-первых, при установке дополнения появится окно сообщения с вопросом, согласны ли вы создать папку для хранения файлов данных дополнения в вашем домашнем каталоге пользователя.
• При желании вы можете нажать «Отмена» и выбрать нужный каталог для хранения файлов данных позже в диалоговом окне настроек дополнения в меню параметров.
• Перейдите в Меню NVDA > Параметры > Link Library > Link Library Setting... (Настройки Link Library) и откройте диалоговое окно настроек.
• С помощью кнопки «Add new path» (Добавить новый путь) вы можете добавить один или несколько путей, или удалить любой из добавленных путей с помощью кнопки «Remove» (Удалить).
• После выбора нового пути по умолчанию для файлов данных или библиотек дополнения в этом диалоговом окне,
• Если вы хотите сделать это изменение постоянным, вы должны сохранить настройки, нажав Control+NVDA+C, особенно если в общих настройках NVDA у вас не установлено сохранение настроек при выходе.
• Стоит отметить, что создание папки для хранения файлов данных в домашнем каталоге пользователя позволяет всем экземплярам дополнения на компьютере использовать одни и те же файлы или базу данных.
• А выбор другого пути, например Dropbox, даст пользователю возможность использовать одну и ту же папку или базу данных с экземплярами дополнения на другом компьютере, использующем тот же аккаунт Dropbox.

Функция вложенной библиотеки (Sub library)

Вы можете при желании добавить вложенные библиотеки в любую библиотеку.

• Откройте нужную библиотеку.
• Нажмите клавишу контекстного меню, всплывающего меню или клавишу Application.
• Отлично! Теперь у вас есть опция для добавления, а также переименования или удаления любых вложенных библиотек, если они присутствуют. Легко, не правда ли? Наслаждайтесь!

Добавление ссылки «на лету» (Add a link on the fly)

Замечательная функция: Добавление ссылки на веб-страницу «на лету».

Чтобы использовать эту функцию, сначала необходимо назначить для неё жест или сочетание клавиш, перейдя в: Меню NVDA (NVDA+N) > Параметры > Жесты ввода > Link Library > Add the link and title of web page on the fly to library you choose (Добавить ссылку и заголовок веб-страницы «на лету» в выбранную библиотеку).

Теперь, просматривая веб-страницы, если вы хотите добавить страницу в любую библиотеку дополнения Link Library, вы можете это сделать. Находясь в любом месте понравившейся страницы, нажмите жест или сочетание клавиш для этой функции. Откроется окно с надписью «Add link and title of web page to library» (Добавить ссылку и заголовок веб-страницы в библиотеку). В нём будет кнопка «Choose library:» (Выбрать библиотеку:). Нажмите эту кнопку и во всплывающем меню выберите нужную библиотеку, затем нажмите Enter.

Всё готово! Ссылка (URL) веб-страницы добавлена в библиотеку вместе с её заголовком в качестве метки, и вы услышите подтверждающее сообщение об этом. Действительно замечательная функция.

Изменения для версии 2.3.2

• Теперь в любом списке, если вы находитесь на ссылке, библиотеке или вложенной библиотеке, вы можете удалить элемент с помощью клавиши delete или цифровой клавиатуры delete.

Изменения для версии 2.3.1

• Обновлена украинская локализация, автор George-br.

Изменения для версии 2.3

• Добавлена функция навигации по двум буквам в списках, так что теперь пользователь может перемещаться по двум последовательным буквам в диалоговых окнах библиотеки и ссылок и переключаться между элементами, как в проводнике файлов.

Изменения для версии 2.2.9

• Исправлена ошибка в кнопке "Показать исходный URL" в диалоговом окне "Ссылка", которая появлялась на языках, отличных от английского.
• Добавлена документация на испанском языке, предоставленная Анной Жизель.

Изменения для 2.2.7

• Добавлен перевод на испанский язык, предоставленный [Аной Жизель] (https://github.com/ana-giselle-ar86).

Изменения для версии 2.2.6

• Обновите последнюю протестированную версию, чтобы она соответствовала последнему выпуску NVDA 2026.1.
• В диалоговом окне настроек дополнения, в поле со списком, содержащем несколько путей для хранения данных дополнения, теперь отображается полный путь к каталогу, а не только метка пути.

Изменения для версии 2.2.5

• Обновлен перевод на украинский язык, предоставленный @George-br.

Изменения для версии 2.2.4

• Исправлена ошибка в функции "Добавлять ссылку на лету", теперь вы можете добавлять ссылку на открытую библиотеку или суббиблиотеку, что раньше было невозможно.

Изменения в версии 2.2.3

• Добавлена новая функция импорта всех закладок Firefox (в виде JSON файла) для включения в дополнение. Вы можете получить к ней доступ через опцию в контекстном меню, когда фокус находится на списке библиотек.

Перевод

• Валентин Куприянов: Русский язык
• Перевод начал с версии 1.3.

Изменения в версии 2.2.2

• Теперь можно экспортировать библиотеку вместе с её вложенными библиотеками как HTML файл, а затем, при желании, интегрировать её в закладки Firefox.

Изменения в версии 2.2.1

• Обновлены файлы шаблона дополнения, а для сборки дополнения теперь используются GitHub Actions вместо AppVeyor.

Изменения в версии 2.2

• Исправлена небольшая ошибка при извлечении заголовка веб-страницы в функции «Добавление ссылки на лету».

Изменения в версии 2.1.9

• Реализована возможность добавления ссылки на веб-страницу «на лету». Назначьте жест для этой функции и на любой странице нажмите его, затем во всплывающем меню выберите библиотеку, и ссылка будет добавлена с заголовком страницы в качестве метки.

Изменения в версии 2.1.8

• Добавлена возможность открывать ссылку в режиме инкогнито/приватном режиме для Firefox, Chrome и Edge. Доступ к этой опции можно получить после нажатия кнопки «Open link with» (Открыть ссылку с помощью) в диалоговом окне ссылки.

Изменения в версии 2.1.6

• Обновлён турецкий перевод от Umut KORKMAZ.

Изменения в версии 2.1.5

• Строки «Has sub library» (Имеет вложенную библиотеку) и «Sub library» (Вложенная библиотека) теперь доступны для перевода.
• Теперь можно удалить библиотеку, содержащую вложенные библиотеки. Это была исправленная ошибка, о которой сообщил Umut KORKMAZ.
• При попытке удалить библиотеку, содержащую вложенные библиотеки, сообщение теперь предупредит вас о том, что вы собираетесь удалить библиотеку вместе с её вложенными библиотеками, чтобы это было понятно.

Изменения в версии 2.1.4

• Добавлена функция вложенной библиотеки. Теперь пользователь может добавлять в библиотеку вложенную библиотеку, переименовывать или удалять её.

Изменения в версии 2.1.3

• Браузер Yandex добавлен в список браузеров, с помощью которых можно открыть ссылку. Спасибо пользователю, который это предложил.

Изменения в версии 2.1.2

• Добавлена русская локализация от Kostenkov-2021.
• Обновлён украинский перевод от VovaMobile.

Изменения в версии 2.1.1

• Обновлена последняя протестированная версия, теперь дополнение совместимо с NVDA 2024.1.

Изменения в версии 2.1

• В диалоговом окне настроек дополнения флажок заменён на раскрывающийся список (combo box) для выбора действия после активации ссылки. Теперь можно выбрать: «Ничего не делать», «Закрыть только окно библиотеки» или «Закрыть главное окно дополнения после активации ссылки».
• Теперь заголовок главного окна дополнения не содержит полный путь к файлам данных, а только родительский каталог. Например, если ваша папка с данными находится в каталоге «Документы», заголовок больше не будет: «Link Library - C:\users...\Documents». Вместо этого он будет: «Link Library - Documents».

Изменения в версии 2.0

• Добавлена упрощённая китайская локализация.

Изменения в версии 1.9

• Обновлена последняя протестированная версия, что делает дополнение совместимым с NVDA 2023.1.

Изменения в версии 1.8

• Добавлен элемент управления фильтром в диалоговом окне каждой библиотеки. С его помощью пользователь теперь может фильтровать ссылки в библиотеке, содержащие определённые слова или фразы, будь то в URL или метке ссылки.
• В главном диалоговом окне библиотек после добавления или переименования библиотеки список библиотек теперь упорядочивается по алфавиту, чего не хватало ранее.

Изменения в версии 1.7

• Добавлен португальский перевод для дополнения.

Изменения в версии 1.6

• Добавлен украинский перевод.

Изменения в версии 1.5

• Теперь вы можете переместить ссылку из одной библиотеки в другую. Это можно сделать через всплывающее меню, затем пункт меню «Move link to» (Переместить ссылку в), а затем в подменю выбрать библиотеку и нажать на ней Enter.

Изменения в версии 1.4

• Теперь при закрытии открытой библиотеки с помощью клавиши Escape или кнопки «Cancel» (Отмена) фокус будет возвращаться обратно в главное окно библиотек.

Изменения в версии 1.3

• Замена кнопки закрытия на OK и Cancel в диалоговом окне ссылки и возможность удаления общей библиотеки в диалоговом окне библиотек.
• Изменена минимальная тестированная версия дополнения на 2019.3.
• Добавлен турецкий перевод для дополнения.

Изменения в версии 1.2

• Исправлена ошибка с активацией контекстного меню в API NVDA 2021.1.
• Удалён «edge legacy» (старая версия Edge) из списка «open link with» (открыть ссылку с помощью) в диалоговом окне ссылки.

Изменения в версии 1.1

• Теперь ссылки в библиотеках (а именно их метки) сортируются без учёта регистра.
• При импорте библиотеки JSON, если существует библиотека с таким же именем, пользователю будет предложено объединить две библиотеки или нет. Если он ответит «Нет», библиотека будет импортирована с номером в скобках в качестве суффикса, обозначающего количество похожих библиотек. Если он захочет объединить библиотеки, импортированный или существующий файл будет содержать объединённые словари внутри.

Изменения в версии 1.0

• Изменён формат файлов данных/библиотек с .pickle на .json.
• В заголовок диалогового окна Link Library теперь добавляется метка пути, выбранного пользователем для хранения файлов данных.

Изменения в версии 0.5

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

Изменения в версии 0.4

• Дополнение стало совместимым с Python3.

Изменения в версии 0.2

• Единственным местом для сохранения и извлечения данных стала папка с именем «linkLibrary-addonFiles» в домашнем каталоге пользователя. Таким образом, она будет использоваться всеми экземплярами дополнения в установленных или портативных версиях NVDA.

Изменения в версии 0.1

• Первоначальная версия.

Вклад участников

Огромная благодарность:

• Umut KORKMAZ за поддержку турецкого перевода дополнения.
• VovaMobile за поддержку украинского перевода дополнения.

Свяжитесь со мной

В случае обнаружения ошибок или для предложений вы можете написать мне на email.