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

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
cmd.exe
Posts: 364
Joined: Fri 16 Apr, 2010 18:26
Location: Нижний Новгород
Has thanked: 179 times
Been thanked: 5 times
Contact:

Re: Переименовать плюгринг в макркет

Post by cmd.exe » Wed 12 Oct, 2011 15:49

Latest post of the previous page:

Maximus5 wrote:Вот если бы из html можно было автоматически генерить hlf...
Возможно... Из HTML->CHM->HLF
I've been using Vim for about 2 years now, mostly because I can't figure out how to exit it. (c) I Am Devloper
I know nothing except the fact of my ignorance. (с) Socrates

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

Re: Переименовать плюгринг в макркет

Post by John Doe » Wed 12 Oct, 2011 16:38

chm и так есть (прямо в дистрибутиве), но вот hlf из него получить не легче чем из html.

User avatar
SUSim
Posts: 1520
Joined: Thu 18 Feb, 2010 17:32
Has thanked: 5 times
Been thanked: 8 times

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

Post by SUSim » Fri 14 Oct, 2011 19:09

При написании макросов стандартный хелп (F1) не поможет, а, скорее, навредит, да и как его вызывать при записи макросов? Правильнее имхо было бы в хелпе сделать ссылку на запускаемый chm. В самом FARе править макросы практически нельзя (только используя плагины и/или сторонние проги), и когда может помочь встроенный хелп (hlf)?

Важно только то, что надо указать в стандартной помощи фара то, что, есть документация (помощь) по продвинутым макросам, и, к стати, по написанию плагинов!
SimSU ··· ·· -- ··· ··-

Maximus5
Posts: 3292
Joined: Sun 11 Nov, 2007 02:03
Been thanked: 4 times
Contact:

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

Post by Maximus5 » Fri 14 Oct, 2011 20:17

SUSim wrote:При написании макросов стандартный хелп (F1) не поможет, а, скорее, навредит, да и как его вызывать при записи макросов?
Это ваше IMHO. Да и каким образом ты собираешься вставлять функцию при записи макроса? Речь идет о редактировании. И навредить наличие информации не может в принципе.
SUSim wrote:Правильнее имхо было бы в хелпе сделать ссылку на запускаемый chm.
Чем правильнее? Намакросить вызов chm на CtrlF1 я могу и сам. Причем с переходом на соотв. раздел.
SUSim wrote:В самом FARе править макросы практически нельзя (только используя плагины и/или сторонние проги)
:rtfm2: Ctrl. CtrlShift.
SUSim wrote:Важно только то, что надо указать в стандартной помощи фара то, что, есть документация (помощь) по продвинутым макросам, и, к стати, по написанию плагинов!
Важно дать удобный доступ к этой информации "по умолчанию", без необходимости выполнения дополнительных телодвижений или необходимости плагинов.
В принципе, я согласен, что поиск удобнее в chm, но до него фиг доберешся (искаропки), а вот F1 всегда под рукой.

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

Re: Как распечатать Help к FARy ?

Post by John Doe » Thu 09 Feb, 2012 17:11

У HlfView например есть исходники (*.pas, но алгоритмы ведь не сложные).
В принципе там и так всё довольно прилично выглядит, даже стили используются.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by John Doe » Thu 09 Feb, 2012 17:28

По поводу конвертера: всё-таки формат hlf слишком примитивен чтобы получить из него нечто похожее по качеству форматирования к выложенному pdf.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by NightRoman » Thu 09 Feb, 2012 17:35

Это верно. Но такое качество как в пдф, хоть и красиво, слов нет, но это шашечки. Но никто ж не собирается издавать "Фар для чайников" (хоть это было бы реально прикольно, я б купил такое чудо).

А что реально нужно, чтобы была инфа нормально отформатированная и в ней работающие ссылки. Этого конвертером безусловно можно добиться.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by John Doe » Thu 09 Feb, 2012 18:02

NightRoman wrote:А главный недостаток (по-моему), что "по-честному" абзацы никто не форматирует: все используют <pre>...</pre> всего текста, а не следуют тому, как Фар форматирует или не форматирует абзацы.
NightRoman wrote:А что реально нужно, чтобы была инфа нормально отформатированная [...]
А расскажите как вы себе представляете нормальное форматирование без <pre>?
Я не вижу такой возможности: всё форматирование сейчас зиждется на пробелах. Изменить это можно (например) введением в hlf понятия "таблица".

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by NightRoman » Thu 09 Feb, 2012 18:10

John Doe
Я не понимаю о чем вопрос, если честно. Как выглядит в Фар хелпе, так пусть будет выглядеть и хтмл в броузере. С работающими ссылками. Все, реально никому больше ничего и не надо. Хочешь - смотри, ходи по ссылкам. Хочешь, печатай.

