HelpDown — конвертер md -> htm -> hlf
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
HelpDown — конвертер md -> htm -> hlf
Проект называется HelpDown и включен в исходники FarNet.
Приложения распространяются как два NuGet пакета:
https://www.nuget.org/packages/MarkdownToHtml
https://www.nuget.org/packages/HtmlToFarHelp
Реализован следующий сценарий. Документация (хелп к плагину) пишется в markdown. Затем markdown конвертируется в HTML с помощью MarkdownToHtml. Полученный файл конвертируется в HLF с помощью HtmlToFarHelp. Промежуточный HTML либо удаляется, либо тоже включается в поставку вместе с HLF для удобного просмотра хелпа в браузере.
Предыстория в теме Встроенная справка в удобном формате
Приложения распространяются как два NuGet пакета:
https://www.nuget.org/packages/MarkdownToHtml
https://www.nuget.org/packages/HtmlToFarHelp
Реализован следующий сценарий. Документация (хелп к плагину) пишется в markdown. Затем markdown конвертируется в HTML с помощью MarkdownToHtml. Полученный файл конвертируется в HLF с помощью HtmlToFarHelp. Промежуточный HTML либо удаляется, либо тоже включается в поставку вместе с HLF для удобного просмотра хелпа в браузере.
Предыстория в теме Встроенная справка в удобном формате
- HaRT
- Moderator
- Posts: 11458
- Joined: Tue 30 Aug, 2005 17:21
- Has thanked: 270 times
- Been thanked: 417 times
Re: FarHelpDown — конвертер md -> htm -> hlf
Latest post of the previous page:
Так может знающие люди помогут, чтобы срослось-таки?NightRoman wrote:схема HTML у меня что-то со скрипом вживляется, криво получается
Фар есть инструмент, а не нянька. © 2009 DrKnS
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
Ну если кто вживит и будет все красиво, то я - за, естественно. Вопрос про то, если нет. (сомневаюсь, что это многим вообще нужно)
- John Doe
- Бюрократ
- Posts: 14582
- Joined: Wed 27 Apr, 2005 20:42
- Location: github.com/FarManagerLegacy
- Has thanked: 92 times
- Been thanked: 514 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
А нужен ли вообще HTML?NightRoman wrote:Или лучше вообще никак, если с HTML не выйдет (если у кого, конечно, есть мнения на этот счет)?
Чего нам не хватает в самом md?
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
Для схемы md -> html -> hlf -- нет.А нужен ли вообще HTML?
* md используется не только для md -> html -> hlf. Схема - она общего назначения. В том числе и сторонние файлы могут быть с чем угодно там, а не самонаписанные.Чего нам не хватает в самом md?
* При ваянии маркдауна легко встать на мину, написав или скопипастив что-то типа <мина>. С подсветкой будет видней, по делу это или нет было вставлено.
Вобщем, подсветка HTML (XML) может быть полезна хотя бы для того, что его случайно не использовать.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.17 - HtmlToFarHelp, markdown.hrc
HtmlToFarHelp
* New option key Margin=1, values Indent* are added.
* Amended indentation of lists item paragraphs.
* Code blocks in list items.
markdown.hrc
* Support inline XML (instead of HTML, at least now).
* Support 2/8 tab/space indented code in list items.
* Support simple e-mail patterns in automatic links.
* Amended fenced code block start/end.
* Used def:Tag for markup characters.
v0.0.17 - HtmlToFarHelp, markdown.hrc
HtmlToFarHelp
* New option key Margin=1, values Indent* are added.
* Amended indentation of lists item paragraphs.
* Code blocks in list items.
markdown.hrc
* Support inline XML (instead of HTML, at least now).
* Support 2/8 tab/space indented code in list items.
* Support simple e-mail patterns in automatic links.
* Amended fenced code block start/end.
* Used def:Tag for markup characters.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.18 - HtmlToFarHelp inline options, markdown.hrc tweaks
HtmlToFarHelp
* Options moved from command line to source as <!--HLF: key=value; ...-->
* New option PlainHeading=false, headings are strong by default.
* New option PlainCode=false, code blocks are strong by default.
* See README and TestFarHelpDown.text for details and examples.
markdown.hrc
* Outlined headings 1 and 2, ignored 3 - 6.
* Fixed fenced code adjacent to paragraphs.
* Fixed false definition list cases.
v0.0.18 - HtmlToFarHelp inline options, markdown.hrc tweaks
HtmlToFarHelp
* Options moved from command line to source as <!--HLF: key=value; ...-->
* New option PlainHeading=false, headings are strong by default.
* New option PlainCode=false, code blocks are strong by default.
* See README and TestFarHelpDown.text for details and examples.
markdown.hrc
* Outlined headings 1 and 2, ignored 3 - 6.
* Fixed fenced code adjacent to paragraphs.
* Fixed false definition list cases.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.19 - Blockquote support.
HtmlToFarHelp
* Blockquote support. They are used for extra indent(s).
* New inline option IndentQuote=4.
markdown.hrc
* Use more different regions for different things.
* Link patterns are adjusted to the converter.
* Amended code block and list ends.
* Amended nested blockquotes.
v0.0.19 - Blockquote support.
HtmlToFarHelp
* Blockquote support. They are used for extra indent(s).
* New inline option IndentQuote=4.
markdown.hrc
* Use more different regions for different things.
* Link patterns are adjusted to the converter.
* Amended code block and list ends.
* Amended nested blockquotes.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.20 - markdown.hrc
* Resolved paragraph spans incorrectly stopped by false list marks.
* Headings 1-3 are outlined, 4-6 are not (~ MarkdownDeep sections).
* Disabled any syntax inside blockquotes, at least for now.
v0.0.20 - markdown.hrc
* Resolved paragraph spans incorrectly stopped by false list marks.
* Headings 1-3 are outlined, 4-6 are not (~ MarkdownDeep sections).
* Disabled any syntax inside blockquotes, at least for now.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.21 - HtmlToFarHelp, markdown.hrc
HtmlToFarHelp
* <br/> (awkward markdown double spaces at line ends) are allowed but ignored.
markdown.hrc
* Simplified code blocks.
* Minor tweaks.
v0.0.21 - HtmlToFarHelp, markdown.hrc
HtmlToFarHelp
* <br/> (awkward markdown double spaces at line ends) are allowed but ignored.
markdown.hrc
* Simplified code blocks.
* Minor tweaks.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22 -markdown.hrc
* Added more custom regions, changed some default regions/colors.
* Used two kinds of parent mark regions: ShownMark and BlindMark.
* Resolved links stopped by false list marks in paragraphs.
* Added paragraph wraps (2+ end spaces ~ <br/>).
v0.0.22 -markdown.hrc
* Added more custom regions, changed some default regions/colors.
* Used two kinds of parent mark regions: ShownMark and BlindMark.
* Resolved links stopped by false list marks in paragraphs.
* Added paragraph wraps (2+ end spaces ~ <br/>).
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22.2 - Complex syntax in lists.
markdown.hrc
* Nested list marks.
* Blockquotes in lists.
* Amended fenced and indented code blocks in lists.
* Resolved wrapped left aligned list paragraph issues.
FarHelpDown
* Simple examples of complex syntax in lists.
v0.0.22.2 - Complex syntax in lists.
markdown.hrc
* Nested list marks.
* Blockquotes in lists.
* Amended fenced and indented code blocks in lists.
* Resolved wrapped left aligned list paragraph issues.
FarHelpDown
* Simple examples of complex syntax in lists.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22.3 - Amended inline HTML(XML)
markdown.hrc
* Inline HTML(XML) recognition is consistent with MarkdownDeep.
* Avoided redundancies in XML processing.
v0.0.22.3 - Amended inline HTML(XML)
markdown.hrc
* Inline HTML(XML) recognition is consistent with MarkdownDeep.
* Avoided redundancies in XML processing.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22.4 - Nested lists.
markdown.hrc
* Fixed some not colored nested list marks.
v0.0.22.4 - Nested lists.
markdown.hrc
* Fixed some not colored nested list marks.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22.5 - Nested lists.
markdown.hrc
* Fixed span stoppers in nested lists.
v0.0.22.5 - Nested lists.
markdown.hrc
* Fixed span stoppers in nested lists.
- NightRoman
- Posts: 6225
- Joined: Fri 18 Aug, 2006 13:52
- Location: Cambridge, UK
- Has thanked: 42 times
- Been thanked: 62 times
- Contact:
Re: FarHelpDown — конвертер md -> htm -> hlf
https://github.com/nightroman/FarHelpDown/downloads
v0.0.22.6 - Lists.
markdown.hrc
* Fixed span stoppers in definition lists.
* Amended ListMark region bounds.
v0.0.22.6 - Lists.
markdown.hrc
* Fixed span stoppers in definition lists.
* Amended ListMark region bounds.