Энциклопедия: улучшение раздела о макросах

Здесь обсуждается всё, что касается макросов.
Игорь Юдинцев
Posts: 726
Joined: Sun 03 Apr, 2005 22:00
Location: Казань
Been thanked: 2 times

Re: Энциклопедия: улучшение раздела о макросах

Post by Игорь Юдинцев »

Latest post of the previous page:

Raistlin wrote:О, вот еще суперпринципиальный вопрос. Far или FAR?
Наверное, FAR — аббревиатура всё-таки.
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

"Попутно", естественно, такие вещи не трогаются, но вообще в конце концов надо бы привести к единому виду.

FAR = FAR After Roshal? :)
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:"Попутно", естественно, такие вещи не трогаются
Попутно вообще ничего не надо трогать. Только типографику и пунктуацию (по минимуму).

По минимуму потому что там кое-чего стоит несколько переформулировать, но это уже совсем другая задача.

P.S.
Кстати есть такой документ: HACKING-RU.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:Что значит - не надо? Я, следуя Писанию, создал макрос, который обрабатывает файлы SetACL'ом. Проверяю "файловость" значением флага. И получаю ерунду.

Не "именами реальных файлов", а "объектами файловой системы, NetBIOS-именами, именами разделяемых сетевых ресурсов". Да, тупо перечисление, если кто не придумает лучшего пояснения. Может, еще что забыл...
Нет необходимости в длинном перечислении, достаточно добавить пояснение насчёт сетевой панели (в виде комментария).

P.S.
Но я по прежнему утверждаю что "запрошенная операция не поддерживается плагином" это крайне неудачная формулировка.
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

John Doe wrote:Нет необходимости в длинном перечислении, достаточно добавить пояснение насчёт сетевой панели (в виде комментария).
Пояснение про конкретный плагин не лучше, чем перечисление. Последнее, по крайней мере, охватывает всю совокупность объектов. А ведь не исключено появление еще одного плагина, который будет работать с шарами и тоже выставлять этот флаг. С другой стороны, файлы на FTP тоже вроде как реальные, но флаг FTP-плагин не выставляет.
Кстати, FTP-плагин вообще не проглатывает "macro:post" (однако через хоткей макрос запустить можно). Баг? Far Navigator на "macro:post" реагирует нормально.
John Doe wrote:Но я по прежнему утверждаю что "запрошенная операция не поддерживается плагином" это крайне неудачная формулировка.
Есть операции для объектов, выполнение которых плагин берет на себя; если запрошенная операция к ним не относится, плагин передает бразды правления Far'у, а тот непосредственно может работать только... ну, понятно с чем. Это имеется в виду?
Magically yours
Raistlin
User avatar
DrKnS
Posts: 6114
Joined: Thu 04 Aug, 2005 06:44
Location: Kyiv
Has thanked: 12 times
Been thanked: 426 times

Re: Энциклопедия: улучшение раздела о макросах

Post by DrKnS »

Raistlin wrote:Что значит - не надо? Я, следуя Писанию, создал макрос, который обрабатывает файлы SetACL'ом. Проверяю "файловость" значением флага. И получаю ерунду.

Не "именами реальных файлов", а "объектами файловой системы, NetBIOS-именами, именами разделяемых сетевых ресурсов". Да, тупо перечисление, если кто не придумает лучшего пояснения. Может, еще что забыл...
То и значит, что если есть флаг, то на панели - реальные файлы и папки, к которым применимы встроенные (а не плагиновые) операции копирования, переноса, удаления и т. п.
NetBIOS-имена и имена разделяемых сетевых ресурсов таковыми не являются.
Нетворк плагин - частный случай, только для создания ссылок, и только потому, что в висте появилась поддержка ссылок на шары.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Raistlin wrote:Это имеется в виду?
Что имеется ввиду понятно, просто формулировка не вполне удачная: "операция не поддерживается плагином" выглядит как сообщение об ошибке.
Kildor
Posts: 1515
Joined: Wed 16 Mar, 2005 06:26
Location: Новосибирск
Been thanked: 1 time
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by Kildor »

