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

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

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

Post by NightRoman »

Latest post of the previous page:

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

В какой схеме колорера недочет? В markdown? Тогда подробнее (я уж забыл немного, что там и как).
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

А пока оставлю последующим поколениям инструкцию с чего начать при использовании 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: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

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

Post by NightRoman »

Все-таки пожелание потребовало целой статьи :)
Спасибо, это все полезно будет.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

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: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

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

Post by NightRoman »

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

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

Последнее время ждать "приема" приходится долго...
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Спасибо, подключил, то что надо.
"Ещё один фикс" тоже весьма кстати.

Соберу тут пожелания по раскраске:
  • Возможно ли раскрашивать fenced code blocks соответственно указанному типу?
  • И сложно ли распознавать setext-заголовки (т.е. подчёркнутые)?
  • Расширенное использование бэкслеша для экранирования.
    • В конце строки для индикации жёсткого переноса, отображать с ярким фоном (как и завершающие два пробела)
    • Перед пробелом отображать бэкслеш бледно (как и перед остальными escape-символами)
Last edited by John Doe on Fri 17 Nov, 2017 11:43, edited 1 time in total.
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

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

Post by NightRoman »

John Doe wrote: Fri 17 Nov, 2017 08:50По нему вопрос: возможно ли раскрашивать fenced code blocks соответственно указанному типу?

И сложно ли распознавать setext-заголовки (т.е. подчёркнутые)?
Первое можно для некоторого забитого набора языков из тех, что есть у колорер. Пробовал, работает. Пока неохота.

Второе не знаю, как. И можно ли вообще. Конструкция (начало определяется концом) не вписывается в обычную схему парсинга колорера.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

Добавил ещё пожеланий по раскраске
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

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

Post by John Doe »

https://gist.github.com/johnd0e/7d00f4d ... e-makefile
Makefile for documents converting using pandoc. Source: *.text (extension defined by SOURCE_EXT). Target(s): enumerated in commandline (otherwise can be set in .DEFAULT_GOAL) Usage: make some_doc.html Convert some_doc.text to some_doc.html. Instead of ".html" any other pandoc-supported file type can be used. make some_doc.hlf Convert some_doc.text to some_doc.hlf using pandoc and HtmlToFarHelp. make html Convert *.text to *.html. Instead of ".html" any other supported extension can be used, incl. hlf (must be enumerated in TARGET_EXT). make clean Clean current directory from all files with extensins specified in TARGET_EXT. make help This help Notes: 1. pandoc.exe and HtmlToFarHelp.exe must be available. It is also possible to define full paths in env variables PANDOC/HTMLTOFARHELP. 2. Some conversions may require additional lua filters, which must be present in current directory. Alternatively they can reside in $(APPDATA)\pandoc\filters 3. Some conversions may require lua writers, which must be present in current directory. Alternatively they can reside in $(APPDATA)\pandoc\custom
https://t.me/FarManager — Telegram чат
Post Reply

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