Скрипты: система их названий и описаний

Здесь обсуждается всё, что касается макросов.
User avatar
John Doe
Бюрократ
Posts: 12204
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 32 times
Been thanked: 162 times

Скрипты (Макросы): Система их названий и описаний

Post by John Doe » Thu 28 Aug, 2014 10:14

Latest post of the previous page:

IgorZ wrote:однозначная привязка компонента к пакету открывает возможность манипулировать пакетом как единым целым.
А как быть с *.cfg, *.lng, и т.п.?
Читать ли прямо из них метаинфоромацию, или помещать её в основной скрипт.
И как быть с модулями, загружаемыми по require?
IgorZ wrote:Хотя, можно пойти старым, проверенным путём и складывать все компоненты скрипта в отдельный подкаталог. Тоже вариант, кстати. И почему-то подумал я о нём только сейчас. Надо обмозговать. Впрочем, один недостаток (общий, кстати, для всех вариантов решений) виден сходу - никто не гарантирует обязательность того, что это будет сделано.
Если мета-информация содержится в самом скрипте, то всё зависит от того, заполнил ли её автор. А станет ли автор это делать зависит от того, что это ему даст.
Наша цель - централизованное управление скриптами.
Поэтому будет общий их список, с общей информацией (описание, домашняя страница), откуда можно вызвать справку, конфигурацию и пр.
Но почти то же самое уже можно сделать с помощью MenuItem, не так ли?

