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

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

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

Post by NightRoman » Thu 20 Mar, 2014 06:14

Latest post of the previous page:

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]).

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Tue 15 Apr, 2014 05:48

HtmlToFarHelp v1.0.3, MarkdownToHtml v1.0.2

Исправлены смешанные окончания строк в обоих приложениях. Приложение HtmlToFarHelp на выходе должно давать \r\n, а MarkdownToHtml - \n (потому что внутренний конвертер использует \n, и это не настраивается, кажется).

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Wed 08 Nov, 2017 12:30

Правильно ли я понимаю, что сейчас вместо MarkdownToHtml рекомендуется pandoc?

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Wed 08 Nov, 2017 13:46

John Doe wrote:
Wed 08 Nov, 2017 12:30
Правильно ли я понимаю, что сейчас вместо MarkdownToHtml рекомендуется pandoc?
Да. MarkdownToHtml основан на MarkdownDeep, который вроде перестал использоваться.

Я проводил сравнительные тесты, pandoc показал себя ничуть не хуже (а, в сущности, гораздо лучше).
Только одно НО - https://github.com/jgm/pandoc/issues/2617

Используйте pandoc. Если если проблемы, пишите, будет полезно и знать, и подумать.
Но MarkdownToHtml тоже еще поживет, прямо сейчас не выкидываю.

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Wed 08 Nov, 2017 14:15

NightRoman wrote:
Wed 08 Nov, 2017 13:46
Да. MarkdownToHtml основан на MarkdownDeep, который вроде перестал использоваться.
Что это значит?

pandoc интересен тем, что поддерживает разные типы mardown, плюс ещё кучу всего.
(Интересно, сойдёт ли Word docx как исходник hlf.)
Last edited by John Doe on Wed 08 Nov, 2017 15:07, edited 1 time in total.

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Wed 08 Nov, 2017 15:26

Я имел в виду MarkdownDeep перестал развиваться.

А pandoc - классная вещь в любом случае, да.

> Интересно, сойдёт ли Word docx как исходник hlf.
Сомневаюсь...

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Wed 08 Nov, 2017 16:00

NightRoman wrote:
Wed 08 Nov, 2017 15:26
А pandoc - классная вещь в любом случае, да.
Жаль нет конвертера в bbcode.
NightRoman wrote:
Wed 08 Nov, 2017 13:46
Я проводил сравнительные тесты, pandoc показал себя ничуть не хуже (а, в сущности, гораздо лучше).
А что именно лучше?
Demo.text использует все его возможности, или что-то можно удобнее сделать?

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Wed 08 Nov, 2017 17:08

> А что именно лучше?

Не падает на некоторых конструкциях :) https://github.com/toptensoftware/markd ... /issues/12
Вроде пофиксили, но пакет так и не обновили.

Но вообще, тестировал давно. И подзабыл детали (но где-то есть) и пандок с тех пор мог поменяться.
Когда-нибудь вернусь к этим вопросам.

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Sat 11 Nov, 2017 21:16

NightRoman wrote:
Wed 08 Nov, 2017 13:46
Если если проблемы, пишите, будет полезно и знать, и подумать.
Проблемы понятно, а принимаются ли пожелания по HtmlToFarHelp?

Есть не праздный интерес, касающийся перевода Энциклопедии.

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Sun 12 Nov, 2017 08:25

Я не планировал дальше этот инструмент развивать, в каком-то смысле он закончен и работает хорошо. Если пожелание не требует целой статьи, почему не высказать?

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Sun 12 Nov, 2017 11:07

В консоли (по крайней мере мне) место дорого, поэтому важно разместить информацию компактно.
Для этого сейчас не хватает средств: абзацы всегда предваряются пустой строкой.
Пожелание: добавить опцию конвертации (<!--HLF:), позволяющую не разделять пустой строкой абзацы (или в целом блочные элементы).

Менее существенные пожелания:

