Правила раздела

Здесь выкладываются готовые к использованию макросы и скрипты.
Post Reply
User avatar
John Doe
Бюрократ
Posts: 11391
Joined: Wed 27 Apr, 2005 20:42
Has thanked: 17 times
Been thanked: 101 times

Правила раздела

Post by John Doe » Wed 03 Apr, 2013 17:33

В данном разделе собраны макросы и скрипты, готовые к использованию.
(Далее по тексту "макросы и скрипты" не разделяются, используется общее название "скрипт")

Любой скрипт может быть опубликован в этом разделе, при соблюдении следующих условий:
  • Скрипт работоспособен в актуальной версии FAR.
    Рекомендуется указывать минимальную требуемую версию.
  • Первое сообщение темы (шапка) оформлено надлежащим образом.
    1. Содержит последнюю версию скрипта либо ссылку на неё.
      Рекомендуется как-то отмечать версию (номером или датой), при обновлении можно делать анонс в теме.
    2. Имеется чёткое описание, в котором указаны функции скрипта, способ запуска (клавиши назначения), особенности реализации.
      Объёмный текст рекомендуется убирать в спойлеры, но краткое описание должно присутствовать открыто.
    3. Если позволяет объём, то желательно привести полный текст в теге [code], под спойлером ([spoiler]).
      Если скрипт объёмный и/или представляет собой набор файлов, то для удобства пользователей стоит упаковать в архив и вложить в сообщение (данная рекомендация не распространяется на скрипты, размещённые на собственных сайтах)
    4. Шапка темы повторяется на каждой странице, поэтому стоит делать её компактной.
  • Необходимо указать зависимости.
    • Если скрипт зависит от компонентов, не входящих в дистрибутив FAR (например LuaFAR for Editor, MacroLib, PowerShellFar), то необходимо их перечислить, указать требуемые версии, и дать ссылки для скачивания.
    • То же касается скриптов, запускаемых посредством внешних программ-интерпретаторов (например Perl, Python, Tcl, Lua).
    • Зависимость необходимо отразить в заголовке, это облегчит поиск (примеры: MoonScript, lf4ed, FML, PSF, Perl, Python).
      Рекомендуется делать это с помощью префикса, в квадратных скобках (примеры по ссылкам выше).
Важно:
Создание новых тем в разделе запрещено.
Наполнение раздела производится модераторами путём переноса подходящих тем из раздела Обсуждение макросов.

Post Reply

Return to “Полезные макросы и скрипты”