Господа, а как мне увидеть список всех функций макроязыка? Раньше это было легко и непринуждённо, сейчас надо думать, где может находиться та или иная функция.
Ты мне не выкай!
«ФарФорум не для пользователей!»
Upd:
P.S. Я просто поддерживаю беседу.» © Народ.

xmpp:kildor@jabber.ru
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Энциклопедия: улучшение раздела о макросах

Post by Skirda »

наверное нужен краткий индекс по алфавиту со ссылками на соответствующие темы
We are the Borg. You will be assimilated.
So Say We All!
User avatar
Raistlin
Posts: 750
Joined: Wed 16 Mar, 2005 16:01
Has thanked: 3 times
Been thanked: 1 time

Re: Энциклопедия: улучшение раздела о макросах

Post by Raistlin »

Да, неплохо бы.
Magically yours
Raistlin
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Добавлю, что в идеале индекс должен генерироваться автоматически, как это и делается сейчас для chm.
А совсем в идеале это чтобы индекс был тематическим.
Max Rusov
Posts: 3651
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Has thanked: 2 times
Been thanked: 19 times

Re: Энциклопедия: улучшение раздела о макросах

Post by Max Rusov »

Еще можно попросить в online версии энциклопедии улучшить поиск?

Хотелось бы:
1. Возможность поиска на любой странице, чтобы не надо было выходить в корень.
2. Если я в разделе по FAR2, то и поиск чтобы шел только по этому разделу.
3. Ну и что-то там переиндексировать надо, наверное, а то сейчас поиск выдает неправильные результаты:
Ищем: MsgBox. 2 первые ссылки - битые.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Ещё хотелось бы поиск через http://api.farmanager.com/ru2/?string, и чтобы при наличии точного соответствия сразу открывалось бы нужное.
Плюсы:
  • Получаем простую возможность в обсуждении указать сразу нужное место Энциклопедии (сейчас приходится предварительно порыться).
  • Как показывает практика, абсолютные ссылки сейчас изменчивы, и после недавних изменений многие ссылки на форуме ведут в никуда.
  • Большинство ссылок в исходнике Энциклопедии тоже можно переделать с учётом этого механизма, это позволит проще ссылаться на существующие топики (не нужно знать точный адрес). А при реорганизации страниц не придётся беспокоится о правке ссылок.
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Раздел макросов это очень обособленный раздел, который в отличии от всей остальной Энцикопедии адресован простым смертным.
Предлагаю в "шапке" форума разделить "Plugins API" и "Macros".
User avatar
Skirda
Posts: 3475
Joined: Wed 16 Mar, 2005 11:01
Been thanked: 8 times

Re: Энциклопедия: улучшение раздела о макросах

Post by Skirda »

1. поисковик гугловский - отсюда и...
1.1 можно переделать скрипты так, чтобы на каждую страницу онлайн-писания вставлялся бы скрипт поисковика...
2. свой писать - а надо ли?
3. можно в принципе разделить апи и макросы, но я изначально хотел, чтобы Писание рассматривалось не просто как Help по апи... а нечто большее.
4. автоматический индекс - ХЗ, можно сделать.
We are the Borg. You will be assimilated.
So Say We All!
User avatar
John Doe
Бюрократ
Posts: 13807
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 73 times
Been thanked: 426 times
Contact:

Re: Энциклопедия: улучшение раздела о макросах

Post by John Doe »

Skirda wrote:2. свой писать - а надо ли?
Свой писать не надо. По крайней мере то о чём писал я предполагает поиск только по существующему индексу.
Skirda wrote:3. можно в принципе разделить апи и макросы, но я изначально хотел, чтобы Писание рассматривалось не просто как Help по апи... а нечто большее.
Ну совсем разделять не надо. Только лишь добавить отдельную ссылку для быстрого попадания в раздел макросов.
Skirda wrote:4. автоматический индекс - ХЗ, можно сделать.
Он как бы почти есть, строится для chm.
Post Reply

Return to “Обсуждение макросов”