Маленькие хитрости. Синтаксическая подсветка

ВКонтакте Телеграм Обсуждение RSS-лента

Статья рассказывает как использовать синтаскическую подсветку в самых повседневных задачах самым обычным пользователям (это не о подсветке языков программирования, хотя и это Aml Pages умеет).

См. также: Часть 1 | Часть 2 | Часть 3 | Часть 5 | Часть 6 | Часть 7 | Часть 8 | Видео о синтаксической подсветке
Синтаксическая подсветка для НЕпрограммистов

Добрый день, уважаемые подписчики. Сегодня в очередной части "маленьких хитростей" я попытаюсь рассказать о некоторых любопытных приемах работы в Aml Pages. Речь пойдет о синтаксической подсветке.

Немного истории

В начале марта этого года в Aml Pages была реализована полностью новая синтаксическая подсветка языков программирования.

Как я писал в прошлых выпусках рассылки, основным преимуществом новой подсветки было разделение самого алгоритма подсветки, реализованного в коде программы, и правил подсветки, описываемых во внешних, несложного текстового формата файлах. Под правилами здесь подразумевается, какие слова (символы) в каких случаях и какими цветами должны подсвечиваться.

Вероятно, постоянные подписчики со стажем помнят упоминание о том, что гордое название синтаксической подсветки языков программирования, не только слишком длинное, но и чересчур частное, лишенное обобщенности. А именно, говорилось о том, что алгоритму подсветки абсолютно не важно, что подсвечивать, и это вовсе не обязательно должен быть язык программирования, или какая-либо другая формальная конструкция. Действительно, в программе присутствует код, только код, и ничего кроме кода. Правила же синтаксической подсветки, описывающие, что и как искать (слова, символы и т.д.), где и как подсвечивать (цвета) хранятся во внешних файлах, и могут описывать какие угодно конструкции. Т.е. говоря обычным языком, алгоритм может также непринужденно подсвечивать и текст "шла Маша по шоссе", лишь бы "Маша" со "Шлой" были описаны в файле подсветки.

Синтаксическая подсветка для непрограммистов

Итак, сегодня я хотел бы рассказать о синтаксической подсветке, но не в контексте языков программирования, а применительно к обычной работе с текстом. Рассказать о том, как синтаксическая подсветка может помогать (я бы даже сказал, решать за пользователя 2 трети проблем) в работе с самым обыкновенным НЕпрограммным текстом.

Полагаю, многим из Вас приходится группировать Ваши данные в Aml Pages не только в папки, страницы, листочки, но и внутри текста в некие абстрактные категории вроде "не забыть", "очень важно", "сверхсрочно" и т.п. Т.е. делить на некоторые классы согласно Вашей собственной схеме. Частенько пользователи это делают "глазами", но программа в таком разделении может более чем существенно помогать. Конечно, хотелось бы, чтобы текст разных категорий как-то выделялся. В принципе, Aml Pages поддерживает и форматирование цветов текста, и пользовательские стили форматирования. Но есть два "но", незначительных, зато докучающих:

1. Текст с форматированием может сохраняться только в страницах форматированного текста. А такие страницы, хоть и хранят больше информации о форматировании, в общем случае могут значительно увеличивать размер документа. Что в целом хоть и не прекрасно, но терпимо.
   
   
2. И что важнее, для отметки такого текста, приходится каждый раз "лазить" в команды форматирования. А это бывает затруднительно. Особенно если текст записывается на бегу. А даже если время на "украшательства" и находится, отвлекаться на форматирование, означает отвлекаться от самой задачи пользователя на способ ее решения. Такие отвлечения не способствуют ни комфорту работы, ни лучшему решению задачи. По моему мнению, задача пользователя важнее способа ее решения. Способы решения задачи должны быть проблемой программы.

В частности, мне тоже приходится частенько записывать некий текст, который навскидку достаточно легко поделить на три-четыре категории. К примеру: "Сделать срочно", "Отложить на будущее", "Подумать на досуге с трубочкой английского табака" или что-то в этом роде. Вот как раз для автоматического (именно автоматического, "на лету") выделения цветом такого текста, и более чем применима синтаксическая подсветка. Все что для этого необходимо это включить соответствующую подсветку - дальше программа все будет делать полностью сама.

Но сначала нужно описать правила подсветки, по которым нужно "раскрашивать" текст пользователя. На самом деле в данный момент такие подсветки текста уже есть в дистрибутиве Aml Pages, о чем будет написано ниже, и Вы можете начать пользоваться ими хоть сей момент. Но создать файл правил подсветки отнюдь не сложно. Тем более, что вероятно, у кого-то возникнет желание использовать свою собственную подсветку. Заметим, что правила синтаксической подсветки Aml Pages позволяют описывать конструкции вида:

[признак_начала_подсвечиваемого_текста] [любой_текст] [признак_конца_подсвечиваемого_текста]

Причем признаком конца подсвечиваемого текста может служить, к примеру, и перенос строки, а началом какое-либо специфическое редко используемое сочетание символов или слов, вроде "++" (два плюса) или "##".

