HelpDown — конвертер md -> htm -> hlf

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
NightRoman
Posts: 6219
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 41 times
Been thanked: 62 times
Contact:

HelpDown — конвертер md -> htm -> hlf

Post by NightRoman »

Проект называется HelpDown и включен в исходники FarNet.
Приложения распространяются как два NuGet пакета:

https://www.nuget.org/packages/MarkdownToHtml
https://www.nuget.org/packages/HtmlToFarHelp

Реализован следующий сценарий. Документация (хелп к плагину) пишется в markdown. Затем markdown конвертируется в HTML с помощью MarkdownToHtml. Полученный файл конвертируется в HLF с помощью HtmlToFarHelp. Промежуточный HTML либо удаляется, либо тоже включается в поставку вместе с HLF для удобного просмотра хелпа в браузере.

Предыстория в теме Встроенная справка в удобном формате
User avatar
John Doe
Бюрократ
Posts: 14415
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 83 times
Been thanked: 484 times
Contact:

HelpDown — конвертер md -> htm -> hlf

Post by John Doe »

Latest post of the previous page:

John Doe wrote: Sat 11 May, 2024 18:52 Предлагается система сборки документации
в различных форматах (.hlf, .html, и .md для форума)
из единого источника на базе Markdown.
Логичным дополнением тут будет и автоматическая актуализация соответствующего поста на форуме.
Вот дошли руки разобраться как это можно сделать: https://github.com/FarManagerLegacy/Hel ... te_post.sh
https://t.me/FarManager — Telegram чат
User avatar
John Doe
Бюрократ
Posts: 14415
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 83 times
Been thanked: 484 times
Contact:

HelpDown — конвертер md -> htm -> hlf

Post by John Doe »

В качестве альтернативы Pandoc собрал трансляторы из CommonMark и GitHub Flavored Markdown.

Attachments
cmark-v0.31.1.7z
(93.79 KiB) Downloaded 16 times
cmark-gfm-v0.29.0.gfm.13.7z
(107.61 KiB) Downloaded 24 times
https://t.me/FarManager — Telegram чат
User avatar
John Doe
Бюрократ
Posts: 14415
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 83 times
Been thanked: 484 times
Contact:

HelpDown — конвертер md -> htm -> hlf

Post by John Doe »

Attachments
gomarkdown.7z
(1 MiB) Downloaded 15 times
md4c-v0.5.2.7z
(139.73 KiB) Downloaded 14 times
pulldown-cmark-v0.13.0-36-gf4a326d.7z
(208.78 KiB) Downloaded 12 times
https://t.me/FarManager — Telegram чат
User avatar
John Doe
Бюрократ
Posts: 14415
Joined: Wed 27 Apr, 2005 20:42
Location: github.com/FarManagerLegacy
Has thanked: 83 times
Been thanked: 484 times
Contact:

HelpDown — конвертер md -> htm -> hlf

Post by John Doe »

Ещё альтернативы (см. Releases): Python: ...
https://t.me/FarManager — Telegram чат
Post Reply

Return to “Обсуждение Far Manager”