Сверх того можно предложить следующее:
  • возможность интерактивно отключить скрипт (или отдельные составляющие)
  • общие средства для хранения и изменения параметров скрипта, чтобы каждому скрипту не приходилось реализовывать собственный велосипед (http://forum.farmanager.com/viewtopic.p ... 97#p120397).
  • контроль минимальной версии фара
  • в перспективе полное управление пакетами: установка (из архива, или онлайн-репозитория), удаление, обновление.
  • ...что ещё?
IgorZ wrote:Лиха беда начало. Думаю, остальных пока сдерживает отсутствие поддержки "искаропки".
Это факт. И никаких гарантий, что "фкаропке" это когда-либо появится.

Update: продолжение тут: http://forum.farmanager.com/viewtopic.php?f=15&t=10418

Shmuel
Posts: 5711
Joined: Thu 23 Mar, 2006 21:36
Location: Israel
Has thanked: 21 times
Been thanked: 201 times

Re: Скрипты (Макросы): Система их названий и описаний

Post by Shmuel » Thu 28 Aug, 2014 10:21

John Doe wrote:И никаких гарантий, что "фкаропке" это когда-либо появится.
Гарантий нет, вероятность есть.

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

Скрипты: система их названий и описаний

Post by John Doe » Mon 23 Oct, 2017 13:44

В соседней теме были затронуты такие вопросы.
sToLp wrote:
Sun 22 Oct, 2017 10:22
2. Формат стационарных макросов дополнить чем-то типа многострочного опционального поля userinfo, с возможностью оперативного доступа к нему в т.ч. из макробраузеров. Для помещения в это поле зачастую необходимой поясняющей пользовательской информации произвольного содержания, порой весьма объёмной.
http://bugs.farmanager.com/view.php?id=3535#c15737 wrote:В это поле предполагаю помещать поясняющую информацию о предназначении макроса, о том как с ним работать, его адрес на сайте, иногда — облегчающие освоение данного макроса цитаты с обсуждением с сайта, другую инфу и т.п. А поскольку поле будет воспроизводиться макробраузерами, то к нему будет удобный оперативный доступ. Вот примерно так.
Отвечая вкратце.
1. Уже говорилось, что поле description прямо сейчас можно использовать как многострочное, вопрос только в поддержке макробраузерами.
2. Выше по теме обсуждалось, что сложные макросы редко бывают отдельные, чаще это набор макросов, расположенных в одном или даже нескольких файлах. Соответственно большая часть информация будет общей для всех макросов, и будет неправильно размещать её в спецификации каждого макроса.
3. Существует готовое и вполне рабочее решение, помимо прочего предоставляющее возможность задать описание скрипту (пакету скриптов) целиком: ScriptsBrowser — управление скриптами.

Лично у меня в браузере сейчас порядка 40 отдельных скриптов, мои и IgorZ.

User avatar
sToLp
Posts: 938
Joined: Thu 23 Jul, 2009 10:16
Has thanked: 107 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by sToLp » Mon 23 Oct, 2017 15:03

Насчёт использования поля description в качестве многострочного пока ещё только начал осваиваться. Пытаюсь приноровиться. И по результатам доложусь.

Касательно же применения ScriptsBrowser`а на текущий момент лично для себя нахожу это слишком сложным. И дополнительно смущает излишне строгое, имхо, структурирование информации.

На мой взгляд, было бы удобнее иметь доступ из макробраузеров к полю (м.б. к полям), хотя бы в одном из которых можно было бы располагать необходимую дополнительную информацию. Структурированную произвольно по своему усмотрению в зависимости от контекста. Если это технически возможно и не слишком отяготит код Far`а.

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

Скрипты: система их названий и описаний

Post by John Doe » Mon 23 Oct, 2017 15:19

sToLp wrote:
Mon 23 Oct, 2017 15:03
Касательно же применения ScriptsBrowser`а на текущий момент лично для себя нахожу это слишком сложным.
Что именно? Установка ScriptBrowser?
Потому что касательно использования всё может быть вполне прозрачно: в макробраузере на макросе нажимаете CtrlS, и видите всю информацию.
(Сейчас этого нет только потому, что я сто лет не обновлял Macro Browser alt)
sToLp wrote:
Mon 23 Oct, 2017 15:03
И дополнительно смущает излишне строгое, имхо, структурирование информации.
Например?
sToLp wrote:
Mon 23 Oct, 2017 15:03
На мой взгляд, было бы удобнее иметь доступ из макробраузеров к полю (м.б. к полям), хотя бы в одном из которых можно было бы располагать необходимую дополнительную информацию.
Я не думаю, что отображать в макроброузере все поля внутренней таблицы макроса это хорошая идея. А значит надо конкретизировать, какие конкретно поля вы хотите, для какой именно информации, и как она должна быть отображена в браузере (то ли прямо в списке, то ли сообщением по особому хоткею, ...).

User avatar
sToLp
Posts: 938
Joined: Thu 23 Jul, 2009 10:16
Has thanked: 107 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by sToLp » Mon 23 Oct, 2017 15:59

John Doe wrote:
Mon 23 Oct, 2017 15:19
sToLp wrote:
Mon 23 Oct, 2017 15:03
Касательно же применения ScriptsBrowser`а на текущий момент лично для себя нахожу это слишком сложным.
Что именно? Установка ScriptBrowser?
Не сама, конечно, установка. А необходимость с одними макросами обращаться к Macro Browser alt, а с другими — к ScriptBrowser. При интенсивной работе такой, казалось бы простой, выбор, как минимум, напрягает. Иногда, — до неприемлемости. По этой же причине в подавляющем большинстве случаев у меня применяется Macro Browser alt, а не нативный Macro Browser.

John Doe wrote:
Mon 23 Oct, 2017 15:19
(Сейчас этого нет только потому, что я сто лет не обновлял Macro Browser alt)
Лично я приветствовал бы перенесение функциональности ScriptBrowser`а в Macro Browser alt.

John Doe wrote:
Mon 23 Oct, 2017 15:19
sToLp wrote:
Mon 23 Oct, 2017 15:03
И дополнительно смущает излишне строгое, имхо, структурирование информации.
Например?
Вот был приведён под спойлером. И, насколько я понял, это ведь дополнительно к уже имеющей место структуризации, и ещё не предел.

John Doe wrote:
Mon 23 Oct, 2017 15:19
sToLp wrote:
Mon 23 Oct, 2017 15:03
На мой взгляд, было бы удобнее иметь доступ из макробраузеров к полю (м.б. к полям), хотя бы в одном из которых можно было бы располагать необходимую дополнительную информацию.
Я не думаю, что отображать в макроброузере все поля внутренней таблицы макроса это хорошая идея. А значит надо конкретизировать, какие конкретно поля вы хотите, для какой именно информации, и как она должна быть отображена в браузере (то ли прямо в списке, то ли сообщением по особому хоткею, ...).
Разумеется, все поля отображать не надо. А только с кратким содержанием типа область, ключи, частично — описание (description), и, кажется, что-то ещё помаленьку. А остальные — особым вызовом. Да, ведь, в Macro Browser alt с этим, кажется, всё в порядке.

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

Скрипты: система их названий и описаний

Post by John Doe » Mon 23 Oct, 2017 16:46

sToLp wrote:
Mon 23 Oct, 2017 15:59
Лично я приветствовал бы перенесение функциональности ScriptBrowser`а в Macro Browser alt.
Предполагается не перенесение, а скорее взаимное использование.
sToLp wrote:
Mon 23 Oct, 2017 15:59
Вот был приведён
А вы не там смотрите.
В шапке прямо над спойлером сказано: Все поля на данный момент опциональны
И кроме перечисленных свободно можно использовать и другие поля.

В общем, насколько я могу судить, чтобы покрыть заявленные вами потребности не хватает только вызова из макробраузера.

User avatar
sToLp
Posts: 938
Joined: Thu 23 Jul, 2009 10:16
Has thanked: 107 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by sToLp » Mon 23 Oct, 2017 17:31

John Doe wrote:
Mon 23 Oct, 2017 16:46
чтобы покрыть заявленные вами потребности не хватает только вызова из макробраузера
Да, пожалуй. Недостаёт именно возможности вызова одного многострочного поля. Информацию в которое пользователь помещает на своё усмотрение. Произвольного объёма и произвольной структуры. Иногда, м.б. и такую, как в выше приведённом примере, а в другой раз — совсем иную и по содержанию, и по форме.

User avatar
SUSim
Posts: 1520
Joined: Thu 18 Feb, 2010 17:32
Has thanked: 5 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by SUSim » Tue 24 Oct, 2017 19:23

Вы тут абстрактность обсуждение!! ИМХО КОНЕЧНО!
Заставить автора писать пояснения НЕ возможно. Даже Вы, John Doe, ограничиваетесь ссылкой на форум! (Я тоже, не пишу разъяснения).
И приходится шарить по форумам и копировать инфу и дополнительные файлы (что не всегда возможно), чтобы опробовать новый макрос, а не просто скопировать/распоковать - восхититься :)
К плагинам относились серьёзнее и комментарии писали и хелп делали! этого ни кто этого делать не заставлял...
Last edited by SUSim on Tue 24 Oct, 2017 19:29, edited 3 times in total.
SimSU ··· ·· -- ··· ··-

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

