Справка Far в легко читаемом формате (PDF, HTML и т.п.)
Справка Far в легко читаемом формате (PDF, HTML и т.п.)
Как начинающий пользователь Far решил обратиться к справке программы и обнаружил, что она неудобна для использования. Поэтому решил сделать полноценное руководство пользователя в формате *.pdf на основе встроенного файла справки (см. ссылку ниже).
От файла справки предлагаемое руководство выгодно отличают: "человеческое" форматирование текста (включая различные шрифты для команд, клавиш и т.д. с целью улучшения удобочитаемости), подробное содержание, индекс и другие усовершенствования.
К сожалению, не имею достаточно времени для вычитки и редактирования всего файла. Посему прошу всех, кому это интересно, высказать свои конструктивные замечания и предложения о проделанной работе.
Файл больше 2 Мб, поэтому выложил на депозите:
http://depositfiles.com/files/5qa72g5lb
Примечание модератора: Смежная тема Встроенная справка в удобном формате
От файла справки предлагаемое руководство выгодно отличают: "человеческое" форматирование текста (включая различные шрифты для команд, клавиш и т.д. с целью улучшения удобочитаемости), подробное содержание, индекс и другие усовершенствования.
К сожалению, не имею достаточно времени для вычитки и редактирования всего файла. Посему прошу всех, кому это интересно, высказать свои конструктивные замечания и предложения о проделанной работе.
Файл больше 2 Мб, поэтому выложил на депозите:
http://depositfiles.com/files/5qa72g5lb
Примечание модератора: Смежная тема Встроенная справка в удобном формате
Last edited by V.K. on Thu 01 Jan, 1970 01:00, edited 0 times in total.
Reason: Примечание
Reason: Примечание
- 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 (нужны отзывы)
Замучился выкачивать (продираться через заслонки) этого депозита...
По-моему, очень даже хорошо получилось. Новичкам-то точно в таком виде документ был бы полезен, особенно учитывая, что документ живой, ссылки все работают.
А как получен документ? Надеюсь не вручную? Если в ручную, то это все загнется (кто будет обновлять?). Если не вручную, то надо бы опубликовать инструменты что ли (никто не обязан, конечно). Тогда, может, и будущее есть у такого вида справки.
По-моему, очень даже хорошо получилось. Новичкам-то точно в таком виде документ был бы полезен, особенно учитывая, что документ живой, ссылки все работают.
А как получен документ? Надеюсь не вручную? Если в ручную, то это все загнется (кто будет обновлять?). Если не вручную, то надо бы опубликовать инструменты что ли (никто не обязан, конечно). Тогда, может, и будущее есть у такого вида справки.
Re: Справка Far в формате *.pdf (нужны отзывы)
Исходник выкачан в текстовый файл с помощью какой-то там команды Far (я уже не помню какой именно). Затем редактировался в Word (добавлялись закладки, ссылки и пр.)
Я конечно могу выложить вордовский исходник, но там нужно хорошо разбираться в Word, чтобы не испортить документ.
Известный мне недостаток - документ отражает содержание справки [зачеркнуто: на конец 2010 года] UPD - сборки 1263, то есть успел устареть (насколько сильно - судить не берусь). Вордовский исходник был сверстан в январе 2011-го. Думал распечатаю, прочитаю и поправлю ошибки, но вижу, что времени на это нет. Поэтому решил залить "как есть".
В принципе документ является открытым для изменений, таким же как и Far. Можно добавлять новые разделы, менять содержание. Я думаю, не обязательно привязываться к встроенной справке. Пусть опытные юзеры набросают дополнения, новые разделы - я добавлю и выложу следующую версию. Если увижу, что не успеваю - выложу исходник и делайте с ним что хотите )).
Я конечно могу выложить вордовский исходник, но там нужно хорошо разбираться в Word, чтобы не испортить документ.
Известный мне недостаток - документ отражает содержание справки [зачеркнуто: на конец 2010 года] UPD - сборки 1263, то есть успел устареть (насколько сильно - судить не берусь). Вордовский исходник был сверстан в январе 2011-го. Думал распечатаю, прочитаю и поправлю ошибки, но вижу, что времени на это нет. Поэтому решил залить "как есть".
В принципе документ является открытым для изменений, таким же как и Far. Можно добавлять новые разделы, менять содержание. Я думаю, не обязательно привязываться к встроенной справке. Пусть опытные юзеры набросают дополнения, новые разделы - я добавлю и выложу следующую версию. Если увижу, что не успеваю - выложу исходник и делайте с ним что хотите )).
Last edited by V.K. on Fri 10 Feb, 2012 22:17, edited 1 time in total.
- Centaur
- Posts: 1083
- Joined: Tue 05 Apr, 2005 20:09
- Location: Novosibirsk, Russia
- Been thanked: 2 times
Re: Справка Far в формате *.pdf (нужны отзывы)
PDF — это промежуточный формат для сдачи в типографию. Вы точно уверены, что FAR’у нужна печатная документация?
PDF, печатаемый из Word’ового исходника, поддерживаемого вручную — не нужен вдвойне. Есть CHM и есть web-версия, чего же ещё надо?
PDF, печатаемый из Word’ового исходника, поддерживаемого вручную — не нужен вдвойне. Есть CHM и есть web-версия, чего же ещё надо?
-
- Posts: 1515
- Joined: Wed 16 Mar, 2005 06:26
- Location: Новосибирск
- Been thanked: 1 time
- Contact:
Re: Справка Far в формате *.pdf (нужны отзывы)
Last edited by Kildor on Thu 01 Jan, 1970 01:00, edited 0 times in total.
Reason: Так бывает если не пользоваться [quote]
Reason: Так бывает если не пользоваться [quote]
Ты мне не выкай!
«ФарФорум не для пользователей!»
Upd:
P.S. Я просто поддерживаю беседу.» © Народ.
xmpp:kildor@jabber.ru
«ФарФорум не для пользователей!»
Upd:
P.S. Я просто поддерживаю беседу.» © Народ.
xmpp:kildor@jabber.ru
- 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 (нужны отзывы)
И веб-версия тоже? Может, Centaur, все-таки писание (документацию по АПИ) имел в виду, а не справку Фара? Я не в курсе, что для справки есть CHM или веб. Если есть, хотелось бы узнать, да.
- 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 (нужны отзывы)
"Фар для чайников" и "Far for dummies"? А почему нет-то? Хорошо помню, как "учил Фар" - именно читал справку всю подряд. И надо сказать, в оригинальном формате это было очень неудобно.Centaur wrote:PDF — это промежуточный формат для сдачи в типографию. Вы точно уверены, что FAR’у нужна печатная документация?
- Centaur
- Posts: 1083
- Joined: Tue 05 Apr, 2005 20:09
- Location: Novosibirsk, Russia
- Been thanked: 2 times
Re: Справка Far в формате *.pdf (нужны отзывы)
Да, я имел в виду Энциклопедию. Но chm-версию хелпа тоже кто-то когда-то делал, ещё в фидошные времена.NightRoman wrote:И веб-версия тоже? Может, Centaur, все-таки писание (документацию по АПИ) имел в виду, а не справку Фара? Я не в курсе, что для справки есть CHM или веб. Если есть, хотелось бы узнать, да.
Ну так лучше потратить усилия на конвертор hlf в html и далее опционально в chm, чем вручную перебивать в Word/ODF и потом печатать в неудобный PDF.
- 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 такие были где-то (наверное, на плугринге найдутся). Скорей всего, они все устарели, ибо формат справки развивался потихоньку. Если бы кто занялся этим, и была бы веб-версия справки, то польза кому-то от этого была бы, конечно (в основном, новичкам, естественно). Хотя бы отсылать в справку по линку с форума можно было бы (а так же из всяких факов и документаций, пригодилось бы и для этого, если бы был "официальный адрес веб-справки").
-
- Posts: 3651
- Joined: Wed 23 Nov, 2005 11:11
- Location: Москва-Питер
- Has thanked: 2 times
- Been thanked: 19 times
- 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 (нужны отзывы)
CHM вариант удобнее, мне кажется. Но речь вроде не о том, как построить CHM (это не проблема, если не ошибаюсь), а о том, что она еще не готова, АПИ 3 полностью там не описан, там и сям инфа от АПИ 2. Предлагать такое на публику (неподготовленную), наверное, не стоит, верно.Max Rusov wrote:Может Enc в Wiki перевести да и обойтись этим?...
-
- Posts: 3651
- Joined: Wed 23 Nov, 2005 11:11
- Location: Москва-Питер
- Has thanked: 2 times
- Been thanked: 19 times
Re: Справка Far в формате *.pdf (нужны отзывы)
Семен Семеныч! Туплю. Но только она неполная, что-то. Может надо было сначала конвертнуть текущую версию, а потом править, чем с нуля все писать?...John Doe wrote:Шутите?