Перейти к основному содержимому Главная страница каталога дополнений для NVDA от русскоязычного сообщества NVDA.RU.

Официальный русскоязычный каталог дополнений NVDA

Крупнейший каталог дополнений для программы экранного доступа NVDA, доступный в Интернете

Каталог дополнений от «🇷🇺 Русскоязычного сообщества NVDA.RU.»

18 ноября 2024 года русскоязычному каталогу дополнений NVDA-ADDONS.RU исполнилось два года.

Markdown Forever (Конвертор содержимого Markdown или HTML)

Краткое описание

MarkdownForever - это небольшое дополнение для NVDA, которое легко конвертирует содержимое Markdown или HTML.
Просто напишите или отобразите любой текст в формате Markdown или HTML и нажмите простую комбинацию клавиш для мгновенного преобразования или предварительного просмотра результата в любое время, точно так, как он будет выглядеть на вашей конечной веб-странице, или в исходном коде HTML, готовом для вставки в любую текстовую область, поддерживающую HTML.
MarkdownForever может:
Конвертировать Markdown в HTML
Конвертировать Markdown в исходный код HTML
Конвертировать HTML в Markdown
Конвертировать Markdown в форматированный HTML.

⬇ Перейти к подробной справке 🔝 Назад к оглавлению

Основная информация

Название Версия Совместимость с API NVDA Последняя протестированная версия NVDA Минимальная версия NVDA Дата загрузки в каталог Размер Лицензия
markdownForever 24.01.08-4515690 2024.1 2024.1 2023.1 18-01-2024 15:27:42 456 Кб. GPL v2
🔝 Назад к оглавлению

Информация о локализации на русский язык

🔝 Назад к оглавлению

Скачать

MarkdownForever-V.24.01.08-4515690.nvda-addon

⬇ Перейти к истории версий 🔝 Назад к оглавлению

Разделы

🔝 Назад к оглавлению

Справка

Подробнее

markdownForever

Автор:

Содержание % toc%

Введение

MarkdownForever - это небольшое дополнение NVDA, которое легко конвертирует содержимое Markdown или HTML. Просто напишите или отобразите любой текст в формате Markdown или HTML и нажмите простой ярлык, чтобы мгновенно преобразовать или просмотреть результат в любое время, точно так же, как он будет выглядеть на вашей конечной веб-странице или в исходном коде HTML, готовым для вставки в любой текстовая область, поддерживающая HTML.

MarkdownForever может:

Но что, черт возьми, это за Markdown?

Согласно Википедии,

Markdown - это легкий язык разметки с синтаксисом форматирования простого текста. Его дизайн позволяет конвертировать его во многие форматы вывода, но исходный инструмент с тем же названием поддерживает только HTML. Markdown часто используется для форматирования файлов readme, для написания сообщений на сетевых дискуссионных форумах и для создания форматированного текста с помощью текстового редактора.