И сейчас HtmlToFarHelp.exe не вполне поддерживает такие вещи:
  1. Тэг <br/> воспринимается буквально, и дальнейший текст (чаще всего) начинается с нулевой позиции новой строки, что приводит к результату прямо противоположному ожидаемому.
    Хочется чтобы после <br/> сохранялся текущий отступ.
    (Примеры предоставлю)
  2. Если в definition list текст не заключён в <p>, то в hlf он форматируется неверно
  3. Не поддерживаются такие линки:
  4. Есть ещё ряд конструкций, которые могут встретиться в html, а в hlf не нужны. Здорово было бы их просто пропускать.
Информация для обсуждения.
Для больших проектов может быть неудобно собирать всё в один html файл.
Для Энциклопедии это например неприемлемо.
Надо подумать о какой-то пре/пост-обработке.

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Sun 12 Nov, 2017 14:19

Принято к сведению. Надо подумать, что стоит или нет. Прямо сейчас не получится, работаю над другими проектами.

В какой схеме колорера недочет? В markdown? Тогда подробнее (я уж забыл немного, что там и как).

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Sun 12 Nov, 2017 14:43

Markdown

Если в конце строки добавить два пробела, то последний подсветится (в обычном тексте, в списках).
В blockquote не подсветится.

А смысл двух пробелов это принудительный перенос строки (в html будет <br/>)

Edit:
Ещё в схеме не предусмотрена возможность атрибутов в fenced code block:
Last edited by John Doe on Sun 12 Nov, 2017 21:45, edited 1 time in total.

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Sun 12 Nov, 2017 15:13

А пока оставлю последующим поколениям инструкцию с чего начать при использовании pandoc.

pandoc поддерживает ряд расширений стандарта markdown, детально описано тут: https://pandoc.org/MANUAL.html#pandocs-markdown.
Расширения можно произвольно (де)активировать, например auto_identifiers будет мешать (в HtmlToFarHelp используется конвенция: каждый заголовок с id это новая статья hlf).

Ещё при использовании с HtmlToFarHelp имеет значение ключ командной строки --wrap=preserve (на отображении не сказывается, но всё же удобнее когда абзацы в исходнике hlf свёрнуты).

Чтобы установить заголовок для html можно воспользоваться такой конструкцией в начале файла

Вот мои ассоциации:

md->html | *.md;*.text

Code: Select all

pandoc --wrap=preserve -s -f markdown-auto_identifiers -o "!\!.html" "!\!.!"
html->hlf | *.html

Code: Select all

HtmlToFarHelp.exe from="!\!.!" to="!\!.hlf"

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Sun 12 Nov, 2017 19:40

Все-таки пожелание потребовало целой статьи :)
Спасибо, это все полезно будет.

User avatar
John Doe
Бюрократ
Posts: 11848
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 26 times
Been thanked: 130 times

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

Post by John Doe » Mon 13 Nov, 2017 13:49

John Doe wrote:
Wed 08 Nov, 2017 16:00
Жаль нет конвертера в bbcode.
Большинство того, что попалось онлайн работает плохо.
Подошёл вот этот https://web.liferay.com/de/community/fo ... e/84206009

Для командной строки нашёл пока только под perl https://github.com/pjf/Markdown-phpBB, https://github.com/ohnonot/md2bb.pl

Под pandoc тоже существует, но haskell готовить я не умею.

User avatar
NightRoman
Posts: 5904
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 10 times
Been thanked: 11 times
Contact:

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

Post by NightRoman » Fri 17 Nov, 2017 06:07

John Doe wrote:
Sun 12 Nov, 2017 14:43
Markdown

Если в конце строки добавить два пробела, то последний подсветится (в обычном тексте, в списках).
В blockquote не подсветится.
Пофиксил, пул реквест в очереди с еще одним фиксом.
https://github.com/colorer/Colorer-schemes/pull/61

Последнее время ждать "приема" приходится долго...

Post Reply

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