Плагин входит в дистрибутив 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
Это связано с тем, что в lua есть отдельная конструкция do-end.
Можно попробовать так: переключиться на отдельную схему, в которой и обработать по отдельности for/while-do и do-end.
╔════════════════════════ Error ════════════════════════╗
║ This plugin requires more recent version of Far ║
║ C:\Program Files\Far3\Plugins\Colorer\bin\colorer.dll ║
║ Required Far version is 3.0.0.2328. ║
║ Current Far version is 3.0.0.2311. ║
╟───────────────────────────────────────────────────────╢
На всякий случай спрошу - это так и задумано или, как нередко с версиями бывает, "ложная тревога"? (Фар я конечно обновлю - завтра, ибо там сейчас 2325).
Colorer только что взятый последний для Фар 3.
NightRoman wrote:
На всякий случай спрошу - это так и задумано или, как нередко с версиями бывает, "ложная тревога"? (Фар я конечно обновлю - завтра, ибо там сейчас 2325).
Colorer только что взятый последний для Фар 3.
в коде написано брать версию api, с которой компилировался плагин. я брал последнюю версию хедеров. поскольку это первая релизная версия под far3, то оставлю как есть , хоть и не бвло влияющих на плагин изменений с последней беты
на будущее буду учитывать этот момент.
NightRoman wrote:
На всякий случай спрошу - это так и задумано или, как нередко с версиями бывает, "ложная тревога"? (Фар я конечно обновлю - завтра, ибо там сейчас 2325).
Colorer только что взятый последний для Фар 3.
в коде написано брать версию api, с которой компилировался плагин. я брал последнюю версию хедеров. поскольку это первая релизная версия под far3, то оставлю как есть , хоть и не бвло влияющих на плагин изменений с последней беты
на будущее буду учитывать этот момент.
хм, а где-то есть хидеры с завышенным номером версии?
Colorer tends to color my XML files as if they were invalid. But as far as I can tell, the XML files are valid. I downloaded the latest Colorer version, made sure I am using the default syntax description files, and I am still getting just about every XML element marked as invalid. I uploaded a demo XML file (8 lines) here: http://tmp.pepak.net/colorer-demo.zip
It's because it is treated as "Ant's build.xml" (see the type list). If you select XML from the list then all is OK. I would not say it is a bug. You either should correct your Colorer settings files (prototypes) or not use conflicting XML tag names (if this is an option for you).