В итоге схема markdown.hrc теперь делает все, что от нее было задумано получить, со следующими оговорками:
* Inline HTML should be valid XML.
* Opened spans are always colored.
* Blockquote contents is not parsed.
* List levels 4: only items are parsed.
* List levels 5+: all is colored as code.
* List levels: 4, 8, 12 spaces or 1, 2, 3 tabs.
Дальше будет в основном оптимизация и вылавливание ошибок, можно начинать жаловаться на них.
Far 3.0.3831 поддерживает горизонтальные разделительные линии в файлах помощи (Mantis#0002619). Поддержка этого добавлена и в HtmlToFarHelp. Удалена лишняя теперь опция CenterRule.
Приложения распространяются не через Google Code downloads, а как два NuGet пакета:
Разделение сделано, так как MarkdownToHtml имеет применение сам по себе, не обязательно в связке с HtmlToFarHelp для генерации файлов помощи.
Re: HelpDown — конвертер md -> htm -> hlf
Posted: Thu 20 Mar, 2014 06:14
by NightRoman
HtmlToFarHelp Release Notes
v1.0.2
Added missing HLF option PluginContents. Without it help files are not shown in the plugin help list ([F1] [ShiftF2]).
Re: HelpDown — конвертер md -> htm -> hlf
Posted: Tue 15 Apr, 2014 05:48
by NightRoman
HtmlToFarHelp v1.0.3, MarkdownToHtml v1.0.2
Исправлены смешанные окончания строк в обоих приложениях. Приложение HtmlToFarHelp на выходе должно давать \r\n, а MarkdownToHtml - \n (потому что внутренний конвертер использует \n, и это не настраивается, кажется).
Но вообще, тестировал давно. И подзабыл детали (но где-то есть) и пандок с тех пор мог поменяться.
Когда-нибудь вернусь к этим вопросам.
HelpDown — конвертер md -> htm -> hlf
Posted: Sat 11 Nov, 2017 21:16
by John Doe
NightRoman wrote: ↑Wed 08 Nov, 2017 13:46Если если проблемы, пишите, будет полезно и знать, и подумать.
Проблемы понятно, а принимаются ли пожелания по HtmlToFarHelp?
Есть не праздный интерес, касающийся перевода Энциклопедии.
HelpDown — конвертер md -> htm -> hlf
Posted: Sun 12 Nov, 2017 08:25
by NightRoman
Я не планировал дальше этот инструмент развивать, в каком-то смысле он закончен и работает хорошо. Если пожелание не требует целой статьи, почему не высказать?
HelpDown — конвертер md -> htm -> hlf
Posted: Sun 12 Nov, 2017 11:07
by John Doe
В консоли (по крайней мере мне) место дорого, поэтому важно разместить информацию компактно.
Для этого сейчас не хватает средств: абзацы всегда предваряются пустой строкой.
Пожелание: добавить опцию конвертации (<!--HLF:), позволяющую не разделять пустой строкой абзацы (или в целом блочные элементы).
Менее существенные пожелания:
Для списков хочется определять вид маркеров (прежде всего интересны два варианта: 1. подсвеченый 2. без маркера)
Ещё хотелось бы опцию, позволяющую не подсвечивать <em> в hlf.
Не хватает возможности вставить ссылку на справку фара (text@:FarTopic@).
В html она могла бы пропускаться.
В схеме colorer заметил небольшой недостаток.
Завершающие пробелы подсвечиваются, но не в blockquote
И сейчас HtmlToFarHelp.exe не вполне поддерживает такие вещи:
Тэг <br/> воспринимается буквально, и дальнейший текст (чаще всего) начинается с нулевой позиции новой строки, что приводит к результату прямо противоположному ожидаемому.
Хочется чтобы после <br/> сохранялся текущий отступ. https://github.com/nightroman/FarNet/issues/44
Если в definition list текст не заключён в <p>, то в hlf он форматируется неверно
Есть ещё ряд конструкций, которые могут встретиться в html, а в hlf не нужны. Здорово было бы их просто пропускать.
Информация для обсуждения.
Для больших проектов может быть неудобно собирать всё в один html файл.
Для Энциклопедии это например неприемлемо.
Надо подумать о какой-то пре/пост-обработке.
HelpDown — конвертер md -> htm -> hlf
Posted: Sun 12 Nov, 2017 14:19
by NightRoman
Принято к сведению. Надо подумать, что стоит или нет. Прямо сейчас не получится, работаю над другими проектами.
В какой схеме колорера недочет? В markdown? Тогда подробнее (я уж забыл немного, что там и как).