Скрипты: система их названий и описаний

Post by John Doe » Tue 24 Oct, 2017 19:55

SUSim wrote:
Tue 24 Oct, 2017 19:23
Заставить автора писать пояснения НЕ возможно. Даже Вы, John Doe, ограничиваетесь ссылкой на форум!
Зачем же его заставлять)
А вот предоставить возможность — необходимо.

Ссылка на форум это самый минимум, да.
SUSim wrote:
Tue 24 Oct, 2017 19:23
К плагинам относились серьёзнее и комментарии писали и хелп делали! этого ни кто этого делать не заставлял...
И к макросам можно относится серьёзно, и хелп писать, кто не даёт?

User avatar
SUSim
Posts: 1520
Joined: Thu 18 Feb, 2010 17:32
Has thanked: 5 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by SUSim » Tue 24 Oct, 2017 20:17

Минимум должен быть - скопировать, распаковать и попробовать, даже хоть методом тыка... А не искать ещё чтото, или это должно быть в коробке или в системе или в описании, а не в ссылках (чулках :ha: это мне автодополнение Гугла поправило первоначально).
Но это не по теме все... А дополнительное поле информации это надо!
Last edited by SUSim on Tue 24 Oct, 2017 20:22, edited 1 time in total.
SimSU ··· ·· -- ··· ··-

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

