Page 3 of 9

Re: Улучшение файла помощи фара

Posted: Wed 06 Oct, 2010 13:24
by SlashNet

Latest post of the previous page:

Вставлю и свои 5 копеек.
В справке о меню пользователя нет упоминания о CtrlUp/CtrlDown.

UPD: Долго сообщение набирал - за меня уже написали

Re: Улучшение файла помощи фара

Posted: Wed 06 Oct, 2010 13:27
by John Doe
SlashNet wrote:UPD: Долго сообщение набирал - за меня уже написали
Очень долго, см. дату.
Hint: первый пост на странице это шапка :)

Re: Улучшение файла помощи фара

Posted: Wed 06 Oct, 2010 13:53
by SlashNet
Я туплю...

Re: Улучшение файла помощи фара

Posted: Wed 06 Oct, 2010 18:00
by DV
John Doe wrote:Я так думаю правильнее создать специальный раздел для меню, где среди прочего упомянуть и Ctrl-Alt-F.
Если двигаться этим путём, возникает два вопроса, плюс бонусный:
1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.

Re: Улучшение файла помощи фара

Posted: Wed 06 Oct, 2010 18:23
by John Doe
DV wrote:1. Как назвать этот раздел? Нужно какое-то более-менее общее название, в то же время отражающее специфику использования.
@MenuCmd
DV wrote:2. Как назвать ссылку на этот раздел и в какой форме её упоминать? Вариант "См. также/See also" не подходит, так как многие затрагиваемые разделы справки уже содержат "См. также/See also" со ссылкой на клавиатурные макросы, например.
Имхо, вполне подходит, только "См. также" надо будет вынести за скобки:

Code: Select all

    См. также:
    - Клавиатурные команды общие ~для всех меню~@MenuCmd@.
    - Cписок ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
DV wrote:3. Наконец, для полной определённости нужен полный и окончательный список тех разделов справки, в которые следует добавить ссылку на наш раздел меню.
Я составил этот список ещё вчера, сегодня дополнил.
Возможность что я что-то пропустил конечно остаётся...

Дополнительно ссылка нужна в @KeyRef и @Index.

P.S.
Сам раздел должен в свою очередь содержать ссылку на @KeyMacroMenuList.

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 12:05
by DV
FarHlf.12.1.diff - добавлен раздел @MenuCmd и ссылки на него:
http://bugs.farmanager.com/view.php?id=1535

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 12:14
by John Doe
Косметика:
  1. Неоправданный верхний регистр после двоеточия. Если бы "Клавиатурные команды" начинались с другой строки, то другое дело.

    Code: Select all

    +    См. также: Клавиатурные команды, общие ~для всех меню~@MenuCmd@.
    Мне кажется стоит указывать с новой строки даже если всего один пункт.
  2. А тут наоборот, "список" почему-то с маленькой буквы.

    Code: Select all

    +    См. также:
     
    +    список ~макроклавиш~@KeyMacroUserMenuList@, доступных в меню пользователя.
    +    Клавиатурные команды, общие ~для всех меню~@MenuCmd@.
Кстати, почему вы решили не выделять пункты минусом?

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 13:05
by Centaur
John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
Потому что это неправильно?

Пункты маркированного списка выделяются либо каким-нибудь буллитом (• и подобными), либо, в российской типографской традиции, каким-нибудь тире.

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 13:47
by DV
John Doe wrote:Неоправданный верхний регистр после двоеточия
Исправил в FarHlf.12.2.diff.
Кстати, я могу удалять предыдущие прикрепленные файлы? Что-то не нашёл, как.
John Doe wrote:Кстати, почему вы решили не выделять пункты минусом?
В разделе @KeyMacro было без минусов.

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 15:12
by John Doe
Centaur wrote:в российской типографской традиции, каким-нибудь тире.
Я полностью согласен, только вот смысла нет наводить типографику в одном отдельно взятом разделе. Если кто возьмётся поправить во всей документации - тогда да, будет смысл поддерживать.
DV wrote:В разделе @KeyMacro было без минусов.
Да, но там немного другая ситуация: пункты списка выделены за счёт того что каждый от начала и до конца является ссылкой.
А с минусами (которые на самом деле должны быть тире) примеров тоже достаточно, вот первый попавшийся: @CmdLine

Собственно на минусах я не настаиваю, но тогда надо сделать хотя бы отступ.
И я предлагаю все обороты "См. также:" оформить одинаково. С новой строки, даже если в перечислении всего однин пункт.

А "как было" эталоном служить может не всегда, например было "См. так_же".

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 16:05
by John Doe
1. Патч почему-то не затрагивает раздел @Menus
2. В каждый из разделов @LeftRightMenu @FilesMenu @CmdMenu @OptMenu по-видимому стоит добавить и См. также список ~макроклавиш~@KeyMacroMenuList@, доступных в меню.

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 16:34
by DV
John Doe wrote:1. Патч почему-то не затрагивает раздел @Menus
Потому что @Menus не является "обычным" меню. Я даже не могу сказать, работают ли в нём хоть какие-то клавиатурный комбинации, кроме "горячих" (подсвеченных) букв.
John Doe wrote:2. В каждый из разделов @LeftRightMenu ...
Так они же все ссылаются на @MenuCmd, который, в свою очередь, ссылается на @KeyMacroMenuList.

И вообще, я устал. Патч для справки предложен, и если я что-то упустил, то, как бы, "исходники открыты".

Re: Улучшение файла помощи фара

Posted: Fri 08 Oct, 2010 17:06
by John Doe
DV wrote:Потому что @Menus не является "обычным" меню.
Резон в этом есть, и кстати именно поэтому ссылку на @KeyMacroMenuList тоже надо оттуда переместить в подразделы.
DV wrote:И вообще, я устал.
Теперь вы понимаете почему хелп никто не хочет обновлять :-)
В любом случае, спасибо за то что сделали!

Кто бы теперь аналогичную процедуру проделал для диалогов...

Re: Улучшение файла помощи фара

Posted: Wed 29 Dec, 2010 19:41
by DV
John Doe wrote:Кто бы теперь аналогичную процедуру проделал для диалогов...
Я вот смотрю, что результат моих стараний насчёт Ctrl-Alt-F тихо себе пылится на Мантисе... Не очень воодушевляет это на обновление файла помощи, isn't it? ;)

Re: Улучшение файла помощи фара

Posted: Wed 29 Dec, 2010 19:53
by John Doe
Ну так вы же не захотели его доделывать.
Не вопрос, доделаю я, только торопить не надо.

Re: Улучшение файла помощи фара

Posted: Mon 08 Aug, 2011 21:37
by Maximus5
Есть предложение доработать раздел пометки файлов.

Немного форматирования, раздел про мышку.
А еще, я что-то не понял, к чему было вот это
Если ни один файл не выбран, то будет обработан только файл под курсором.