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

Хотите говорить о Far и не знаете, куда обратиться?
2useven10
Posts: 5192
Joined: Mon 07 Sep, 2009 10:40
Has thanked: 18 times
Been thanked: 309 times

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

Post by 2useven10 »

Latest post of the previous page:

Кроме того что сам текст слегка смазан (возможно это мой просмотрщик косячит) и сильно устарел, всё остальное удобно: читать подряд, навигация по оглавлению, поиск...
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 (нужны отзывы)

Post by John Doe »

Centaur wrote:
John Doe wrote:А pdf действительно хорош тем, что можно распечатать.
Да, и плох тем, что больше с ним ничего сделать нельзя.
И не надо. Исходник же есть, в редактируемом формате.
Centaur wrote:А для печати на бумаге надо верстать сильно качественнее, чем это сделано в предложенном файле.
"Надо" понятие растяжимое.
User avatar
Centaur
Posts: 1083
Joined: Tue 05 Apr, 2005 20:09
Location: Novosibirsk, Russia
Been thanked: 2 times

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

Post by Centaur »

Я не о том, что PDF невозможно редактировать (каковую проблему наличие word’ового исходника плохо, но решает). Я о том, чтобы читать. PDF с экрана читать можно только от безысходности.
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 »

Centaur wrote:PDF с экрана читать можно только от безысходности.
Полностью поддерживаю!
Жёсткое разбиение на страницы и строки меня жутко бесит.
Фар есть инструмент, а не нянька. © 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 »

Однако PDF стандарт де-факто для разного рода документации, и всё мучаются но читают.
Нас тут никто мучаться конечно не заставляет, но будет ли html из ворда лучше?

Это я говорю в контексте того, что другого исходника тут нам не предлагают, но из параллельной темы однозначно следует что документацию вообще не стоит получать ручным редактированием документации.
User avatar
Centaur
Posts: 1083
Joined: Tue 05 Apr, 2005 20:09
Location: Novosibirsk, Russia
Been thanked: 2 times

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

Post by Centaur »

John Doe wrote:но будет ли html из ворда лучше?
John Doe wrote:html из ворда
John Doe wrote:из ворда
FFFFUUUUUUUUUUU.
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 »

...CCCCCCCCCCKKKKKKKKKKKK!!!!!!!!!!!!!
User avatar
SUSim
Posts: 1633
Joined: Thu 18 Feb, 2010 17:32
Has thanked: 9 times
Been thanked: 25 times

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

Post by SUSim »

Опять две страницы форума убили... была полезная тема, а в итоге одна вода(других дел нет)???
SimSU ··· ·· -- ··· ··-
V.K.
Posts: 5
Joined: Wed 08 Feb, 2012 19:45

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

Post by V.K. »

John Doe wrote:Выложите исходный FarRus.hlf, посмотрим.
у меня сохранился "сырой" текстовый вариант справки, где указано:

.Language=Russian,Russian (Русский)
Программа управления файлами и архивами
2.0 build 1263 x86
Copyright (C) 1996-2000 Eugene Roshal
Copyright (C) 2000-2009 FAR Group

именно с него я и делал PDF, но из PDF я этот кусок выкинул
сейчас у меня сборка 1666, наверное я заменил ею 1263 (я уже не помню)
скорее всего файл справки был взят со сборки 1263.
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

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

Post by professor_k »

Заинтересовался темой. Вроде уже больше 10 лет фаром пользуюсь, даром что программист, а все как обычный пользователь. Вот захотелось поглубже инструмент изучить, например, как хоткей куда-нибудь переназначить, или что там за звери такие, эти макросы... По форуму если инфа где-то и есть, то размазана тонким слоем. Попробовал читать справку слева-направо, сверху-вниз, и тут же захотелось читать удобнее. К примеру в pdf для читалки, ну или html хотя-бы. Нашел эту тему. Не увидел следов жизни, решил расшевелить самостоятельно. Итак.
NightRoman wrote:Конвертеры в HTML такие были где-то (наверное, на плугринге найдутся). Скорей всего, они все устарели, ибо формат справки развивался потихоньку. Если бы кто занялся этим, и была бы веб-версия справки, то польза кому-то от этого была бы, конечно (в основном, новичкам, естественно). Хотя бы отсылать в справку по линку с форума можно было бы (а так же из всяких факов и документаций, пригодилось бы и для этого, если бы был "официальный адрес веб-справки").
Есть хорошие новости. Судя по логам hlfviewer-а, все изменения, внесенные в него с 2007 года — поддержка юникода и новых форматов API. То есть, за последние 6 лет формат не изменился вообще (если не считать поддержку unicode). На плагринге нашел hlftohtml конвертер. Архивчик содержит также исходник на паскале, судя по датировке — 2002 года. Беглый просмотр исходника показывает, что к кодировке исходного файла он не привязан, входной файл рассматривается как последовательность байт, в которой разыскиваются управляющие символы в ASCII, а значит вполне себе теоретически должен обрабатывать UTF-8 файлы. То есть, если за 5 лет до этого в формате не было катастрофических изменений, то все должно просто работать.

И да, мои ожидания оправдались. В результате получился вполне себе приличный html, который потребовал только изменения кодовой страницы, да одного мелкого фикса (притом из-за косяка в исходнике, он даже уже пофикшен: rev.9891) для правильного отображения. Конечно, для полной красоты его еще равнять и равнять напильником, но даже в таком виде для моих задач сойдет. Результат прицеплен

Если у кого-то из власть имущих будет желание прикрутить к CI выкладывание этого произведение онлайн, могу в принципе взяться и переписать сам конвертер по образу и подобию под .Net, и немного причесать. Простите, с паскалем возиться лень.
professor_k
Posts: 7
Joined: Mon 25 Mar, 2013 19:47

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

Post by professor_k »

p.s. Забыл сам результат
Attachments
FarRus.htm.zip
Файл справки Far 3.0 build 3258 x64 в HTML
(90.61 KiB) Downloaded 238 times
User avatar
Mr.Merak
Posts: 178
Joined: Sun 10 Jan, 2010 16:22
Been thanked: 1 time

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

Post by Mr.Merak »

2professor_k
тихий ужас
Проблема фары №1: нет печати "из коробки"
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

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

Post by Skirda »

За труд спасибо, но труд (очередной) мартышкин (патамушта "<pre>")
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 »

Делать конвертер не-<pre> ещё больше мартышкиного труда.
Пути 2: 1) менять формат hlf 2) генерировать hlf из чего-то типа markdown
User avatar
Mr.Merak
Posts: 178
Joined: Sun 10 Jan, 2010 16:22
Been thanked: 1 time

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

Post by Mr.Merak »

Все эти попытки преобразовать справку во что-то человеческое автоматическим способом - полная фигня. Только руками - только хардкор. За все это время потуг - можно было сделать все руцями. И тут же вопрос - рас такой умный, че сам не сделал? Две простые причины:
1. Оно должно быть вики он-лайн с возможностью редактировать разными людьми и желательно с ролями (типа модерации)
2. Даже если так сделать - никто не повесит это в дистре на F1, а поэтому "труд (очередной) мартышкин" (с)
Проблема фары №1: нет печати "из коробки"
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 »

Даже если "повесить в дистре", то кто будет синхронизировать с hlf?

Вопрос риторический, ответ я дал постом выше.
Post Reply

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