Скрипты: система их названий и описаний

Post by John Doe » Tue 24 Oct, 2017 20:23

Согласен. В свои постепенно добавляю

IgorZ
Posts: 593
Joined: Wed 13 Jul, 2011 03:32
Has thanked: 9 times
Been thanked: 36 times

Скрипты: система их названий и описаний

Post by IgorZ » Wed 25 Oct, 2017 06:31

А тем временем в замке у шефа...
LuaManager теперь умеет показывать многострочные описания
sToLp, пробуйте. В дистрибутиве лежит test multiline description.lua, в качестве примера.

User avatar
sToLp
Posts: 938
Joined: Thu 23 Jul, 2009 10:16
Has thanked: 107 times
Been thanked: 8 times

Скрипты: система их названий и описаний

Post by sToLp » Wed 25 Oct, 2017 09:11

IgorZ wrote:
Wed 25 Oct, 2017 06:31
LuaManager теперь умеет показывать многострочные описания
sToLp, пробуйте. В дистрибутиве лежит test multiline description.lua, в качестве примера.
Спасибо! Попробовал.
И очень даже хорошо получается.
Только пока что меню выбора макросов к этому не вполне приспособлено. Тем, что в строку макроса выводится всё содержание поля description, а не только его первая строка. И получается . Но это, как я понимаю, со временем может быть поправлено.

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

Скрипты: система их названий и описаний

Post by John Doe » Wed 25 Oct, 2017 10:45

sToLp wrote:
Wed 25 Oct, 2017 09:11
Но это, как я понимаю, со временем может быть поправлено.
Разумно было бы (при необходимости однострочного вывода) обрезать строку после первого перевода.
Ещё не смотрел реализацию в LuaManager, но поскольку многострочные описания не всегда нужны, то и отображение их удобнее иметь режимом.

Code: Select all

Максимальная длина полей описаний. Допустимые значения:
  =0  - Ширина поля описаний равна длине самого длинного описания. Текст описания скрипта и список
        клавиш всегда размещается в одну строку. Многострочные описания выводятся в одну строку.
Вот тут например не очень логично.
Last edited by John Doe on Wed 25 Oct, 2017 10:59, edited 1 time in total.

IgorZ
Posts: 593
Joined: Wed 13 Jul, 2011 03:32
Has thanked: 9 times
Been thanked: 36 times

Скрипты: система их названий и описаний

Post by IgorZ » Wed 25 Oct, 2017 11:12

John Doe wrote:
Wed 25 Oct, 2017 10:45
Разумно было бы (при необходимости однострочного вывода) обрезать строку после первого перевода.
Ещё не смотрел реализацию в LuaManager, но поскольку многострочные описания не всегда нужны, то и отображение их удобнее иметь режимом.

Code: Select all

Максимальная длина полей описаний. Допустимые значения:
  =0  - Ширина поля описаний равна длине самого длинного описания. Текст описания скрипта и список
        клавиш всегда размещается в одну строку. Многострочные описания выводятся в одну строку.
Вот тут например не очень логично.
Так логично?

Code: Select all

<0  - Ширина поля описаний в символах. Если содержимое не вмещается, остаток обрезается.
      У многострочных описаний выводится только первая строка.

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

Скрипты: система их названий и описаний

Post by John Doe » Wed 25 Oct, 2017 11:24

IgorZ wrote:
Wed 25 Oct, 2017 11:12
Так логично?
Ну.. не совсем.
Я бы предпочёл, чтобы многострочные описания обрабатывались независимо он настроек ширины.
И все правила (в частности и "<0") применялись бы для каждой строки отдельно.

Post Reply

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