Те конвертеры, что есть, этого не делают прилично, форматирование некоторых абзацев получается никуда не годным, насколько я помню. Перепроверять неохота, они, очевидно, не поменялись с тех пор.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by John Doe » Thu 09 Feb, 2012 18:16

NightRoman wrote:Я не понимаю о чем вопрос, если честно.
Форматирование справки фара осуществляется пробелами, но в то же время присутствует понятие абзаца (текст может динамически форматироваться по ширине экрана).

В html аналога этому вроде как нет:
- либо честные абзацы <p>, но все пробелы тогда съедаются, и форматирование идёт к чёрту.
- либо предварительно форматированный текст <pre>, тогда пробелы остаются, но абзацы не будут форматироваться под ширину экрана, как вы этого хотите

Я не знаю как совместить обе вещи в html.
Подскажите.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by NightRoman » Thu 09 Feb, 2012 18:18

Сделать можно все, было бы желание, руки время и т.п. Есть в хтмл и "несъедаемые" пробелы между прочим.

И те абзацы которые в hlf преформатированы (с индентацией) - те, конечно, должны перейти и в хтмл, как <pre>. А не преформатированные - в общем случае - в обычные. А где там в не преформатируемых могут быть несъедаемые пробелы? Таких мест, наверное, код наплакал.

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

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by John Doe » Thu 09 Feb, 2012 18:35

NightRoman wrote:Сделать можно все, было бы желание, руки время и т.п.
Лишь бы результат это оправдывал.
NightRoman wrote:А где там в не-пре-форматируемых могут быть несъедаемые пробелы? Таких мест, наверное, код наплакал.
Пожалуй вы правы.

Да только пре-форматируемых слишком много, и не по делу:
На самом деле в таких местах должен быть ^<wrap>

Но полно и таких чудес где ^<wrap> не поможет:

Как вы предложите реализовать этот ^<wrap> в html?
Не иначе как придётся эвристически строить таблицы и списки.

LAT
Posts: 203
Joined: Thu 21 Jan, 2010 20:00
Has thanked: 6 times
Been thanked: 10 times

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by LAT » Thu 09 Feb, 2012 19:04

А на форуме, случайно, никого из преподавателей информатики/программирования/и т.д. нет? Конвертер "hlf -> html" - прямо готовая тема для курсовой. :)

User avatar
ctapmex
Posts: 1010
Joined: Fri 11 Apr, 2008 07:53
Been thanked: 4 times
Contact:

Re: Справка Far в формате *.pdf (нужны отзывы)

Post by ctapmex » Thu 09 Feb, 2012 19:07

и ждать до сессии? или пересдачи в сентябре ? -)

User avatar
Centaur
Posts: 1083
Joined: Tue 05 Apr, 2005 20:09
Location: Novosibirsk, Russia
Been thanked: 1 time

Re: Конвертер hlf->html (или "Как распечатать Help к FARy")

Post by Centaur » Fri 10 Feb, 2012 06:27

Есть, на самом деле, революционное соображение.

Мне, как пользователю, в большинстве случаев неудобен help в том виде, в каком он сейчас есть — в модальном окне. Работа с незнакомым диалогом выглядит так:
  1. Запомнить название первого контрола
  2. Открыть хелп
  3. Найти в нём описание контрола
  4. Закрыть хелп
  5. Заполнить контрол
  6. Запомнить название следующего контрола
  7. Продолжить с пункта 2
На мой взгляд, модальный хелп в консоли — это костыль, оставшийся с тех времён, когда понятия веб-браузера ещё не было, да и веба как такового тоже.

Предложение состоит в том, чтобы сделать HTML (или даже лучше какую-нибудь специализированную XML-схему, возможно, DocBook или Mallard) базовым форматом справки. А дальше можно её XSLT’шить в HTML (и потом компилировать в CHM?) и публиковать на сайте.

Я бы, может, даже занялся потихоньку. Но это затронет также плагинописателей. Поэтому без зелёного свистка в воздух пока не буду.

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

Re: Конвертер hlf->html (или "Как распечатать Help к FARy")

Post by NightRoman » Fri 10 Feb, 2012 08:08

Но этот модальный консольный хелп-таки часто удобен. Иногда неудобен, факт. Но ему следует оставаться в Фаре, чтобы Фар был "самодостаточен". Кроме того, хоть я такого не видал, но GUI вроде может вообще не быть на некоторых серверных виндах (или я слышал звон, да не так?). Другое дело, что альтернативный хелп было бы хорошо иметь (для читания подряд, для печати, для поиска по всему тексту, и т.п.).

Maximus5
Posts: 3292
Joined: Sun 11 Nov, 2007 02:03
Been thanked: 4 times
Contact:

Re: Конвертер hlf->html (или "Как распечатать Help к FARy")

Post by Maximus5 » Fri 10 Feb, 2012 08:16

При работе telnet никакого гуя нет. Telnet нужен, конечно нечасто, но тем не менее...

Post Reply

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