Вы можете узнать больше о Markdown, прочитав [полную статью в Википедии.] (Https://en.wikipedia.org/wiki/Markdown)

Таким образом, вместо того, чтобы писать веб-документы с использованием HTML с риском ошибки, вы будете использовать легко запоминающиеся теги, и ваша работа будет выполнена в кратчайшие сроки. С помощью Markdown вы сможете делать примерно то же, что и HTML: заголовки, упорядоченные (нумерованные) или неупорядоченные (объединенные) списки, ссылки и даже таблицы.

Например, если вы хотите создать заголовок первого уровня, вы должны написать один знак решетки (#), за которым следует имя заголовка с пробелом между ними или без них:

# Это пример заголовка первого уровня

который будет выглядеть следующим образом в вашем окончательном HTML-документе:

\! Это пример заголовка первого уровня

Для заголовка второго уровня вы будете использовать два знака решетки, три - для заголовка третьего уровня и т. Д.

Теперь составим неупорядоченный список предметов. Для этого вы можете поставить перед всеми элементами вашего списка звездочку (*). Вот пример:

<цитата>

`` ''

который будет выглядеть как:

  • Апельсин
  • Сахар
  • Молоко

Вы также можете создать ссылку, заключив заголовок ссылки в квадратные скобки ([]), за которым следует URL, заключенный в круглые скобки без пробелов. Например:

[Щелкните здесь, чтобы посетить веб-сайт NVAccess] (https://www.nvaccess.org)

что даст вам:

[Щелкните здесь, чтобы посетить веб-сайт NVAccess] (https://www.nvaccess.org)

Вы даже можете поместить * некоторый текст курсивом *, заключив его в звездочки, или ** написать текст жирным шрифтом **, заключив его в две звездочки ... Возможностей очень много. Просто просмотрите эту [Памятку по Markdown] (https://www.markdownguide.org/cheat-sheet/) для получения дополнительных тегов и деталей.

Преобразование Markdown в HTML

Эта функция позволяет конвертировать любой текст Markdown, отображаемый на экране, в HTML, показывая, как ваш Markdown будет выглядеть в окончательном документе HTML. Это может быть документ, который вы написали в формате Markdown, файл .md, который у вас уже есть на жестком диске, или текст в формате Markdown, найденный на веб-странице. По умолчанию MarkdownForever преобразует весь отображаемый в данный момент текст, но вы также можете выбрать только определенную часть для преобразования.

Вы можете использовать следующие команды:

Обратите внимание, что рекомендуется использовать отображение в браузере, а не виртуальный буфер NVDA. Некоторые теги, в частности теги HTML5, такие как

, не поддерживаются визуализацией виртуального буфера.

Преобразование Markdown в исходный код HTML

Это преобразует текст Markdown в чистый язык HTML. После этого вы сможете скопировать и вставить его в файл HTML, сообщение на форуме или в любую текстовую область в Интернете, где поддерживается код HTML.

Доступны следующие команды:

    • NVDA + ALT + l *: результат отображается в виртуальном буфере NVDA.
    • NVDA + Ctrl + h *: копирование исходного кода HTML в буфер обмена.

Преобразование HTML в Markdown

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

    • NVDA + Alt + k *: отображает результат в виртуальном буфере NVDA.
    • NVDA + Shift + g *: скопировать результат в буфер обмена.

Вы также можете преобразовать веб-страницу HTML в Markdown, просто выбрав ее URL. Однако сначала вы должны убедиться, что механизм преобразования HTML2Text правильно установлен в качестве используемого по умолчанию в [MarkdownForever's settings,] (# markdownforevers-default-settings), расположенном в подменю настроек NVDA.

Преобразование Markdown в форматированный HTML

Эта функция конвертирует ваш контент Markdown в форматированный HTML и копирует его в буфер обмена. Отформатированный HTML-код будет выглядеть как любая веб-страница, отображаемая в вашем браузере, с интерактивными ссылками, заголовками и т. Д. Его можно сгенерировать только из содержимого Markdown. Он не работает с исходным кодом HTML. Чтобы выполнить это действие, нажмите NVDA + Shift + h.

Обратите внимание, что форматированный HTML может быть вставлен в такие приложения, как Microsoft Word, Wordpad, Thunderbird, некоторые поля с расширенным текстом на веб-странице и т. Д. Однако его нельзя вставить в текстовый редактор, такой как Блокнот, Блокнот ++ и т. Д.

Интерактивный режим

Интерактивный режим - это функция, которая представляет все возможности MarkdownForever в удобном диалоговом окне, которое предлагает вам еще больше удобных дополнений. Чтобы открыть интерактивный режим, нажмите NVDA + CTRL + i. Вот описание экрана в порядке табуляции:

  • «Преобразовать в»: это первое поле со списком позволяет вам выбрать направление преобразования: HTML, исходный HTML или Markdown. Для выбора используйте клавиши со стрелками вверх и вниз.
  • «Создать оглавление»: этот флажок позволит вам создавать или не создавать указатель глав вашего окончательного HTML-документа с интерактивными ссылками, ведущими к каждой главе. Статус этой опции также можно установить по умолчанию в [Настройки MarkdownForever.] (# Markdownforevers-default-settings)
  • «Пытаться автоматически нумеровать заголовки»: если этот флажок установлен, Markdown Forever будет пытаться поставить перед заголовками (или главами) номера префиксов в соответствии с уровнем каждого заголовка, например. «1.» для заголовка 1 уровня «1.1.» для заголовка 2 уровня и т. д.
  • «Включить дополнительные теги»: если этот флажок установлен, это дает возможность использовать [специальные теги] (# дополнительных тегов) в вашем содержимом Markdown для автоматической вставки таких вещей, как фактическая дата или время. Статус этой опции также можно установить по умолчанию в [Настройки MarkdownForever.] (# Markdownforevers-default-settings)
  • «Разрешить обратный перевод Extratags»: это укажет, следует ли возвращать [extra-tags] (# extra-tags) к их исходной форме (например,% date%) при преобразовании содержимого HTML, созданного Markdown Forever, обратно в Markdown .
  • «Заголовок»: здесь вы можете ввести заголовок своего HTML-документа, который будет виден в интернет-браузере.
  • «Соответствующий блок метаданных»: это поле только для чтения отображается
  • «Создать соответствующие метаданные из источника HTML»: при преобразовании исходного файла HTML в Markdown он пытается угадать метаданные из исходного кода (заголовок, язык, имя файла и т. Д.) И сгенерировать [блок метаданных] (# optionnal-metadata- блок) для вас. Этот параметр доступен только для преобразования HTML в Markdown.
  • «Показать в виртуальном буфере»: эта кнопка откроет преобразованный контент в виртуальном буфере NVDA.
  • «Показать в браузере»: преобразованный контент будет отображаться в вашем интернет-браузере по умолчанию.
  • «Копировать в буфер обмена»: это поместит преобразованный контент в буфер обмена Windows, готовый к вставке.
  • «Сохранить как»: вам будет предложено сохранить преобразованный документ на жестком диске через стандартное диалоговое окно Windows «Сохранить как». Местоположение сохранения по умолчанию также можно задать в [Настройки MarkdownForever.] (# Markdownforevers-default-settings)

Необязательный блок метаданных

Блок метаданных позволяет вам установить определенные параметры для конкретного документа, независимо от [настроек по умолчанию.] (# Markdownforevers-default-settings). Он должен быть размещен в самом начале документа и должен начинаться с трех дефисов ("- - ") и заканчиваются тремя точками (" ... ") или тремя тире (" --- "). Каждая запись должна быть введена в следующей форме: ключ: «значение» (значение должно быть заключено в кавычки). После блока метаданных должна быть пустая строка.

Список поддерживаемых метаданных

  • Автор (или авторы): чтобы указать имя одного или нескольких авторов для документа (см. пример ниже). Он будет добавлен в заголовок HTML-файла. Этот ключ не чувствителен к регистру.
  • autonumber-headings: чтобы указать, должны ли заголовки нумероваться автоматически. Возможные значения: истина (1) или ложь (0).
  • css (или CSS): чтобы указать один или несколько файлов CSS для представления вашего документа (см. пример ниже). Этот ключ не чувствителен к регистру.
  • дата: чтобы указать дату для вашего документа. Он будет добавлен в заголовок HTML-файла.
  • extratags: чтобы указать, следует ли интерпретировать [extra-tags] (# extra-tags). Возможные значения: истина (1) или ложь (0).
  • extratags-back: чтобы указать, следует ли возвращать [extra-tags] (# extra-tags) к исходной форме (например,% date%) при преобразовании HTML-содержимого, созданного Markdown Forever, обратно в Markdown. Возможные значения: истина (1) или ложь (0).
  • filename: указать имя выходного файла при сохранении.
  • ключевые слова: чтобы указать ключевые слова, относящиеся к теме (ам), охватываемой вашим документом.
  • lang: указать основной язык документа. При необходимости используйте теги span / div с атрибутом lang для обозначения внутренних изменений языка документа.
  • mathjax: чтобы указать, следует ли преобразовывать математические формулы, написанные в [LaTeX] (https://en.wikipedia.org/wiki/LaTeX). Возможные значения: истина (1) или ложь (0). Требуется подключение к Интернету, и вы должны открыть преобразованный результат в своем браузере, чтобы правильно отобразить его, поскольку интерпретированный LaTeX не может быть отображен виртуальным буфером NVDA. [Щелкните здесь, чтобы получить дополнительную информацию о MathJax.] (Http://docs.mathjax.org/en/latest/)
  • путь: чтобы указать каталог, в котором должен быть создан документ. Поддерживаются переменные среды% userprofile%,% appdata% и% tmp%.
  • субтитры: чтобы указать субтитры для вашего HTML-документа. Он будет добавлен в заголовок HTML-файла.
  • title: для обозначения заголовка HTML-документа. В интерактивном режиме поле заголовка будет автоматически заполнено значением этого ключа.
  • toc: чтобы указать, следует ли создавать оглавление. Возможные значения: истина (1) или ложь (0).

Пример использования метаданных

<цитата>

`` ''

title: "простой заголовок" дата: 2019-11-08 subtitle: «это подзаголовок вашего документа» lang: en Автор:

  • Джон Доу

  • Дэвид Мерфи CSS: -% userprofile% / document / main.css -% userprofile% / document / custom.css ключевые слова: NVDA, Markdown, HTML имя файла: тест путь: "% userprofile% / desktop" toc: 0 автономные заголовки: 1 mathjax: 0

Привет мир! Bonjour le monde! ¡Hola mundo! Xin chào thế giới! `` ''

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

Привет, мир! Bonjour tout le monde! ¡Hola mundo! Xin chào thế giới!

Дополнительные теги

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

Поддерживаемые дополнительные теги

В содержимом Markdown Пояснение Результат в браузере
% date% Текущая дата % date%
% time% Текущее время % time%
% now% Текущая дата / время % сейчас%
% day% Текущий день (длинный формат) % день%
% dday% Текущий день (десятичный формат) % dday%
% month% Месяц (длинный формат) % месяц%
% dmonth% Текущий месяц (десятичный формат) % dmonth%
% year% Текущий год (2 цифры) % год%
% Year% Текущий год (4 цифры) % Год%
% toc% Оглавление в позиции курсора (если включено через метаданные или настройки по умолчанию) N / A

Настройки MarkdownForever по умолчанию

Доступ к ним можно получить из меню NVDA -> Настройки MarkdownForever -> Настройки, и они позволят вам настроить и установить по умолчанию различные настройки, связанные с процессом преобразования, уже упомянутым выше:

  • «Создать оглавление»: этот флажок позволит вам создавать или не создавать указатель глав вашего окончательного HTML-документа с интерактивными ссылками, ведущими к каждой главе. Это поведение также можно настроить для каждого документа с помощью ключа "toc" в [необязательном блоке метаданных] (# optional-metadata-block) и разместить в любом месте документа с помощью соответствующего [extra-tag.] (# экстра-теги)
  • «Включить дополнительные теги»: если этот флажок установлен, это дает возможность использовать [специальные теги] (# дополнительных тегов) в вашем содержимом Markdown для автоматической вставки таких вещей, как фактическая дата или время. Это поведение также можно настроить для каждого документа с помощью ключа extratags в [необязательном блоке метаданных.] (# Optional-metadata-block)
  • «Создать соответствующие метаданные из источника HTML»: при преобразовании исходного файла HTML в Markdown он пытается угадать метаданные из исходного кода (заголовок, язык, имя файла и т. Д.) И сгенерировать [блок метаданных] (# optionnal-metadata- блок) для вас.
  • «Действие по умолчанию в интерактивном режиме»: позволяет выбрать действие по умолчанию, которое будет выполняться при нажатии клавиши Enter в [Интерактивный режим:] (# интерактивный режим) Показывать сгенерированный контент в вашем браузере, в виртуальном буфере или поместите это в буфер обмена.
  • «Механизм Markdown»: MarkdownForever позволяет вам выбирать между двумя механизмами преобразования, [HTML2Text] (https://pypi.org/project/html2text/) и [HTML2Markdown.] (Https://pypi.org/project/html2markdown. /) Просто поэкспериментируйте и выберите тот, который вам больше нравится, исходя из ваших потребностей или полученного результата.
  • «Дополнительные возможности Markdown2»: см. Https://github.com/trentm/python-markdown2/wiki/Extras.
  • «Путь»: здесь вы можете установить на жестком диске место сохранения по умолчанию для преобразованных документов. это пригодится, если вы всегда используете одну и ту же папку для хранения всей своей работы.
  • «Управление HTML-шаблонами»: откроется диалоговое окно, позволяющее добавлять, редактировать и удалять HTML-шаблоны. С помощью шаблонов вы сможете настраивать визуальные аспекты ваших сгенерированных HTML-документов с помощью CSS (каскадные таблицы стилей), языка, отвечающего за стили страниц. Это позволит вам изменять цвета, макет или добавлять изображения в свои произведения и создавать шаблон для каждой конкретной потребности. Конечно, есть много руководств по изучению CSS, доступных в Интернете, и [этот] (https://www.htmldog.com/guides/css/beginner/) может стать хорошей отправной точкой.

Сводка команд

    • NVDA + CTRL + i *: интерактивный режим.
    • NVDA + ALT + b *: конвертация Markdown в HTML. Результат отображается в вашем браузере по умолчанию.
    • NVDA + ALT + n *: конвертация Markdown в HTML. Результат отображается в виртуальном буфере NVDA.
    • NVDA + ALT + k *: преобразование HTML в Markdown. Результат отображается в виртуальном буфере NVDA.
    • NVDA + ALT + l *: преобразование исходного кода в HTML. Результат отображается в виртуальном буфере NVDA.
    • NVDA + SHIFT + g *: преобразование HTML в Markdown. Результат копируется в буфер обмена.
    • NVDA + SHIFT + h *: Markdown для преобразования форматированного HTML: результат копируется в буфер обмена.
    • NVDA + CTRL + h *: преобразование исходного кода в HTML. Результат копируется в буфер обмена.

Дополнительная информация

  • Авторы:
  • Андре & lt; dev@andreabc.net & gt ;: создатель и главный сопровождающий надстройки.
  • Sof & lt; hellosof@gmail.com & gt ;: документация на английском и французском языках, различные предложения.
  • Виктор Цай: Китайская локализация.
  • Чагры Доган: турецкая локализация.
  • Реми Руис & lt; remyruiz@gmail.com & gt ;: Испанская локализация.
  • Данг Ман Куонг & lt; dangmanhcuong@gmail.com & gt ;: вьетнамская локализация.
  • Валентин Куприянов: https://nvda.ru/ Русская локализация справки и интерфейса.
  • И многие другие!

Перевод

🔝 Назад к оглавлению

История версий

Список версий
🔝 Назад к оглавлению