Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Хотите говорить о Far и не знаете, куда обратиться?
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Latest post of the previous page:

Пардон, я что-то пропустил.
Накой нам вики вообще? Уже ведь пробовали?
User avatar
Alexey Samlyukov
Posts: 1765
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 7 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by Alexey Samlyukov »

Можно — при помощи того же wiki, удобнее, видно по ходу результат.
не делайте мне смешно
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by Skirda »

Вики-вики. Я не против Вики, но собирать-то Far локально как будете? (особенно если нет связи с сервером)
We are the Borg. You will be assimilated.
So Say We All!
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Вики положить в свн, и собирай на здоровье.
Но толку ноль
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by professor_k »

...Ну и почему сразу ноль? С одной стороны — живой онлайн-вариант справки, который можно править простым смертным, без SVNов, аккаунтов и прочей бюрократии. С другой — туда можно тех самых смертных отправлять читать прямо с FAQ.

Ой, простите. Я забыл. FAR не для пользователя.
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

professor_k wrote:...Ну и почему сразу ноль?
Не сразу. Просто уже пробовали.

И надо разделить 2 задачи
- читать хелп онлайн
- править хелп онлайн
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by Skirda »

professor_k wrote:живой онлайн-вариант справки, который можно править простым смертным, без SVNов, аккаунтов и прочей бюрократии.
Т.е. в один прекрасный момент мы увидим хелп из одной строки, посылающий всех в пешее эротическое путешествие? Спасибы в этом случае куда слать?
We are the Borg. You will be assimilated.
So Say We All!
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Skirda
Речь о том, чтобы "простой смертный" мог править в вике, а будете ли вы вику хранить в свн или нет его не касается.
Путешествие маловероятно, если не наделять каждого анонима правами.

Но пробовали, пробовали...
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by professor_k »

John Doe wrote:И надо разделить 2 задачи
- читать хелп онлайн
- править хелп онлайн
Было, простите, что?.. Энциклопедия? Вот что простой смертный сможет написать о API FARа? А вот справку расширять — вполне. Даже здесь на форуме очень много инфы, размазанной тонким слоем (в смысле — когда нужно, фиг найдешь), которой бы очень даже не помешало оказаться в справке.
Skirda wrote:Т.е. в один прекрасный момент мы увидим хелп из одной строки, посылающий всех в пешее эротическое путешествие? Спасибы в этом случае куда слать?
А на wikipedia вы часто такое видете? Есть простые механизмы борьбы с таким, уже очень давно обкатанные.

И да, относительно конвертеров. Я посмотрел то, что есть в FarNet — там несколько строк кода. Может взять redcarpet и использовать ruby? С ним проблем при сборке быть не должно вне зависимости от сервера.
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

Болтливых много.
Лично вы готовы править? Почему не правите? Нужны шашечки в виде вики?
professor_k wrote:И да, относительно конвертеров. Я посмотрел то, что есть в FarNet — там несколько строк кода. Может взять redcarpet и использовать ruby? С ним проблем при сборке быть не должно вне зависимости от сервера.
Может, если будет тот кто реализует, и будет поддерживать. Сможете?
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by Skirda »

professor_k wrote:А на wikipedia вы часто такое видете? Есть простые механизмы борьбы с таким, уже очень давно обкатанные.
У нас нет штата модераторов, чтобы сиюминутно отслеживать изменения.
А по поводу "все, кто хочет править" - что-то я не видел "девятый вал" патчей для hlf-файлов или записей на мантисе или здесь, на форуме (чем не нормальный способ помочь проекту?). К сожалению. И никогда не поверю, что с приходом вики у нас будет суппер-пупер хелп.
We are the Borg. You will be assimilated.
So Say We All!
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by professor_k »

@Skirda: есть режимы премодерации.
И согласитесь, отредактировать страницу wiki и получить доступ на запись в SVN — это две большие разницы. Даже если без доступа, просто патч отправить — тоже тот ещё геморрой (найти исходники, стянуть, блин, SVN, (что такое SVN???/ну или когда я его в последний раз использовал??? скачивать что-ли?), править hlf, (так, ухо — это что? раздел? Блин, где бы почитать описание формата?..), сделать патч (черт, где в этом TortoiseSVN патч экспортнуть?...) ). А если я лажу по вики и вижу неточности — я их исправляю. Просто, потому что это занимает несколько секунд, а не час.

@John Doe Относительно конвертера из md в hlf с помощью ruby — на выходных попробую. Выглядит несложно.
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

professor_k wrote:@John Doe Относительно конвертера из md в hlf с помощью ruby — на выходных попробую. Выглядит несложно.
Не торопитесь, я лично не знаю что там на сервере доступно.

И второе.
Перевести можно, но кто будет поддерживать, развивать?
User avatar
HaRT
Moderator
Posts: 10806
Joined: Tue 30 Aug, 2005 17:21
Has thanked: 220 times
Been thanked: 357 times

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by HaRT »

professor_k wrote:А если я лажу по вики и вижу неточности — я их исправляю. Просто, потому что это занимает несколько секунд, а не час.
Я разделяю эту точку зрения. С вики порог вхождения в правку гораздо ниже, это не сложнее, чем писать тут на форуме.
Фар есть инструмент, а не нянька. © 2009 DrKnS
User avatar
John Doe
Бюрократ
Posts: 13801
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 72 times
Been thanked: 425 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by John Doe »

professor_k wrote:И согласитесь, отредактировать страницу wiki и получить доступ на запись в SVN — это две большие разницы.
Корреляция между готовностью качественно править, и готовностью поставить svn - где-то 0,9-0,95

Поэтому я не разделяю эту точку зрению.
User avatar
NightRoman
Posts: 6184
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 32 times
Been thanked: 62 times
Contact:

Re: Справка Far в легко читаемом формате (PDF, HTML и т.п.)

Post by NightRoman »

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

А работать в сторону конвертеров в неразвивающийся HLF не слишком хорошо. В том же моем конвертере HelpDown, например, не все фичи HLF можно описать в md. И некоторые фичи md не имеют смысла в HLF. И еще много нюансов.
Post Reply

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