Таким образом, набрав подобные специфические символы, Вы продолжаете набирать свой собственный текст, и как только Вы закончите абзац переносом строки, текст мгновенно подсветится. Заметьте, все это будет происходить без каких-либо дополнительных усилий с Вашей стороны - все происходит само собой - Вы просто работаете с текстом.

Что дает такой подход к подсвечиванию текста?

1. Вам вообще не требуется обращаться в командам форматирования!!! Вы как обычно вводите свой текст, разве что, поставив где-то в его начале что-то вроде "++" или "##".
   
   
2. Вы не отвлекаетесь на оформление текста!!! Вы на самом деле полностью на 100% сосредотачиваетесь на своей собственной задаче - а именно на Вашем тексте. Не отвлекаясь на способ решения, Вы решаете саму задачу. Согласитесь, если в классификации присутствует 3-4 категории текста, то значительно быстрее сообразить "налево? направо? прыжок на месте?" и сразу отнести текст к какой-либо категории, а не задумываться о форматировании. В конце концов, Вы легко можете в последствии вернуться к этому тексту и изменить его категорию (просто изменив в тексте эти самые "++" или "##").
   
   
3. Поменяв правила подсветки (цвета подсветки, к примеру), Вы сразу увидите текст подсвеченным в соответствии с новыми правилами. Вам не приходиться думать о том, что текст одной и той же категории ("Не забыть") в разных местах форматируется по разному. Весь текст с такими атрибутами подсветки во всех частях документа будет выглядеть абсолютно одинаково.
   
   
4. Работать с подобным текстом в последствии значительно удобнее. В той или иной степени весь текст уже разбит на некоторые части, категории. "Структура" такого текста видна сразу же. К тому же, если часть текста не отнесена ни к одной из категорий, она не подсвечивается и такие "неопределенные" фрагменты легко находить.
   
   
5. Ну и последнее в списке, но не по значению. Такой текст совершенно спокойно может храниться и в виде обычного текста (страниц простого текста, Plain Text), не съедая драгоценные байты Вашего документа. Хотя замечу, что форматированный текст подсвечивается совершенно с таким же успехом - т.е. все будет работать абсолютно точно так же и со страницами форматированного текста.

Где посмотреть?

Надеюсь, мне удалось рассказать о действительно удобных сторонах работы с синтаксической подсветкой, причем о сторонах удобных и комфортных не только программистам, но и вполне традиционным пользователям. Если я Вас не убедил, попробуйте сами! Как показывает опыт, пользователи, которые часто записывают какую-то обрывочную, но, тем не менее, важную информацию, попробовав этот прием, уже не хотят без него обходиться.

Вопросы и ответы (FAQ, по материалам почты)

Приводит ли подсветка к изменению данных документа?

Нет. Документ хранит только данные о выбранной подсветке (одна подсветка на одну страницу документа). Подсветка текста производится "на лету" и не приводит к изменению документа.

Что произойдет, если Aml Pages не обнаружит конкретный файл подсветки?

Программа сообщит, что файл подсветки не найден, и просто не будет подсвечивать текст страницы. Как только Aml Pages "получит" файл подсветки, подсветка снова будет применяться (если подсветку не отключили, впрочем включить подсветку обратно можно двумя щелчками мыши).

Как переносить файлы подсветок?

Для установки файла подсветки достаточно просто расположить его в папке Aml Pages. И ничего более. Никаких дополнительных "регистраций" файла подсветки не требуется. Программа обнаруживает все файлы подсветок в процессе работы. Если Вы часто работаете с Aml Pages в разных местах или не уверены, что на "соседнем" компьютере будет присутствовать файл Вашей подсветки, то Вы можете просто носить все файлы подсветок с собой - их суммарный обьем не превышает и 20 килобайт (сравните эту цифру с документом содержащим множество форматированного текста).

Как Aml Pages сохраняет данные о выбранной подсветке?

При выборе подсветки Aml Pages заносит в страницу документа имя файла подсветки. Причем именно имя файла, а не полный путь к нему, т.к. файлы подсветок всегда ищутся в папке программы. Именно по имени файла программа и ищет файл подсветки. Поэтому, если Вы пользуетесь своим собственным файлом подсветки, старайтесь выбирать имя файла так, чтобы в дальнейшем не было необходимости его изменять. Формат ash-файлов позволяет описывать заголовок подсветки в меню Aml Pages непосредственно внутри файла подсветки. Рекомендуется выбирать для своих файлов более или менее уникальное имя, чтобы в будущем не возникало конфликтов с файлами других авторов.

Какие подсветки в Aml Pages есть уже сейчас?

С++, MFC (некоторые особенности библиотеки MFC), Visual Basic, ASH (скрипт файлов подсветки), NSIS-скрипт (NullSoft Installation System), SQL, HTML (Web страницы), Delphi (© Сергей Пуховский), E-mail (текст писем электронной почты), файлы истории версий Aml Pages.

Итак, резюмируя

