Плагин входит в дистрибутив Far Manager с v3.0.2948 (старые версии доступны тут)
Опционально плагин способен отображать текст в RGB режиме, и используя разные стили (bold/italic/underlined).
Этот режим называется TrueMod, для его работы в FAR 3 требуются специальный эмулятор консоли: Conemu.
Скриншоты можно глянуть странице проекта (актуальны только изображения, а описание немного устарело, в частности Console2 больше не поддерживается).
В настройках плагина указать путь к файлу: 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), то достаточно прототипа (location схемы можно не указывать).
Как правильно "удалить" какую-либо стандартную схему
Чтобы какая-либо из стандартных схем исчезла из меню, надо в пользовательском файле прототипов "переделать" схему в пакет с тем же именем (name), например:
Кроме имени важно также сохранить значение location, потому как даже если эта схема вам не нужна, но от неё могут зависеть другие, нужные вам.
Как использовать относительные пути и переменные окружения
В настройках плагина при указании пути к catalog.xml удобно использовать переменные окружения, такие как %FARHOME%, %FARPROFILE%.
Переменные можно использовать и в самом файле catalog.xml, и в определениях прототипов.
Кроме того поддерживаются относительные пути во всех hrc файлах (путь вычисляется относительно файла, в котором он указан). Внимание: в пользовательском файле цветовых стилей (hrd) пути вычисляются относительно catalog.xml
Если раскраска неправильна:
В первую очередь нужно убедиться что тип файла определён верно (F11/FarColorer/List types).
В случае если определился не тот тип, что требуется, можно выбрать из списка более подходящий.
Или же переопределить типы, подкорректировав "условия срабатывания" схемы, заданные в атрибутах <filename> и/или <firstline>.
Часто достаточно подкорректировать атрибут weight='2', изменив умолчательное значение (2) в ту или иную сторону.
Не рекомендуется редактировать штатные прототипы и схемы, т.к. при обновлении изменения потеряются.
Как правильно переопределить схемы описано в других пунктах данного FAQ
слово local имеет разный цвет в первой и второй строке, даже когда курсор не находится на любой из этих строк.
far 3.0.3895 x86.
Скачал и установил Far30b3895.x86.20140512.7z (только со стандартными плагинами, FarColorer со стандартными схемами), в обоих файлах строки раскрашиваются нормально независимо от позиции курсора.
оказывается, это у меня настройки колорера давали такой эффект, с каких-то времён осталось.
сбросил все настройки - всё стало хорошо =) спасибо за помощь.
, раскрашивающий скрипты по заголовкам в *.tmp файлах (из полей диалогов по F4), кладётся в папку Auto. Как в location link указать относительный путь к выше лежащему common.jar?
Например,
приходит EE_READ, editorSet==nullptr, зовётся FarEditorSet(), зовётся ReloadBase, SetBgEditor, ACTL_SETARRAYCOLOR. последнее приводит к перерисовке всех окон и вызову ProcessEditorEventW, editorSet всё ещё nullptr. и всё повторяется по кругу.
"M2 \" подсвечено как ошибка колорером. Я не знаток мейкфайлов. Это действительно кривой синтаксис или схема недостаточно гибкая? Если комментарии убрать, то красится без ошибок.
(В одном проекте тут навалом таких мейкфайлов, в глазах рябит от ошибок раскраски. И комментарии нужны согласно соглашениям в проекте.)
Собственные настройки (схемы и стили) плагина располагаются отдельно от %FARHOME% и %FARPROFILE% в каталоге %FARPROFILE%/../FarColorer/.
Файл списка схем %FARPROFILE%/../FarColorer/hrc/proto.hrc. Пути до моих схем могу указывать относительно этого файла. Все работает.
Файл цветовых стилей %FARPROFILE%/../FarColorer/hrd/catalog.xml. Пути до моих стилей надо указывать абсолютные, то есть %FARPROFILE%/../FarColorer/hrd/имя-файла-стиля. Иначе стили не подключаются.
Подскажите, пожалуйста, это баг или я что-то упустил при настройке плагина.
Плагин из стабильных сборок (в других - не знаю, так как до этого свои схемы/стили не выносил в отдельный каталог)
Сущности в данном случае бесполезны - они указывают всего лишь на имя подкаталога (hrc или hrd). А плагин рассматривает их относительно %FARHOME%/Plugins/FarColorer/base. Идея в том, чтобы вынести собственные настройки за пределы каталога %FARHOME%. Просто в случае с hrc можно указать имя файла схемы отностиельно файла списка схем, а в случае hrd - надо указывать полный путь до файла стиля.
Немного переделал, чтобы не вносить путаницу между стандартными и собственными каталогами hrc/hrd. Но проблема остается.
FAR лежит в каталоге %FARHOME%. Стандартные плагины, установленные "из коробки" лежат там же - %FARHOME%/Plugins.
Все, что доустановлено в FAR мной лично, лежит в отдельном каталоге в %FARPROFILE%.
Мои настройки для FarColorer лежат рядом - %FARPROFILE%/../FarColorer.
. Мои стили лежат в подкаталоге styles. Я не могу написать относительный путь <location link="styles/gentle-console.hrd">. Colorer не увидит файл стилей.
Сейчас колорер ожидает путь относительно catalog.xml, а путь к нему вы не настраивали.
То о чём вы говорите тоже понятно, посмотрим что ответит автор.
Сейчас же вы можете попробовать прямо в своём styles.xml определить новую сущность. <!ENTITY myhrc "%FARPROFILE%/../FarColorer/styles">.
И использовать её в дальнейших определениях.
Да. Путь до catalog.xml я не настраивал. Но схемы загружаются, стили - нет. Сущности не работают - при открытии редактора выдает ошибку парсинга styles.xml
После билда 4040 при наличии плагина TrueTemplate (актуальная версия с PlugRing для FAR3) на чистом профиле и стандартных конфигах TrueTemplate и Colorer, в настройках Colorer ставим "[x] Change Editor background", во время открытия любого файла на редактирование падаем с трап-логом