Сел писать инструкции для Документооборота, написал одну в HTML-редакторе и совсем устал. Подумал, что с использованием MD это все пойдет гораздо бодрее.
Подсмотрел в двух местах:
Воспользовался библиотекой с гитхаба marked.js
Итоговый файл HTML сохраняется в кодировке UTF-8. Спокойно читается справочником Инструкций в Документообороте или браузером. Не содержит JS-кода библиотеки marked.
На основной форме также присутствуют мини-инструкция - частично переведенная статья.
По умолчанию к итоговому HTML применяется Github Markdown CSS-стиль. Это можно отключить соотв. флагом на форме.
Естественно, вы можете заменить этот стиль (поменяв содержимое макета GithubCSS) или добавить свои стили. Вот здесь их много: https://github.com/ttscoff/MarkedCustomStyles.
Для работы скрипта (без Webkit), который занимается преобразованием в HTML, нужна поддержка браузером метода create. Это достигается использованием в META параметра content="IE=9" и http-equiv="X-UA-Compatible". Просто держу в курсе.
При сохранении, рядом с итоговым файлом .html также пишется файл .txt, в котором сохраняется текст редактора. На тот случай, когда понадобится изменить инструкцию. В самой обработке можно также загружать тексты из файлов в редактор.
До появления Webkit:
Тестировалось на платформе: 1С:Предприятие 8.3 (8.3.13.1513)
Версия Документооборота: Документооборот 8 ПРОФ, редакция 2.1 (2.1.12.2)
Для версии с Webkit (8.3.14.1565 и новее):
Тестировалось на платформе: 1С:Предприятие 8.3 (8.3.14.1630) в чистой конфигурации
Тестировалось на платформе: 1С:Предприятие 8.3 (8.3.18.1208) в чистой конфигурации
Общие ограничения:
Минимальный режим совместимости 8.3.7.
На платформе 8.3.10 и ниже - не работает.
Спасибо пользователю json за информацию о совместимости.
История изменений
1.1.0.1
- Добавлена поддержка Webkit с сохранением обратной совместимости для конфигураций старше 8.3.14.1565. Добавлен индикатор на форму, который показывает, используется Webkit или нет.
- Добавлены быстрые стили в командную панель редактора и горячие клавиши (Ctrl+B, Ctrl+S и т.д.) Информацию о назначенном сочетании можно получить из подсказки к кнопке при наведении на нее.
- Мелкие правки мелких ошибок, которые были выявлены во время тестов.
1.0.0.1
- Добавлен код Сведений о внешней обработке (Для подключения через Дополнительные отчеты и обработки)
- Изменен тип поля текстового редактора. Было поле текстового документа, стало строка в многострочном режиме с расширенным редактированием. Длинные строки не забиваются в одну с горизонтальной прокруткой, а отображаются с переносом строки.
- Кнопка изменения положения области предпросмотра. Два варианта: либо справа от редактора, либо под редактором. По умолчанию - справа.
- Кнопки выделения цветом текста. Выделить можно или изменив цвет текста, или цвет фона текста. Справа от каждой кнопки выделения - кнопка повтора. По ее нажатии к выделению будет применен последний выбранный цвет. Для удобства, цвет фона у кнопки повтора подкрашен в цвет, который будет применен. Форма выбора цвета взята отсюда - Диалог выбора цвета для управляемых форм
1.0.0.0
- Релиз
Вступайте в нашу телеграмм-группу Инфостарт