• Правила синтаксической подсветки хранятся во внешних файлах (файлы с расширением ash в папке Aml Pages) и могут быть изменены на собственный вкус любым пользователем в любой момент.
• Можно создавать и новые файлы, для их подключения к Aml Pages достаточно просто поместить файл в папку Aml Pages.
• Сами файлы сохраняются в несложном текстовом формате, который можно редактировать даже с помощью стандартного Блокнота Windows.
• Большая часть файлов синтаксической подсветки из дистрибутива Aml Pages снабжена комментариями, поясняющими ту или иную конструкцию в ash-файле.
• Полное и подробнейшее описание формата файлов синтаксической подсветки есть, как и в справке программы, так и на сайте. Там же Вы найдете советы по использованию, примеры и ответы на вопросы.

Начата разработка специального редактора файлов синтаксической подсветки, который сильно упростит как редактирование файлов подсветки, так и просто наглядный анализ формата ash-файлов, беря большую часть механической работы на себя.
Update: Забили. Не особо было нужно пользователям, да к тому же базовые исходники канули в лету вместе с жестким диском, лет так 20-ть назад.

Больше подсветок - хороших и разных. Желающим увидеть прототип редактора - стучаться в почту, к тому же вопрос о названии такого редактора еще открытый. А как корабль назовешь... А каково Ваше мнение?

Надеюсь, сегодняшний выпуск получился интересным. Но ввиду нехватки времени не буду сегодня писать о новостях, плагинах и прочих динамичных частях проекта. Забегайте в "Новости" - львиная доля действительно существенных новостей там анонсирована.

Ну, и как всегда, если возникают вопросы, есть пожелания - стучаться в почту или милости прошу в форум Aml Pages, там порою происходят весьма жаркие и на весьма философские темы дискуссии (что лично меня чрезвычайно искренне радует).

PS: В прошлом выпуске рассылки я просил высказаться по поводу дизайна программы установки. Вопрос звучал примерно так: "Что Вы предпочитаете лучший дизайн программы установки Aml Pages или ее меньший размер?". Отдельное спасибо всем ответившим. Также на результаты голосования по этому вопросу можно посмотреть на сайте Aml Pages. Порядка 80% высказались за лучший дизайн, пусть хоть немного (40-50 кб) в ущерб размеру. Но т.к. скрипт установки Aml Pages достаточно сложен, то программа пока не обзавелась новой установкой. Но как примерно будет выглядеть новый дизайн программы установки можно посмотреть на примере программы установки файла справки Aml Pages и некоторых из плагинов.

Горячие новости [01/10/2024 16:25]:   Выпущена новая версия Aml Pages 10.01 build 2964. Принципиально новые возможности форматирования простого текста. Обсуждение в форуме расположено здесь.

Скачать можно русскую версию с программой установки или портабельную версию или версии на прочих языках.

Что нового в этой версии:
(Основое, кратко: щелкните,чтобы развернуть) | полностью тут

в правый сайд-бар добавлена вкладка "Советы";

меню сортировки страниц показывает выбранные настройки сортировки жирным шрифтом;

в меню панели "Советы и Трюки" добавлена команда "Закрыть";

добавлено: при запуске поиска текста по документу ищется выделенный текст из правой панели (если есть выделение);

добавлено: при выборе вкладки "Закладки страниц" в диалоге настроек, панель закладок подсвечивается;

отключены gdiScaling, dpiAware, dpiAwareness;

продление обновлений Aml Pages переехало в собственный раздел;

Свежий пост в форуме: как использовать разные версии (exe) Aml Pages одновременно.

новая версия Plugin API;

исправлена сортировка узлов дерева по датам (для команда Файл\Создать\Дневник, Вставка\Список страниц);

исправлено: перезагрузка текста страницы в редактор при щелчке по результату поиска в панели результатов;

клик по вкладке "Новости" в правом сайд-баре закладок показывает\скрывает панель Новости;

исправлено формирование формирование результата поиска текста для веб-страниц;

создание списка страниц по датам сразу ставит сортировку по датам создания + меняет даты созданных страниц на даты из заголовка;

отключены настройки управления флагами узлов дерева;

убраны команды управления флагами узлов дерева из контекстных меню дерева (они давным-давно deprecated);

изменена настройка по умолчанию "Показывать правый сайд-бар" (вкл);

блинк ссылки на статью "Что такое быстрые настройки" при запуске диалога настроек;

добавлено: команды меню "Документ Только для чтения", "Только просмотр", "Страница только для чтения", "Защитить страницу паролем" когда включены, рисуются жирным шрифтом;

исправлено: после переименования узла дерева ветка сразу пересортируется, если в родительском узле выставлены соответствующие сортировки (по алфавиту, по датам изменения);

Добавлена поддержка элементарного форматирования простого текста: шрифт, его размеры и атрибуты, цвета текста и фона. Добавлена поддержка стилей форматирования текста для страниц простого текста.

Новые опции в меню Быстрых настроек.

Улучшено окно выбора цвета — теперь с заголовком для чего выбирается цвет.

Полный список изменений смотрите в разделе Что Нового или можно посмотреть из самой Aml Pages.

Обсуждение в форуме расположено здесь.

Потихоньку оживает и официальный блог - новые статьи, посты, вопросы-ответы.