Плагин входит в дистрибутив 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: Sun 22 Dec, 2013 18:48
by Kanareyka
Latest post of the previous page:
HaRT wrote:
Kanareyka wrote:Вот оттуда заработало. Это для рабочего варианта сгодится, но это же невозможно отлаживать будет -
каждый раз Far закрывать придется после изменения.
Это не так — у плагина есть команда перечитать конфигурацию раскраски.
Но без залезания в архив удобнее, признаю. Гляньте тут и вокруг.
Неа, не в "перечитать конфигурацию" проблема Я не могу изменить сам jar - он заблокирован, пока фар открыт.
В auto я уже пыталась класть файл и в proto.hrc писать путь "hrc/auto/oeabl.hrc". Пока не добилась успеха. Попробую еще пару раз повнимательнее, но не очень верю, что получится. Пыталась и в сам hrc класть файл, и в hrc/auto/types - ничего из этого не сработало...
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Sun 22 Dec, 2013 18:51
by Kanareyka
HaRT wrote:
Kanareyka wrote:Вот оттуда заработало. Это для рабочего варианта сгодится, но это же невозможно отлаживать будет -
каждый раз Far закрывать придется после изменения.
Это не так — у плагина есть команда перечитать конфигурацию раскраски.
Но без залезания в архив удобнее, признаю. Гляньте тут и вокруг.
А не дадите пример тега prototype для proto.hrc с отдельнолежащим файлом? Такой, что у кого-то точно работает.
Может я слеши в пути не в ту сторону написала или еще чего? Я уже и полный путь к файлу пробовала писать,
и в catalog.xml добавлять auto/type...
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Sun 22 Dec, 2013 18:57
by HaRT
Kanareyka wrote:Я не могу изменить сам jar - он заблокирован, пока фар открыт.
Это что-то новенькое. У меня-то версия Колорера уже весьма почтенная.
Kanareyka wrote:В auto я уже пыталась класть файл и в proto.hrc писать путь "hrc/auto/oeabl.hrc". Пока не добилась успеха.
, и всё подхватывается. Но может за последние годы сломали что…
И настоятельно рекомендую почитать про proto_user.hrc.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Sun 22 Dec, 2013 19:30
by Kanareyka
HaRT wrote:И настоятельно рекомендую почитать про proto_user.hrc.
Странно, я все так же писала, как у Вас в примере. "hrc/auto/oeabl.hrc" - это опечатка. Вот так, конечно: "auto/oeabl.hrc".
А не расскажете, где про proto_user.hrc почитать? Поиск в гугле и в яндексе дает только пару постов на этом же форуме, и то там просто упоминание. Поняла только, что можно сделать аналог proto.hrc и вписать его в catalog.xml.
Попробовала - с отдельным файлом тоже не удалось заставить работать. С архивом - пожалуйста...
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Простите, не поняла. Зачем мне помещать прототип куда-то еще, если он видится Колорером из proto.hrc?
Не видится файл с раскладкой, если он в base\hrc\auto или base\hrc\auto\types. Т.е. если я в свой файл положу прототип - то и он не увидится.
Или я Вашу идею неправильно считала, но тогда можно пример для понятности?
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Tue 24 Dec, 2013 20:48
by Sim
такой вопрос: как сделать чтобы по умолчанию была раскраска как у .txt файлов? если, например, файл без расширения или расширение не опознанно.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 04:55
by tvel
Зачем мне помещать прототип куда-то еще, если он видится Колорером из proto.hrc?
Если вы не часто обновляете far3 и колорер или совсем не обновляете, то да - нет необходимости,
обновите far3 и/или колорер - и ваши правки в proto.hrc исчезнут,
файл proto.hrc не является штатной точкой входа для своих кастомных hrc, он для стандартных hrc из поставки.
Расширять библиотеку можно двумя способами:
- свой catalog.xml, ссылка есть в шапке темы (это единственный способ держать ещё и свои hrd, не теряя связь с ними после обновлений)
- свои hrc в \base\hrc\auto, если хотите можно сделать свой аналог proto.hrc в этой папке и держать там только свои прототипы (быстро и удобно)
Остальное - лучше не надо. Свои hrc можно поместить куда угодно, если прописать соотв. прототипы,
но команда "Перезагрузить библиотеку схем" срабатывает только на common.jar и папку auto (при штатном catalog.xml),
т.е. не перезапуская far3 тяжело править свои hrc вне этих хранилищ.
Не видится файл с раскладкой, если он в base\hrc\auto или base\hrc\auto\types. Т.е. если я в свой файл положу прототип - то и он не увидится.
Это какая-то ошибка. Трудно сказать почему у вас так. Поэтому пример наверно лишнее.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 07:42
by tvel
Kanareyka wrote:Создала файл oeabl.hrc:
...
Зачем выбирать в качестве исходника c.hrc? Он большой и сложный,
содержит связь через <!ENTITY> с файлом "c-win32.ent.hrc", который должен быть там же где вы помещаете копию c.hrc, естественно здесь у вас ошибка.
Я так понимаю вы хотели написать свой hrc "с нуля", ну так сделайте свою "чистую" заготовку, например
Помещаю в auto - всё работает, все цифры в примерах красятся.
Учтите, также что расширение ".p" уже используется в колорере для другого типа, вес weight="3" вроде помогает,
если хотите потом увидеть свой hrc в стандартной поставке - можете обсудить веса с lazyeugene и ctapmex.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 07:51
by tvel
Sim wrote:файл без расширения или расширение не опознанно.
А вес надо задать самый маленький из возможных, чтобы опознанные файлы красились, как и раньше.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 10:10
by Sim
Спасибо за подсказки, однако я не понял, что, конкретно, я должен сделать? Добавить эту строку в proto.hrc? Но тогда надо, наверное, сделать его копию и свой catalog.xml?
может проще в proto.hrc поменять строку:
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 11:07
by NightRoman
Есть разные способы. Менять нативный proto.hrc - не лучший, придется мержить при апдейтах. Свой каталог - гораздо лучше. Там указать *свой* файл прототипов в *дополнение* к нативному. Как делать, я на форуме пример приводил, повторять не буду.
Авторам. Кажется, что эти операции надо бы задокументировать либо в ридми, либо в шапке форума, либо и там, и там. Вопросы на формуме то и дело возникают.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 11:11
by John Doe
NightRoman
В шапке давно есть ссылка на ваши рекомендации.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.
Posted: Wed 25 Dec, 2013 11:16
by NightRoman
John Doe wrote:NightRoman
В шапке давно есть ссылка на ваши рекомендации.
А, хорошо, спасибо. Хоть будет куда отсылать. Но очевидно, что многие эту инфу сами не находят. Неинтуитивное место для этого, может быть.
Re: Colorer — гибкая раскраска синтаксиса в редакторе и др.