Плагин входит в дистрибутив Far Manager с v3.0.2948 (старые версии доступны тут) Поддержка Windows XP
Начиная с версии FarColorer 1.4.0 в плагине прекращена поддержка Windows XP. Полностью поддерживается и тестируется на Windows 10. Несколько версий Windows назад - по запросу. Но кажется, что всегда должно работать начиная с Windows 2008.
Far Manager 3.0.5797 (2021.05.10) и более новые в дистрибутиве содержат FarColorer версии 1.4.
Поддержка Windows XP осталась только на FarColorer 1.3.x. В данной ветке будут выходить только критичные исправления. Скачать можно на GitHub странице плагина. Последняя версия 1.3.30
Опционально плагин способен отображать текст в RGB режиме, и используя разные стили (bold/italic/underlined).
Этот режим называется TrueMod, для его работы в FAR 3 требуются специальный эмулятор консоли: Conemu.
Скриншоты можно глянуть странице проекта (актуальны только изображения, а описание немного устарело, в частности Console2 больше не поддерживается).
Или подключить пользовательские *.hrd в пользовательском catalog.xml
Внимание: в пользовательском файле цветовых стилей пути вычисляются относительно catalog.xml
В настройках плагина указать путь к файлу: Users file of schemes.
(Структура файла аналогична hrc\proto.hrc)
используя папку auto:
Два варианта:
Cоздать свой аналог proto.hrc и прописать туда прототипы, а в папку types положить сами схемы.
Минимальный (пустой) пример файла прототипов есть в дистрибутиве: auto/empty.hrc.
Внимание:empty.hrc служит для примера, изменять его не рекомендуется, т.к. при обновлении изменения потеряются.
Можно обойтись без отдельного файла прототипов, а разместить схемы непосредственно в папке auto.
Прототип в этом случае должен быть определён в самой схеме после тега <hrc>, без указания location
через пользовательский catalog.xml:
Вместо штатного base/catalog.xml можно использовать свой файл, указав путь к нему в настройках плагина.
В своём каталоге можно указать откуда загружать пользовательские прототипы и схемы.
Чтобы переопределять дистрибутивные схемы собственными надо пользовательский файл прототипов подключать после штатного proto.hrc:
Также в catalog.xml можно добавить пользовательские цветовые стили, см. <hrd-sets>
Как переопределить существующую схему
Для этого достаточно подключить собственную схему с тем же именем (name).
Если требуется изменить только параметры схемы (filename, firstline, parameters), то достаточно прототипа, как он указан в common.zip!hrc/proto.hrc. location схемы при этом нужно указать примерно так (для hrc-файла, находящегося в папке FarColorer\base\auto):
Как правильно "удалить" какую-либо стандартную схему
Чтобы какая-либо из стандартных схем исчезла из меню, надо в пользовательском файле прототипов "переделать" схему в пакет с тем же именем (name), например:
Кроме имени важно также сохранить значение location, потому как даже если эта схема вам не нужна, но от неё могут зависеть другие, нужные вам.
Как использовать относительные пути и переменные окружения
В настройках плагина при указании пути к catalog.xml удобно использовать переменные окружения, такие как %FARHOME%, %FARPROFILE%.
Переменные можно использовать и в самом файле catalog.xml, и в определениях прототипов.
Кроме того поддерживаются относительные пути во всех hrc файлах (путь вычисляется относительно файла, в котором он указан). Внимание: в пользовательском файле цветовых стилей (hrd) пути вычисляются относительно catalog.xml
Если раскраска неправильна:
В первую очередь нужно убедиться что тип файла определён верно (F11/FarColorer/List types).
В случае если определился не тот тип, что требуется, можно выбрать из списка более подходящий.
Или же переопределить типы, подкорректировав "условия срабатывания" схемы, заданные в атрибутах <filename> и/или <firstline>.
Часто достаточно подкорректировать атрибут weight='2', изменив умолчательное значение (2) в ту или иную сторону.
Не рекомендуется редактировать штатные прототипы и схемы, т.к. при обновлении изменения потеряются.
Как правильно переопределить схемы описано в других пунктах данного FAQ
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 01:04
by tvel
onokonem, так будет работать, это переопределение прототипа.
Но если оригинальный прототип json изменится, например баланс весов поправят, (маловероятно конечно),
то ваш прототип может сломать этот баланс.
Как не ломать определение json, создавая новую "сущность" avpr с наследованием типа, пример ("textd") есть выше, John Doe прав - определяете прототип name="avpr", значит нужно опеределять и тип+схему "avpr".
Очевидно, у вас заявка на то что файлы с расширением .avpr являются типом json,
значит правка нужна оригинала прототипа авторами плагина.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 14:10
by Maximus5
Предлагаю добавить в "Diff/Patch" определение коммитов гита.
<prototype name="diff" group="other" description="Diff/Patch">
<location link="jar:common.jar!misc/diff.hrc"/>
<filename>/\.(diff.*|patch|rej(ect)?)$/i</filename>
<firstline weight='2'>/^(diff|Index|---|\+\+\+|\*\*\*)/si</firstline>
<firstline weight='2'>/^((commit)\s+(\w+))/si</firstline>
<firstline>/^(\d+,\d+\w\d+ | \d+\w\d+)/i</firstline>
<firstline>/^cvs/i</firstline>
<parameters>
<param name="trailing-space" value="false" description="Mark trailing spaces as errors"/>
<param name="space-before-tab" value="false" description="Mark leading spaces before tabs as errors"/>
<param name="indent-with-non-tab" value="false" description="Mark 8 or more leading spaces as errors"/>
<param name="indent-with-tab" value="false" description="Mark leading tabs as errors"/>
</parameters>
</prototype>
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 14:32
by Maximus5
А как правильно/проще назначить для конкретного типа другую цветовую схему?
Я хочу, чтобы диффы отображались на черном фоне (так же как делает "git diff"),
хотя основная схема у меня со светлым фоном.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 14:38
by John Doe
Проще всего поместить файл переопределяющий схему в папку auto.
В шапке есть и другие способы.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 16:55
by Maximus5
OK, спрошу по другому. В auto есть переопределенный тип.
Как сделать так, чтобы для него работала схема "Black (scarlet)" место основной "Visual by Roman Kuzmin"?
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 17:02
by Maximus5
BTW, имеет место
2014-09-18_19-57-24.png (21.21 KiB) Viewed 6427 times
и несимпатичное положение списка типов (F11 FarColorer 1). Нижняя рамка меню упирается в нижний край консоли.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Thu 18 Sep, 2014 19:39
by John Doe
А, вы о цветовых схемах.
Не думаю что сейчас существует такая возможность.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Fri 19 Sep, 2014 08:06
by tvel
Maximus5 wrote:Как сделать так, чтобы для него работала схема "Black (scarlet)" место основной "Visual by Roman Kuzmin"?
Можно создать свой стиль HRD на основе основной "Visual by Roman Kuzmin" с дополнениями "Black (scarlet)",
где по правилам "Black (scarlet)" будут краситься только типы специфичные для diff:
Для HRC это разные регионы, HRD их сопоставит с parent= только если они не определены.
Но к сожалению общий фон текста (и прочие не учтённые в diff элементы) как в "Black (scarlet)" работать не будут,
так схема diff сделана - фон принудительно в ней не красится и набор собственных регионов невелик.
Может запросить у авторов хоткей для смены стиля, или что лучше - добавить пункт "стиль" в "Настройка параметров схем".
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Fri 19 Sep, 2014 08:56
by Maximus5
То ли плагин поломали, то ли шапка устарела. Пытаюсь задать поле "Users file of color styles" в настройке. Получаю невразумительное: