Встроенная справка в удобном формате

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

Re: Встроенная справка в удобном формате

Post by NightRoman »

Latest post of the previous page:

Просто для справки, может кому пригодится, MarkdownDeep (там, где эта песочница) - это то, что я в итоге выбрал для работы с маркдауном. Пробовал несколько .NET библиотек, эта лучшая пока (меня полностью устраивает, скажем так). Опенсорс. Есть JavaScript Edition (не пробовал).
User avatar
NightRoman
Posts: 5945
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 14 times
Been thanked: 15 times
Contact:

Re: Встроенная справка в удобном формате

Post by NightRoman »

В маркдауне мне не нравится только одно :) Простенькую схему для колорера под него я написал без проблем, а вот для хорошей - то ли моих знаний колдовства со схемами не хватает, то ли колорер имеет-таки принципиальные ограничения. Например, не знаю, как блоки в точности описать, они суть на индентациях устроены, а в колорере нет особо такого понятия (а не мешало бы...).
User avatar
HaRT
Moderator
Posts: 9558
Joined: Tue 30 Aug, 2005 17:21
Location: Санкт-Петербург
Has thanked: 111 times
Been thanked: 232 times

Re: Встроенная справка в удобном формате

Post by HaRT »

Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
NightRoman
Posts: 5945
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 14 times
Been thanked: 15 times
Contact:

Re: Встроенная справка в удобном формате

Post by NightRoman »

Technology preview :). Написал простенький конвертер html -> hlf (для меня уже годится, буду пользовать, но когда дойдут руки до публичной версии - не знаю). В результате схема markdown -> html -> hlf показала себя вполне рабочей. Сразу видны и плюсы (немало), и минусы (немного, но есть) такого подхода (в детали не буду вдаваться). Само собой, минусы можно со временем сократить, плюсы умножить.

В аттаче исходный хелп на markdown (пишем руками) + html & hlf (получены конвертацией). Это хелп для PowerShellFar, как раз пример хелпа, где html версия может быть полезна, ибо в этом хелпе не столько про Far UI речь, сколько про фичи и особенности PowerShell в PowerShellFar.

UPD: удалены устаревшие примеры.

FarHelpDown — конвертер md -> htm -> hlf
Post Reply

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