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

Хотите говорить о Far и не знаете, куда обратиться?
Post Reply
V.K.
Posts: 5
Joined: Wed 08 Feb, 2012 19:45

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

Post by V.K. »

Как начинающий пользователь Far решил обратиться к справке программы и обнаружил, что она неудобна для использования. Поэтому решил сделать полноценное руководство пользователя в формате *.pdf на основе встроенного файла справки (см. ссылку ниже).
От файла справки предлагаемое руководство выгодно отличают: "человеческое" форматирование текста (включая различные шрифты для команд, клавиш и т.д. с целью улучшения удобочитаемости), подробное содержание, индекс и другие усовершенствования.
К сожалению, не имею достаточно времени для вычитки и редактирования всего файла. Посему прошу всех, кому это интересно, высказать свои конструктивные замечания и предложения о проделанной работе.

Файл больше 2 Мб, поэтому выложил на депозите:

http://depositfiles.com/files/5qa72g5lb

Примечание модератора: Смежная тема Встроенная справка в удобном формате
Last edited by V.K. on Thu 01 Jan, 1970 01:00, edited 0 times in total.
Reason: Примечание

User avatar
NightRoman
Posts: 5920
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 12 times
Been thanked: 14 times
Contact:

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

Post by NightRoman »

Замучился выкачивать (продираться через заслонки) этого депозита...

По-моему, очень даже хорошо получилось. Новичкам-то точно в таком виде документ был бы полезен, особенно учитывая, что документ живой, ссылки все работают.

А как получен документ? Надеюсь не вручную? Если в ручную, то это все загнется (кто будет обновлять?). Если не вручную, то надо бы опубликовать инструменты что ли (никто не обязан, конечно). Тогда, может, и будущее есть у такого вида справки.

2useven10
Posts: 4000
Joined: Mon 07 Sep, 2009 10:40
Has thanked: 5 times
Been thanked: 179 times

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

Post by 2useven10 »

Выглядит неплохо. Но встроенная справка постоянно корректируется. Как поддерживать актуальность?

V.K.
Posts: 5
Joined: Wed 08 Feb, 2012 19:45

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

Post by V.K. »

Исходник выкачан в текстовый файл с помощью какой-то там команды Far (я уже не помню какой именно). Затем редактировался в Word (добавлялись закладки, ссылки и пр.)

Я конечно могу выложить вордовский исходник, но там нужно хорошо разбираться в Word, чтобы не испортить документ.

Известный мне недостаток - документ отражает содержание справки [зачеркнуто: на конец 2010 года] UPD - сборки 1263, то есть успел устареть (насколько сильно - судить не берусь). Вордовский исходник был сверстан в январе 2011-го. Думал распечатаю, прочитаю и поправлю ошибки, но вижу, что времени на это нет. Поэтому решил залить "как есть".

В принципе документ является открытым для изменений, таким же как и Far. Можно добавлять новые разделы, менять содержание. Я думаю, не обязательно привязываться к встроенной справке. Пусть опытные юзеры набросают дополнения, новые разделы - я добавлю и выложу следующую версию. Если увижу, что не успеваю - выложу исходник и делайте с ним что хотите )).
Last edited by V.K. on Fri 10 Feb, 2012 22:17, edited 1 time in total.

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

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

Post by Centaur »

PDF — это промежуточный формат для сдачи в типографию. Вы точно уверены, что FAR’у нужна печатная документация?

PDF, печатаемый из Word’ового исходника, поддерживаемого вручную — не нужен вдвойне. Есть CHM и есть web-версия, чего же ещё надо?

Kildor
Posts: 1515
Joined: Wed 16 Mar, 2005 06:26
Location: Новосибирск
Been thanked: 1 time
Contact:

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

Post by Kildor »

Last edited by Kildor on Thu 01 Jan, 1970 01:00, edited 0 times in total.
Reason: Так бывает если не пользоваться [quote]
Ты мне не выкай!
«ФарФорум не для пользователей!»
Upd:
P.S. Я просто поддерживаю беседу.» © Народ.

xmpp:kildor@jabber.ru

fps
Posts: 211
Joined: Wed 20 Apr, 2005 06:39
Has thanked: 17 times
Been thanked: 6 times

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

Post by fps »

Centaur wrote:Есть CHM и есть web-версия, чего же ещё надо?
А где есть CHM версия?

User avatar
NightRoman
Posts: 5920
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 12 times
Been thanked: 14 times
Contact:

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

Post by NightRoman »

И веб-версия тоже? Может, Centaur, все-таки писание (документацию по АПИ) имел в виду, а не справку Фара? Я не в курсе, что для справки есть CHM или веб. Если есть, хотелось бы узнать, да.

User avatar
NightRoman
Posts: 5920
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 12 times
Been thanked: 14 times
Contact:

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

Post by NightRoman »

Centaur wrote:PDF — это промежуточный формат для сдачи в типографию. Вы точно уверены, что FAR’у нужна печатная документация?
"Фар для чайников" и "Far for dummies"? :) А почему нет-то? Хорошо помню, как "учил Фар" - именно читал справку всю подряд. И надо сказать, в оригинальном формате это было очень неудобно.

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

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

Post by Centaur »

NightRoman wrote:И веб-версия тоже? Может, Centaur, все-таки писание (документацию по АПИ) имел в виду, а не справку Фара? Я не в курсе, что для справки есть CHM или веб. Если есть, хотелось бы узнать, да.
Да, я имел в виду Энциклопедию. Но chm-версию хелпа тоже кто-то когда-то делал, ещё в фидошные времена.

Ну так лучше потратить усилия на конвертор hlf в html и далее опционально в chm, чем вручную перебивать в Word/ODF и потом печатать в неудобный PDF.

User avatar
NightRoman
Posts: 5920
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 12 times
Been thanked: 14 times
Contact:

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

Post by NightRoman »

Конвертеры в HTML такие были где-то (наверное, на плугринге найдутся). Скорей всего, они все устарели, ибо формат справки развивался потихоньку. Если бы кто занялся этим, и была бы веб-версия справки, то польза кому-то от этого была бы, конечно (в основном, новичкам, естественно). Хотя бы отсылать в справку по линку с форума можно было бы (а так же из всяких факов и документаций, пригодилось бы и для этого, если бы был "официальный адрес веб-справки").

Max Rusov
Posts: 3632
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Has thanked: 1 time
Been thanked: 11 times

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

Post by Max Rusov »

Может Enc в Wiki перевести да и обойтись этим?...

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

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

Post by John Doe »

Шутите?
А вот обсуждение.

User avatar
NightRoman
Posts: 5920
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 12 times
Been thanked: 14 times
Contact:

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

Post by NightRoman »

Max Rusov wrote:Может Enc в Wiki перевести да и обойтись этим?...
CHM вариант удобнее, мне кажется. Но речь вроде не о том, как построить CHM (это не проблема, если не ошибаюсь), а о том, что она еще не готова, АПИ 3 полностью там не описан, там и сям инфа от АПИ 2. Предлагать такое на публику (неподготовленную), наверное, не стоит, верно.

Max Rusov
Posts: 3632
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Has thanked: 1 time
Been thanked: 11 times

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

Post by Max Rusov »

John Doe wrote:Шутите?
Семен Семеныч! Туплю. Но только она неполная, что-то. Может надо было сначала конвертнуть текущую версию, а потом править, чем с нуля все писать?...

Post Reply

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