как установить geany на linux

Как установить geany на linux

Geany представляет собой легкий, свободный, кросс-платформенный текстовый редактор и интегрированную среду разработки (IDE). Он основан на GTK+ и имеет множество функций. Конструктивная цель этого инструмента заключается в обеспечении быстрого и стабильного текстового редактора. Он широко используется обычными пользователями и программистами, чтобы написать свой код. Он поддерживает большое количество современных языков программирования и работает безупречно на Linux, Windows, Mac OS, Free BSD и операционных систем Solaris.

Основные характеристики

Для установки geany, можно просто открыть терминал в ввести

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

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

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

Открываем терминал и набираем вот такую строчку.

Далее переходим в директорию загрузки архива, у меня это «Загрузки»

и разархивируем архив

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

Ну и начинаем собирать нашу программу

Далее находим в меню иконку с чайничком, и запускаем.

Как видим у нас установилась самая последняя версия которая доступна на сайте разработчиков.

Официальная страница Geany — http://www.geany.org

А каким вы пользуетесь редактором кода?

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

Источник

Установка и настройка IDE Geany для Python

Программирование на языке Python очень популярно и это не удивительно: он легкий для изучения (на нем учат программировать даже в школе), Python портирован и работает почти на всех известных платформах, применим как для WEB разработки, так и для анализа информации (искусственный интеллект). Для комфортной работы уже используются множества интегрированных сред программирования. Одна из самых популярных это Geany. У нее есть свои плюсы и незначительные минусы. Из плюсов можно отметить следующее: Geany — это универсальная среда программирования, которая работает со множествами языков программировании, такими как С++, C#, Python и SQl, также важным плюсом является бесплатное распространение ПО.

В этой статье рассмотрим правильную установку и настройку интегрированной среды программирования Geany и ее настройку для работы с Python так же рассмотрим установку самого языка Python.
Для работы с языком программирования Python необходимо совершить следующие шаги: установить интерпретатор языка Python и интегрированною среду разработки (ИСР или по англ. IDE) Geany.
Итак, начнем!

1. Устанавливаем Geany

Шаг 1. Скачиваем дистрибутив на компьютер.

Ссылка для скачивания: https://www.geany.org/download/releases/
В результате у вас должен быть установочный файл (рис. 1)

рис. 1

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

Шаг 2. Установка программы.

Как видим на рисунке 2, нам предлагают установить Geany версии 1.35, на данный момент — это последняя версия, но Geany все время развивается и когда Вы будете ее устанавливать, то может выйти уже следующая версия. Мы соглашаемся на установку и нажимаем на кнопку “Next”

рис. 2

Шаг 3. Установка программы.

На данном этапе мы можем ознакомиться с лицензионным соглашением и для дальнейшей установки нажимаем на кнопку “I Agree”

рис. 3

Шаг 4. Установка программы.

На этом этапе мы выбираем компоненты. Для корректной работы рекомендация выбрать все возможные компоненты “Full”

рис. 4

Шаг 5. Установка программы.

На 5 шаге мы выбираем место для установки на нашем компьютере. Рекомендуем выбрать директорию по умолчанию в “Program Files”

рис. 5

Шаг 6. Установка программы.

На данном шаге также рекомендуем ничего не изменять и оставить все по умолчанию, нажав на кнопку “Install”

рис. 6

Шаг 7. Установка программы.

Шаг 8. Установка программы.

После успешной установки, появится следующее сообщение как на рисунке 8

рис. 8

После правильной установки у вас должен появиться на рабочем столе ярлык в виде “чайника”

2. Настройка Geany

Далее запускаем Geany и производим его настройку.
Geany еще “не знает”, что мы будем работать с языком Python. Для информирования его об этом, необходимо создать файл с расширением “*.py”, так как Geany распознает языки программирования по расширению файлов.

После запуска Geany перед вами открывается следующее окно рис 9. Обратите внимание, что все вкладки имеют название “без имени”

рис. 9

рис. 10

После создания данного файла Geany понимает, что мы хотим работать с языком Python. И мы можем написать свою первую программу на языке Python.
Наша программа будет состоять из одной строчки, которая должна вывести сообщение «Привет. »

Если вы еще не знакомы с синтаксисом языка Python, то просто перепишите этот код, как на рисунке 11:

Рис. 11

Следующим шагом запустим нашу программу.
Для запуска необходимо нажать на кнопку F5.
Если у вас не появилось сообщение, как на рисунке 20, то у вас одна из ниже перечисленных ошибок. Давайте посмотрим, как их ликвидировать.
Ошибка №1 на рис 12. возникает в случае, если при запуске на консоли появилась следующая ошибка:
““python” не является внутренней или внешней командой, исполняемой программой или пакетным файлом.”

рис. 12

Это ошибка возникает в двух случаях:
1. На данном компьютере не установлен интерпретатор Python
2. Не прописаны пути Path

3. Установка Python

Ошибка №1

Для решения первой проблемы (пункт 1) устанавливаем Python рис 13.
Скачиваем дистрибутив https://www.python.org/

рис. 13

После скачивания запускаем инсталлятор рис 14.

рис. 14

рис. 15

После успешной установки, появится надпись “Setup was successful”. Это означает, что установка прошла успешно и можно возвращаться к нашей программе и попытаться ее запустить.

рис. 18

После установки запускаем снова нашу команду “Привет мир!”. Если ошибка все та же (как на рисунке 12), то значит мы столкнулись с ошибкой номер 2 (отсутствие привязки интегрированной среды Geany с интерпретатором Python). Это означает, что среды Geany не знает, где установлен Python, а в следствии чего не может его запустить.

Ошибка №2

Для решения этой ошибки необходимо запустить IDE Geany и выбрать наш файл с расширением “.py” или создать новый.
Следующий шаг: переходим в верхнее Меню программы Geany и выбираем пункт “Сборка”, далее в контекстном меню выбираем пункт: “Установить команды сборки” рис 19

рис. 19

рис. 20

Мы прошли все возможные этапы по установке и настройке интегрированной среды программирования Geany для работы с языком Python. Теперь мы можем создавать программы (проекты) на языке Python и делать этот мир лучше.

Источник

Geany

Быстрая и легковесная среда разработки

Документ распространяется на условиях GNU General Public License, публикуемых Free Software Foundation; версии 2 или любой более поздней. Копии этой лицензии находятся в файле COPYING в исходных текстах программы, а также в главе GNU General Public License.

Введение

Что такое Geany

Основной задачей при создании Geany было получить компактную и быструю интегрированную среду разработки (IDE) с минимальной зависимостью от других пакетов. Второй задачей Geany была независимость от любой оболочки (KDE, GNOME и т.п.) — Geany требует только наличия исполняемых библиотек GTK2.

Основные функции Geany:

Где взять

Geany можно получить на сайте http://www.geany.org/. Возможно, Geany уже включен в ваш дистрибутив.

Лицензия

Geany распространяется на условиях GNU General Public License, публикуемых Free Software Foundation; версии 2 или любой более поздней. Копии этой лицензии находятся в файле COPYING в исходных текстах программы, а также в главе GNU General Public License.

Входящая в состав системы библиотека Scintilla library (находится в подкаталоге scintilla/) имеет свою собственную лицензию, приведенную в главе Лицензии на Scintilla и SciTE.

Документация

Документация распространяется в форматах HTML и текстовом. Последнюю версию документации можно найти на сайте http://www.geany.org/.

Если у вас есть желание дополнить документацию, см. Как принять участие в разработке документации.

Установка

Технические требования

В системе должны быть установлены библиотеки GTK (>= 2.8.0) и связанные (Pango, GLib и ATK). Обычно дистрибутив уже содержит все необходимое, и установка библиотек выполняется по умолчанию. Для Windows загрузите программы установки с сайта поддержки этих библиотек.

Пакеты программ

Доступно большое число пакетов программ в виде готовых бинарных кодов. Постоянно пополняемый список находится здесь: http://www.geany.org/Download/ThirdPartyPackages.

Компиляция исходных текстов

Скомпилировать Geany несложно. Понадобятся библиотеки GTK (>= 2.8.0) и заголовочные файлы, в том числе Pango, GLib и ATK. Все это имеется на http://www.gtk.org, но, как правило, включается в дистрибутивы с Geany.

Разумеется, понадобятся компиляторы C и C++. Рекомендуем использовать компиляторы лицензируемые согласно GNU.

Сборка с помощью make

Система сборки с использованием утилиты Make общеизвестна и хорошо отлажена.

Потребуется выполнить следующие команды:

Система сборки кода с использованием Waf новая, ее разработка продолжается, но системой уже можно пользоваться. В отличие от make, для работы waf должен быть установлен Python. Waf сборка немного быстрее. Главное ее преимущество проявляется в ситуации, когда сборку необходимо повторять несколько раз, внося небольшие изменения в исходные тексты — возможно, только в один-другой из множества файлов. При этом благодаря использованию специального кэша Waf оказывается намного быстрее. Подробности см. ниже в разделе Кэш Waf. При сборке Geany с помощью Waf выполняются команды:

Кэш Waf

Используя кэш, Waf выполняет сборку исполняемого кода не затрачивая время на перекомпиляцию не менявшихся частей исходных текстов программы. Это весьма типичная ситуация в процессе отладки, когда изменения вносятся лишь в один из модулей и необходимо сразу проверить получаемый результат.

Кэш объявляется переменной окружения WAFCACHE. Размещается кэш обычно в каталоге

и затем объявить для вашей оболочки соответствующую переменную окружения (приводим пример для Bash):

Не забудьте заменить username своим именем пользователя.

Дополнительную информацию о работе с кэшем Waf можно найти на сайте http://code.google.com/p/waf/wiki/CacheObjectFiles.

Очистка кэша

Следует присматривать за каталогом кэша, так как его размер может в ходе работы очень сильно расти. Waf пока этого не делает, так что кэшем придется заниматься вам. Проще всего дать команду, которая удалит из кэша все файлы старше 14 дней:

Подробности о команде find, ее ключах и опциях см. в ее руководстве manual.

Выборочная установка

Скрипт конфигурирования поддерживает ряд вариантов, для получения справки по которым дайте команду

или, если используете сборщик Waf,

Варианты установки подробно рассмотрены в файле INSTALL. См. также раздел Опции компиляции.

Поддержка динамической загрузки и VTE

Проблемы при сборке

Если при компиляции возникают какие либо ошибки, проверьте окружение при сборке и попытайтесь найти ошибку; в случае неудачи напишите в рассылку или одному из авторов. Можно также обратиться к поставщику вашего дистрибутива.

Префикс инсталляции

Если после инсталляции потребуется редактировать какие-либо конфигурационные файлы, вам необходимо знать префикс инсталляции, т.е. путь к каталогу в который установлен Geany.

Обычно это каталог /usr если вы устанавливали готовую систему или /usr/local если система компилировалась из исходных текстов.

Руководство пользователя

Запуск Geany

Запустить Geany можно следующими способами:

С помощью меню рабочего стола:

С помощью командной строки:

Наберите команду и нажмите Enter:

Рабочее пространство Geany

Так выглядит окно Geany. В нем имеются следующие области:

Модули для Geany могут добавлять на боковую и нижнюю панели дополнительные страницы.

Порядок закладок страниц можно настроить в интерфейсных предпочтениях (preferences).

Размеры панелей можно менять, перетаскивая мышью разделительные линии.

Опции командной строки

Использовать это имя файла сокета для коммуникации с запущенной копией Geany. Можно использовать совместно с командой вызова Geany в текущем рабочем пространстве:

Загрузить перечисленные файлы вместо тех, с которыми работали в прошлой сессии. Можно попросить Geany сразу показать нужную позицию в файле (строку и столбец). например, команда «geany foo.bar:10:5» откроет файл foo.bar, поместив курсор в 54-ю позицию на 10-й строке.

Можно указать и открыть целый проект, но для этого файл проекта (*.geany) должен быть первым аргументом после ключей опций. Если при этом указаны и другие файлы, они игнорируются.

Общие замечания

Загрузка файлов при запуске

При запуске Geany загружает все файлы, которые были открыты в предыдущем сеансе работы. Можно отказаться от такой загрузки в настройке предпочтений (см. Общие настройки запуска). Если указать какие-либо файлы в командной строке запуска, будут открыты только эти файлы. При этом список файлов, с которыми вы работали раньше, можно открыть в меню «Недавние файлы». По умолчанию здесь показаны 10 последних файлов. Изменить это число можно в настройках предпочтений.

При запуске нескольких копий Geany только первая из них открывает файлы предыдущего сеанса работы. При запуске второй копии Geany не указывайте в командной строке открываемые файлы или отключите опцию их загрузки.

Открытие файлов из командной строки ранее запущенной копии Geany

При запуске Geany проверяет, нет ли в памяти ранее запущенной копии, и при ее наличии открывает те же файлы, что были указаны в командной строке при первом запуске. Geany подобно файловому менеджеру не «захватывает» файлы, а позволяет просматривать и редактировать их из другой программы.

При открытии файла можно указать строку и столбец (позицию) в которую будет помещен курсор, например:

файл some_file.foo будет открыт на строке 55, курсор в позиции 4.

Эмулятор виртуального терминала (VTE)

Если вы установили в системе libvte.so, Geany загружает его автоматически и в нижней части окна появляется значок-виджет терминала (закладка).

Если при запуске Geany не находит libvte.so, виджет не загружается. Эмулятор терминала можно отключить, см. раздел Опции командной строки.

С этим терминалом (далее будем называть его VTE) можно работать по большей части так же, как с любой терминальной программой, например xterm. Поддерживается работа с буфером обмена, с помощью которого текст можно копировать или переносить в окно VTE или из него (команды в меню при нажатии правой кнопки мыши). В системах с X Window System вставка из буфера делается средней кнопкой мыши; для двухкнопочных мышей действие средней кнопки часто воспроизводится нажатием сразу на обе имеющиеся).

Geany ищет для загрузки файл с именем libvte.so, а при его отсутствии некоторые другие имена. В случае проблем проверьте, правильно ли вы установили libvte. Заметим, что сам Geany будет работать и без этой библиотеки.

Возможно, файл библиотеки называется не libvte.so, а как-то иначе (например, для FreeBSD 6.0 — libvte.so.8). В таком случае укажите правильную ссылку:

Не забудьте только заменить X на номер вашего libvte.so.

Для использования стиля необходимо приписать его как минимум одному из виджетов Geany, например, командой

Эта команда определяет стиль «geany_style» всех виджетов Geany. Можно ограничиться только некоторыми виджетами из числа следующих:

Открытые файлы

Переход от файла к файлу

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

Закладки страниц можно расположить с любой стороны главного окна редактора, выбрав нужную сторону в настройке предпочтений.

В разделе Команды работы с окнами документов и их закладками указаны полезные клавиатурные сокращения, включая наиболее часто употребимые для переключения между документами.

Возможности работы с кодировками текстов

Кодировки

Используя возможности библиотеки GLib, Geany автоматически определяет правильную кодировку файлов и поддерживает конвертирование из одной кодировки в другую..

Работать в редакторе можно только с текстовыми файлами. Geany попытается открыть любой заданный файл, но, если в нем обнаружится байт NULL, файл будет усечен по этому байту. Все следующие символы при последующем сохранении будут потеряны.

При открытии файла Geany попытается определить его кодировку. Как правило, это удается, но иногда кодировка может быть определена неверно. В таком случае задайте ее вручную, чтобы файл отображался правильно.

Вот какими способами может быть задана кодировка:

В диалоге открытия файлов

Для этого в диалоге имеется выпадающий список. При выборе варианта «Распознать по содержимому» используется автоматическое определение. Если выбрать вариант «Без кодировки (None)» файл будет открыт без попыток определить кодировку, как есть.

С помощью команды меню «Обновить как»

Данная команда повторно открывает текущий файл, позволяя при этом сменить кодировку.

С помощью команды меню «Установить кодировку»

Это команда перекодировки. В отличие от предыдущих, она не меняет кодировку загруженного файла, а устанавливает выбранную кодировку при его сохранении.

Указание кодировки в самом файле

Как мы уже отмечали, автоопределение кодировки удается не всегда. Обнаружив, что Geany неправильно открывает какой-либо файл, вы можете добавить в него явную спецификацию применяемой кодировки (character set), и Geany будет руководствоваться этой информацией.

Спецификация кодировки

Geany понимает мета-тег HTML, содержащий информацию о кодировании файла, например:

Для файлов других форматов (не HTML) задайте кодировку в закомментированной строке следующим образом:

Начиная с версии Geany 0.15 для задания кодировки можно также использовать строку, соответствующую шаблону: coding[\t ]*[:=][\t ]*([a-z0-9-]+)[\t ]*

спецификацию кодировки необходимо разместить в пределах первых 512 байт файла.

Кодировка «None»

Указание кодировки «None» означает, что не следует пытаться подобрать кодировку файла. Это может быть полезно, например, при попытке открыть файл неизвестного формата «как есть», хотя бы до первого нулевого байта 00h (NULL).

Метка порядка байтов в Юникоде (BOM)

При открытии файлов в двухбайтовых кодировках Unicode Geany обнаруживает и учитывает ВОМ, если метка присутствует в файле (см. http://en.wikipedia.org/wiki/Byte_Order_Mark). В Unix-подобных системах использование ВОМ может вызвать проблемы с программами, которые ее не учитывают. Например, компилятор gcc останавливается с выдачей сообщения об ошибке, PHP не может разобрать содержащий ВОМ скрипт и т.д. В строке статуса Geany будет показано наличие ВОМ в файле.

Если требуется поставить или удалить BOM, используйте меню документов и соответствующую настройку.

если вы не знаете, есть ли в файле BOM, нужна ли эта метка и что с ней делать — можно про нее забыть.

Редактирование

Свертывание текста

Geany поддерживает свертывание, т.е. возможность временно скрывать и снова разворачивать фрагменты редактируемого исходного текста. При этом в окне редактора слева появляются небольшие серые значки [+] и [-], указывающие на наличие скрытого фрагмента текста и возможность скрытия соответственно. Секции отмечаются вертикальными линиями. Многие типы файлов поддерживают иерархическое свертывание (вложенность сворачиваемых фрагментов)..

Вы можете изменить стиль значков и линеек свертывания — см. filetypes.common Настройки свертывания.

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

Отметка «Сворачивать/Разворачивать все вложенные элементы» в настройке предпочтений определяет, будут ли при наличии вложенного свертывания открываться сразу все уровни свернутого текста ниже текущего.

Если при щелчке по значку свертки нажата клавиша Shift, действие опции меняется на обратное, т.е. если, например, включено раскрытие всей иерархии — с Shift откроется только первый уровень.

Прямоугольное выделение

Выделяя текст при нажатых клавишах Control и Shift (или Control и Alt, если первая комбинация не срабатывает), можно выделить прямоугольный блок. Внутри выделенного блока можно затем редактировать текст.

Перетаскивание

Выделенный фрагмент текста можно перетащить мышью на новое место, как во многих других текстовых редакторах. Если при перетаскивании нажать и удерживать клавишу Control, вместо перетаскивания текст будет скопирован.

Отступы

Geany позволяет делать отступы как с помощью табуляций, так и вставкой ряда пробелов. Применяемый способ выбирается при настройке предпочтений редактирования (подробнее см. по ссылке). Эта настройка может быть изменена явным выбором в меню Документ->Тип отступа, а также установкой опции отступов Разпознать по содержимому, в последнем случае используется тот способ, который чаще применялся в конкретном файле.

Способ создания отступов в текущем документе показан в статус-строке:

Автоматическая установка отступов

Если включен этот режим, при завершении строки текста нажатием клавиши Enter отступ следующей строки устанавливается автоматически.

Для установки отступа предусмотрено четыре режима:

Закладки

Чтобы отметить место в тексте, поставив закладку в определенную строку, щелкните левой кнопкой мыши на левой границе окна редактора или нажмите Ctrl-m. На полях появится маленький зеленый плюс: закладка поставлена. Повторный щелчок или нажатие клавиш Ctrl-m удаляет закладку. Закладок в документе может быть сколько угодно; удалить все сразу можно командой «Удалить маркеры» в меню «Документ».

Для перехода к следующей установленной закладке нажмите клавиши Ctrl-(точка), к предыдущей — Сtrl-(запятая). Вместе с командами перехода по открытым файлам (их закладкам в редакторе) Ctrl-PgUp/PgDn и Ctrl-Tab команды перехода по закладкам позволяют очень быстро перемещаться по открытым в редакторе текстам.

Переходы по элементам программного кода

Для удобства работы в Geany предусмотрена навигация по некоторым элементам исходных текстов:

При переходе к одному из таких элементов Geany запоминает текущую позицию и переходит к следующему элементу. Для возвращения назад используйте команду «Вернуться на шаг назад», движения вперед — «Перейти на шаг вперед». Этот метод работает и в разных файлах.

Пересылка текста настраиваемыми командами

Команда пересылки записывается в окне диалога после нажатия кнопки «Добавить» (можно ввести несколько разных команд, для каждой заводится своя строка). Для удаления команды достаточно очистить строку и нажать OK.

Подстановка контекста

В настройке предпочтений можно записать команды (разные для различных типов файлов, см. «context_action_cmd» в разделе Формат файла), параметром которых будет слово или выделение в тексте, в котором находится курсор. Контекстное действие вызывается в контекстном меню редактора или клавишной командой).

Текущее слово или выделение подставляется в команду как параметр «%s».

Например, следующая команда открывает сайт с документацией по PHP:

Если выполнить команду, когда курсор находится в слове «echo», браузеру будет передана команда http://www.php.net/echo и открыта справка по echo.

Автозавершение

Geany может предлагать список возможных вариантов завершения слов как для элементов языков программирования, так и для любых слов в документе.

Список вариантов появляется при наборе нескольких первых символов (по умолчанию 4, настраивается в Настройки завершений ввода) или по клавишной команде Завершить слово (по умолчанию Ctrl-Space, о настройке см. Команды редактора).

Если включен режим автозавершения для всех слов Автозавершение всех слов в документе (см. Настройки завершений ввода), в список вариантов попадут все уже имеющиеся в документе подходящие слова.

По мере продолжения ввода слова список автозавершения будет сокращаться, а если подходящих вариантов нет — закроется вовсе. Закрыть его можно в любое время нажатием Escape.

Выбор варианта из списка осуществляется стрелками вверх-вниз и нажатием Enter/Return, либо двойным щелчком мышью. В текст будет подставлен выбранный вариант, а если включен режим Отбрасывать окончания слов при завершении (см. Настройки завершений ввода), все символы после вставленного слова будут удалены.

Автозавершение по частям

При нажатии вместо Enter клавиши Tab (настройка по умолчанию) вызывает вставку выбранного варианта не сразу, а по частям, что может быть полезно при вводе программного кода. Например, для вставки префикса gtk_combo_box_entry_:

Контекстное автозавершение

Когда вы напечатаете foo., будет показан список автозавершения для имен ‘i’ и ‘c’.

Это работает только для С-подобных языков в которых устанавливаются области видимости имен. Анализатор тегов С будет распознавать только общие объявления и не сможет работать для локально объявленных объектов и структур.

Пользовательские фрагменты (сниппеты)

Например, если вы часто вводите в текст свое имя, можно создать такой сниппет:

Всякий раз, как только вы наберете myname слово «myname» будет заменено на «Enrico Trоеger». Клавиша ТАВ, вызывающая замену, может быть изменена в настройках клавишных команд ( Завершить фрагмент кода).

Следует ли использовать завершение или замену сокращений, Geany считывает при запуске из специального конфигурационного файла snippets.conf.

Пример команды копирования:

Есть альтернатива: создать собственный конфигурационный файл

Файл snippets.conf содержит разделы, определяющие общие сниппеты и те, которые доступны для определенных типов файлов (например, для текстов на разных языках программирования).

Вы можете определить новую секцию для файлов определенного типа, например файлов «C++». Сниппеты этой секции будут работать только в файлах заданного типа, причем при одинаковых именах они будут здесь приоритетны по сравнению со сниппетами секции «Default».

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

Управляющие последовательности

Имена сниппетов не должны содержать пробелов; с учетом этого ограничения можно использовать почти любую подстроку. Применение сниппетов не ограничено вводом типовых конструкций языков программирования наподобие if, for, switch. Можно использовать эту возможность для любых целей.

Условное слово myname будет заменено на «My name is » с подстановкой имени разработчика developer.

Вставка символов из набора Юникод

Начиная с GTK 2.10 и следующих версий можно вставлять в текст символы из полной кодировки Unicode, в том числе отсутствующие в текущей кодировке. Для этого нажмите клавиши Ctrl-Shift-u и затем, удерживая Ctrl-Shift, наберите шестнадцатиричный код требуемого символа и, наконец, нажмите Enter or Return (не отпуская Ctrl-Shift!). Если отпустить эти клавиши, при нажатии Enter или любой другой клавиши кроме вставки кода юникодного символа произойдет и вставка новой строки или символа нажатой клавиши.

В некоторых ранних версиях Geany для этого приема предварительно необходимо освободить используемое по умолчанию сочетание клавиш Ctrl-Shift-u (см. клавишные команды, а затем выполнить команду Инструменты->Обновить настройки или рестартовать Geany. Работа данной функции зависит также от GTK.

Обратите внимание на слово «:highest» (высший) в последней строке: оно задает приоритет данного определения стиля. Если не «высший», стиль будет проигнорирован и ничего не изменится.

Поиск использования

Поиск в файлах

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

Здесь необходимо указать кодировку (выбор из списка) файлов, в которых будет вестись поиск. Введенный поисковый контекст конвертируется в указанную кодировку (а результаты поиска будут показаны в UTF-8). Остальные опции служат для передачи grep дополнительных аргументов.

Фильтрование результатов при работе с системами контроля версий

Замена

Диалог замены аналогичен рассмотренному выше диалогу поиска, в нем применяются те же опции.

Заменить все

Для замены всех вхождений искомого контекста на заменяющий будут предложены три варианта:

Переход к определению тега

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

Переход к объявлению тега

Этот поиск аналогичен предыдущему, переход производится к объявлению (например, прототипа функции или extern), а не определению.

Переход к строке

Переход к строке с заданным номером в текущем файле.

Регулярные выражения

Поставив в диалоге поиска или замены отметку Регулярные выражения, можно использовать регулярные выражения (см. Настройки поиска). Синтаксис этих выражений приведен в таблице, он является POSIX-совместимым.

В регулярные выражения могут включаться следующие интерпретируемые символьные последовательности:

Поиск (Wiki)\1 обнаружит вхождение WikiWiki.

Поиск с заменой подстроки Fred(5)XXX на Sam\1YYY, будучи применен к Fred2XXX, даст Sam2YYY.

d, D, s, S, w or W обозначают класс символов (как в текущем наборе, так и вне его).

Вхождением будет считаться любой из символов последовательности в скобках. Если первый символ последовательности ^, все наоборот: остальные символы НЕ считаются искомыми). Сокращение S-E (start dash end) обозначает символы с S по E включительно.

эта таблица взята из документации по Scintilla и SciTE и адаптирована. Эта документация распространяется по лицензии License for Scintilla and SciTE.

Под тегами (именами) понимается информация, соотносящая коды в программе с объявлениями и определениями в исходных текстах.

В Geany применен собственный формат для файла тегов, подобный ctags, однако несовместимый с ним. Использование Geany для генерации файла глобальных тегов рассмотрено ниже.

Пространство имен

Анализ тегов каждого документа производится всякий раз при его открытии или сохранении; результаты отображаются в списке имен в левой части окна Geany. Эти теги используются также для автозавершения и подсказок для всех документов текущего сеанса работы, имеющих одинаковый тип файлов.

Команду «Перейти к тегу» можно использовать для любого имени из списка (workspace tag). См. Переход к определению тега.

Глобальное пространство имен

Глобальные теги можно использовать для тех же целей, причем даже если ни один из файлов с исходными текстами не открыт. Они определены в библиотеке API и обновляются при обновлении библиотеки.

Можно загрузить глобальные теги из специально подготовленного файла, причем разными способами:

Можно также создать свой собственный файл определений тегов. Он должен иметь имя

где lang_ext — одно из расширений для типа файла, ассоциируемого с тегами. Подробнее см. в разделе Расширения типов файлов.

Файлы глобальных тегов, используемые по умолчанию

Для ряда языков программирования список глобальных тегов загружается при первом открытии файла соответствующего типа. В настоящее время такие файлы имеются для следующих языков:

Формат файлов глобальных тегов

Используются два формата:

Формат указывается в первой строке, которая должна быть комментарием (начинаться с символа # и пробела за ним). В строке записывается format=pipe или format=tagmanager соответственно, причем строчными буквами. Это помогает Geany правильно считать файл. Если такой строки нет, Geany пытается определить используемый формат, но при этом возможна ошибка.

В формате Pipe-separated теги также записываются построчно, здесь атрибуты разделяются символом | (pipe — труба, в синтаксисе командной строки прямая черта служит для передачи данных между программами. Прим.перев.). Строка выглядит так:

За исключением первого поля (имени тега), остальные поля могут оставаться пустыми, но разделяющая их черта должна присутствовать.

Подготовив необходимый файл тегов в таком формате, сохраните его в каталоге для тегов, как описано выше в разделе Глобальные теги.

Генерация файла глобальных тегов

После разбора ряда исходных файлов вы можете создать собственный файл глобальных тегов. Для этого служит команда

Пример для программирования на языке D, библиотека wxD:

Генерация файлов тегов C/C++:

Для файлов тегов C/C++ требуются gcc и grep, поскольку заголовочные файлы обрабатываются препроцессором для включения других заголовков, с которыми они связаны.

Используя этот пример, вы можете адаптировать команду для использования CFLAGS и заголовочных файлов с любой нужной библиотекой.

Замена используемого по умолчанию файла тегов C/C++ :

По умолчанию Geany использует для C и C++ файл глобальных тегов c99.tags, обычно находящийся в каталоге /usr/share/geany. Этот файл можно заменить другим, содержащим теги, извлеченные из какого-то набора заголовочных файлов. При следующем запуске Geany вместо c99.tags будет загружен ваш новый файл тегов. Сохраняйте копию своего файла, так как при обновлении Geany он окажется заменен на стандартный и потерян.

Игнорирование тегов

Если определенные теги приводят к ошибкам при анализе кода, их можно игнорировать. Для этого создайте файл «ignore.tags» в каталоге конфигураций Geany (обычно

/.config/geany/ ). Перечислите в этом файле теги, которые необходимо игнорировать, разделяя их пробелами или в отдельных строках.

Приводим более подробную информацию из руководства к Exuberant Ctags:

За дальнейшими подробностями обращайтесь к странице руководства Exuberant Ctags.

Настройка предпочтений

Настройки вида, доступные в меню «Вид», также сохраняются при завершении работы с Geany, а вот настройки в меню «Документ» действуют только для работы с текущем документом и в следующем сеансе работы будут заменены на используемые по умолчанию.

Некоторые редко используемые настройки отнесены к скрытым, см. Скрытые предпочтения.

в следующих разделах сначала приводятся иллюстрации, а за ними соответствующие пояснения.

Общие настройки при запуске

Запуск

Выход

Различные общие настройки

Разное

Не показывать сообщения в строке статуса, отображать их только в окне сообщений.

Можно использовать сочетание клавиш «Перейти к редактору» — при этом обновляется статистика документа в статус-строке. См. Команды управления фокусом.

Поиск

Проекты

Настройки интерфейса

Боковая панель

Шрифты

Закладки в редакторе

Положение закладок

Разное

Настройки панели инструментов

Панель

Вид значков

Настройки редактирования

Опции

Настройки отступов

Подробности см. в разделе Отступы.

Как создавать отступы:

Вариант Tabs and Spaces в некоторых редакторах называется Soft tab support — «мягкая» табуляция. Позволяет более гибко регулировать отступы.

Ширина Ширина отступа в знакоместах (пробелах). По умолчанию 4. Распознать по содержимому Попытаться установить характеристики отступов по образцу открытого файла. Тип авто-отступа:

Способ автоматической установки отступа новой строки при нажатии Enter.

Базовый Основной способ: отступ как в предыдущей строке. Текущие символы По текущему символу: отступ ставится в зависимости от типа файла и таких знаков как, например, фигурные скобки для языка С и двоеточия для Python. Совмещать скобки По скобкам. Аналогично Текущие символы, но, например, для C-подобных языков закрывающая скобка > ставится с таким же отступом как открывающая. Отступ при помощи клавиши Tab

Установка отступа клавишей табуляции. Если опция выбрана, нажатие клавиши Tab устанавливает отступ текущей строки или выделения, а клавиш Shift-Tab — удаляет. Собственно, при этом клавиша tab просто вставляет символ табуляции (что может отличаться установки отступов по некоему способу).

Для установки и удаления отступов можно также использовать настраиваемые клавишные сочетания. Действие клавиши Tab может быть различным в зависимости от контекста операции, например при установке отступа и вставке сниппета.

Настройки завершений ввода

Завершения

Geany начнет новую строку так:

и с тем же отступом что у предыдущей строки. И будет это делать до тех пор, пока в очередной строке не окажется код закрытия комментария */.

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

Автоматическое закрытие скобок и кавычек

Geany может при вводе открывающей скобки или кавычки автоматически вставлять закрывающую. Например, если вы ввели (, рядом автоматически появится скобка ). Следующие опции определяют, с какими символами будет работать эта функция.

Скобки ( ) Автозакрытие круглых скобок. Фигурные скобки < >Автозакрытие фигурных скобок. Угловые скобки [ ] Автозакрытие квадратных скобок. Одинарные ковычки ‘ ‘ Автозакрытие одинарных кавычек. Двойные кавычки » » Автозакрытие двойных кавычек.

Настройка визуализации

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

Рабочее окно

Маркер длинных строк

Отмечать длинные строки. Длинные строки получат специальную отметку, что подскажет, что их не помешало бы разбить.

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

Виртуальные пробелы

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

Отключено Не показывать виртуальные пробелы (т.е. не пускать курсор дальше конца строки). Только для выделения столбцом Разрешать перемещение курсора за конец строки только в пределах прямоугольного выделения. Всегда Всегда разрешать перемещение курсора за конец строки.

Настройки работы с файлами

Новые файлы

Сохранение файлов

Опции этого раздела задают дополнительные операции, которые могут выполняться при сохранении документа. Все они могут быть отменены с помощью команды Undo.

Следить за наличием новой строки в конце файла Если в конце документа нет пустой строки, она будет добавлена. Убирать лишние пробелы и табуляции Удалить из строк хвостовые пробелы. Заменить табуляции пробелами

Заменить знаки табуляции соответствующим числом пробелов.

лучше уж сразу использовать для создания отступов пробелы. См. раздел Отступы.

Разное

Интервал в секундах для проверки состояния файла документа на диске (не был ли он изменен помимо Geany). Установка значения 0 отключает такую проверку.

Такая проверка проводится только для локальных файлов. Удаленные файлы не проверяются из-за возможных проблем с производительностью (файлы в

/.gvfs/ считаются удаленными ).

Настройки утилит

пользователям Windows рекомендуется использовать grep.exe из проекта UnxUtils (http://sourceforge.net/projects/unxutils). grep.exe проекта Mingw в настоящее время может не работать с Geany.

Команды

Настройки шаблонов

В поля этой формы можно внести различные сведения, которые затем могут использоваться как мета-данные для вставки в документы (например, в заголовок файла).

После внесения изменений необходимо выполнить команду Инструменты->Обновить настройки или рестартовать Geany.

Данные для шаблонов

Можно ввести в публикуемый адрес искажения, затрудняющие работу собирающих адреса спаммерских ботов, например namesite ext.

Настройки сочетаний клавиш

Некоторые перечисленные в форме операции по умолчанию не связаны ни с сочетаниями клавиш, ни с командами меню.

Более подробная информация представлена в разделе Сочетания клавиш.

Настройки печати

Использовать внешнюю команду для печати Использовать системную команду печати. Использовать собственный механизм печати GTK Использовать печать средствами GTK. Показывать номера строк Печатать слева номера строк. Печатать номера страниц Печатать в правом нижнем углу номер страницы. Печатать заголовки страниц Печатать верхние колонтитулы. Использовать только имя текущего файла Использовать имя файла без указания полного пути. Формат даты Формат печати дат. Можно использовать форматы функции ANSI C strftime(). См. в http://man.cx/strftime.

Настройки терминала (VTE)

Виртуальный терминал

Работа с проектами

Функции работы с проектом являются в Geany вспомогательными. В настоящее время поддерживаются:

Список файлов проекта используется, когда включена опция «Использовать файлы сессий для проектов» в группе «Проект» диалога настройки предпочтений.

Пока открыт определенный проект, меню «Сборка» будет содержать пункты, определенные в настройках проекта. См. также раздел конфигурирование меню сборки.

Настройки текущего проекта сохраняются при его закрытии или при выходе из Geany. При следующем запуске будет открыт файл проекта, с которым велась работа в конце предыдущей сессии.

Рассмотрим команды меню проектов.

Новый проект

Для создания нового проекта введите его имя в поле «Имя«. По умолчанию новый файл проекта создается так:

/projects/name.geany. Обычно лучше сохранять все файлы своих проектов в одном каталоге, независимо от каталогов с файлами исходных текстов.

В поле «Путь к каталогу» text записан путь к каталогу

/projects/name. Вы можете изменить его на любой другой, не меняя файлы в каталоге.

Свойства проекта

Можно определить для проекту дополнительное описание (в настоящее время Geany это описание никак не использует).

В поле «Путь к каталогу» записывается каталог, в котором исполняются команды меню «Сборка». Здесь можно вводить как абсолютный путь, так и относительный начиная с каталога с файлом проекта.

Задание пути к проекту

Кнопка «Указать путь к каталогу проекта» заносит в поля рабочих каталогов для команд сборки путь к каталогу проекта %p.

нажатие кнопки ‘установить’ переустановит все рабочие каталоги, ранее заданные для проекта.

Открыть проект

Команда открытия проекта вызывает в каталоге

При включенной поддержке работы с проектами Geany закроет все ранее открытые файлы и откроет файлы, ассоциированные с проектом.

Закрыть проект

При закрытии проекта Geany закроет проектные файлы и откроет те, которые были закрыты при переходе к работе с проектом.

Меню сборки «Сборка»

После редактирования исходных текстов наступает время компиляции, линковки, сборки, интерпретации, запуска и т.п. Geany поддерживает работу со многими языками программирования, для каждого из которых существует свой порядок этих операций. Как и многие другие среды разработки, не привязанные к определенному языку, Geany не имеет встроенной системы сборки кода и позволяет использовать любую внешнюю систему. Для этого меню «Сборка» предоставляет гибкие возможности настройки запуска компиляторов и других необходимых приложений.

В этом разделе мы рассмотрим применяемую по умолчанию конфигурацию меню «Сборка» и ее настройку.

Запуск компиляции и пр. с помощью команд из Geany имеет два преимущества:

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

Если Geany не обрабатывает должным образом сообщения об ошибках, выдаваемые вашим компилятором, вы можете настроить разбор сообщений самостоятельно с помощью диалога команд сборки, см. Конфигурация меню «Сборка»

Индикаторы

Строки исходного текста, которые привели к выдаче сообщений об ошибках, будут подчеркнуты красной волнистой чертой. Если вы захотите убрать это подчеркивание, это можно сделать командой «Remove all indicators» в меню документов.

Можно убрать индикацию и в настройке предпочтений.

Команды меню «Сборка»

В зависимости от типа текущего файла, по умолчанию меню «Сборка» будет содержать следующие команды:

Компиляция

Для файлов разного типа эта команда используется по разному.

Для компилируемых языков, таких как C and C++, запускается компилятор для преобразования исходного текста в двоичный код. Из отдельных исходных файлов будут получены файлы объектов кода в двоичном виде.

Интерпретируемые языки, например Perl, Python, Ruby компилируются в байтовый код, если язык его поддерживает, или производится только проверка синтаксиса. Если средств проверки не имеется, файл запускается на исполнение в интерпретаторе языка.

Сборка

Для компилируемых языков команда выполняет сборку (link) двоичных объектов, полученных из файлов исходных текстов, в исполняемый файл. Если нужный объектный файл отсутствует, сразу же будет выполнена компиляция, т.е. обе стадии получения исполняемой программы пройдут за один шаг.

Для интерпретируемых языков команда «Сборка» не используется.

Сделать

Команда запускает утилиту «make» в каталоге с текущим файлом.

Сделать заданный объект

Запрашивается параметр для утилиты ‘Make’, указывающий имя объекта для построения. Например, после ввода ‘clean’ будет выполнена команда «make clean».

Сделать объект

Будет выполнена команда «make current_file.o», в том же каталоге где находится текущий файл. Команда полезна для обработки одного лишь текущего файла, а не всего проекта сразу.

Следующая ошибка

Переход к следующей обнаруженной ошибке.

Предыдущая ошибка

Переход к предыдущей обнаруженной ошибке.

Выполнить

После завершения работы программы нажмите Enter/Return (появится соответствующий запрос) и вы сможете просмотреть текстовую выдачу исполнявшейся программы перед закрытием окна терминала.

Сообщения, выдаваемые исполняемыми программами, Geany не анализирует.

Остановить запущенные процессы

После запуска программы вместо команды «Выполнить» и кнопки запуска «Запустить» на панели инструментов появляются команда и кнопка остановки программы. Для остановки процессу (и его дочернему процессу) посылается сигнал SIGQUIT.

Некоторые запущенные процессы остановить таким способом не удастся, например, при образовании нескольких дочерних процессов.

Эмуляторы терминала

Настройка команд сборки

По умолчанию команды «Скомпилировать» и «Сборка» вызывают компилятор GCC и линковщик лишь с основными необходимыми аргументами. С помощью диалога «Установить команды сборки» можно добавить любые необходимые флаги, аргументы, параметры, имена и пути библиотек для линковки.

Подробности см. ниже в разделе Конфигурация меню «Сборка».

если для системы сборки требуются сложные настройки или необходимо использовать разные наборы настроек, рекомендуем подготовить файлы скриптов для Make и использовать команду Make. Это будет проще и для вас и для пользователей, самостоятельно компилирующих вашу программу.

Сделанные настройки автоматически сохраняются при выходе из Geany.

Конфигурация меню «Сборка»

меню «Сборка» позволяет настраивать не только входящие в него команды и названия пунктов, но и каталоги, в которых они должны исполняться.

Например, если вы поменяли одну из команд по умолчанию на работу с ‘waf’, можно соответственно изменить и название команды в меню.

Подчеркивание в названии команды показывает символ для запоминания вызова с клавиатуры.

меню «Сборка» делится на четыре группы пунктов, имеющих различные свойства.

Максимальное число команд в каждой из настраиваемых групп определяется при запуске Geany. Для этого служат скрытые настройки, (см. Настройки формата файлов). Независимо от этого числа фактически в меню будут показаны только те команды, которые были настроены.

Загрузка из файла проекта и сохранение в него.

Загрузка из файла filetype.xxx в каталоге

/.config/geany/filedefs. Сохранение в этот же файл, при его отсутствии файл создается.

Загрузка из файла проекта и сохранение в него.

Загрузка из файла geany.conf в

/.config/geany. Сохранение в этот же файл, при его отсутствии файл создается.

1. _Make
Команда: make

2. Make Custom _Target
Команда: make

3. Make _Object
Команда: make %e.o

Загрузка из файла проекта или другого файла, указанного в нем. Сохранение в файл проекта.

Загрузка из файла geany.conf в

/.config/geany или файла filetype.xxx в

/.config/geany/filedefs. Сохранение в файл filetype.xxx file в

Диалог ввода команд меню «Сборка»

Настройка меню «Сборка» происходит в основном с помощью формы «Установить команды сборки». Эта форма вызывается при настройке предпочтений и настройке проекта.

В форме выделены три секции:

У каждой секции имеется три столбца полей: для названия пункта меню, записи соответствующей команды и рабочего каталога для ее вызова. Если название пункта не задано, в меню эта команда не появится; при пустом поле каталога команда выполняется в том каталоге, в котором находится текущий документ.

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

В диалоге всегда показаны команды, выбранные в соответствии с их приоритетом. Если команда определена в проекте (имеет высший приоритет), она будет показана серым цветом и недоступна для правки в форме. (Понятно, что это относится к работе с настройкой предпочтений — при настройке проекта все команды доступны для правки).

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

Подстановки в командах и путях

При записи используются следующие параметры, заменяемые как описано ниже:

Если заданный в настройках проекта базовый путь не абсолютный, он рассматривается относительно каталога с файлом проекта. Таким образом, если сохранять файлы проектов в узлах дерева каталогов с исходными файлами, где хранятся файлы проектов, спецификация всех путей будет привязана к структуре каталогов. Часть структуры с данными конкретного проекта может при этом переноситься на новое место или подвергаться операциям захвата и освобождения системой контроля версий без необходимости переконфигурировать пути в меню «Сборка».

Клавишные команды в меню «Сборка»

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

На нынешний момент нет возможности задать клавишные команды для других элементов меню.

Файлы конфигурации

Настраиваемое меню «Сборка» появилось в Geany версии 0.19, что потребовало добавления новой секции в конфигурационные файлы (см. Формат файлов конфигурации). При открытии файлов проекта старого формата Geany будет пытаться картировать их секции так, как требуется в новом формате, но иногда это не удается. Проверьте и при необходимости исправьте настройки меню «Сборка».

Печать

Начиная с версии 0.13 Geany поддерживает печать с использованием API GTK. Отпечатанные страницы будут выглядеть примерно так же, как на экране. Имеется и ряд дополнительных опций.

Дополнительно к тексту документа можно печатать номера строк, страниц и верхний колонтитул, включающий имя файла, номер страницы, дату и время распечатки. Имя файла по умолчанию выводится с полным путем доступа; изменить формат вывода можно в настройках предпочтений. Для даты и времени можно использовать варианты, предусмотренные для функции ANSI C strftime.

Для превью печати можно использовать xpdf, kpdf и пр.

К сожалению, поддержка печати с помощью GTK доступна только при сборке Geany с GTK версий 2.10 и старше и работает с этими же версиями GTK. В противном случае Geany предоставляет только базовую поддержку печати. Это означает, что файл можно распечатать системной командой. Напечатанный документ не будет содержать каких-либо синтаксических выделений. Команда печати записывается в настройках, по умолчанию применяется

Параметр %f заменяется на имя текущего файла. Geany не покажет сообщения об ошибках, поэтому если потребуется проверить и уточнить команду печати, воспользуйтесь командной строкой.

Пример часто используемых настроек:

Требуются утилиты a2ps и xfprint4, вместо последней можно также использовать gtklp и др.

Модули

Большинство модулей добавляют те или иные функции в меню «Инструменты«.

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

См. также Документация по модулям включенным в Geany.

Клавишные команды

Geany поддерживает клавишные команды (клавиатурные сокращения, горячие клавиши) редактора Scintilla. Список этих команд см. в разделе Клавишные команды Scintilla. Применяемые в Scintilla команды можно переопределить.

Команды переключения документов

Приведенные ниже команды не конфигурируются, но могут быть переопределены.

Конфигурируемые сочетания клавиш

Для перечисленных ниже действий вы можете определить свои собственные сочетания клавиш. Для этого откройте диалог настройки предпочтений, выберите действие и щелкните команду «изменить». Нажав свою комбинацию клавиш и затем ОК, вы зафиксируете изменение. Для каждого действия можно ввести только одну клавишную команду, а одной команде можно приписать только одно действие.

Некоторые из команд, применяемые по умолчанию, являются общепринятыми. Например, Ctrl-N для создания нового файла и Ctrl-O для открытия файлов. Не стоит изменять эти команды, но для таких действий вы можете добавить и другие комбинации клавиш. Например, наряду с Ctrl-O можно использовать для вызова диалога открытия файлов и Alt-O.

Команды для работы с файлами

Команды редактора

Команды работы с буфером обмена

Команды выделения

Команды вставки

Команды форматирования

Команды настроек

Команды поиска

Команды перехода

Команды настройки просмотра

Команды управления фокусом

Команды работы с окнами документов и их закладками

Команды для работы с документом

Команды сборки

Команды работы с инструментами

Команды справочной системы

Конфигурационные файлы

Для работы с файлами конфигурации необходимо использовать кодировку UTF-8 без BOM.

Команды меню «Инструменты»

В меню Инструменты имеется подменю Файлы настроек, предоставляющее доступ ко всем конфигурационным файлам, с которыми может работать пользователь. Щелчок по выбранному файлу загрузит его в редактор; когда вы сохраните файл по завершении правки, Geany перезагрузит его и внесенные изменения вступят в силу.

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

Команду Обновить настройки следует применять после обновления какого-либо конфигурационного файла или модификации шаблона, для обновления цветов синтаксических выделений

есть исключение: после правки и сохранения файла filetypes.common цвета подсветки синтаксиса исходных текстов не меняются, так как это потребовало бы заметного времени.

Файл общей конфигурации

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

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

Файлы определений типов файлов

В этих файлах хранятся настройки, специфичные для работы с файлами определенных типов. Это цвета разметки синтаксиса, символы для комментирования строк, настройки компилятора и линкера и др.

Собственные типы файлов

При запуске Geany ищет файлы filetypes.*.conf в системном и пользовательском каталогах для типов файлов и добавляет все найденные файлы типов с именами, отвечающими приведенному шаблону.

Собственные типы предоставляют меньше возможностей настройки, чем встроенные. В настоящее время поддерживаются:

Распознавание и установка типа файла (после создания пользователем соответствующего файла filetype_extensions.conf ).

Загрузка файлов глобальных имен(пространство имен разделяется с именами полученными анализом тегов).

Системные файлы

Не рекомендуется редактировать файлы с общесистемными настройками, поскольку они будут переписаны при обновлении Geany и внесенные изменения окажутся потеряны.

Пользовательские файлы

Теперь вы можете редактировать эти файлы, не опасаясь потери изменений после очередного обновления Geany. Другой способ — создать файл

Наряду с рассмотренными ниже секциями, каждый из файлов определений для типов может содержать секцию [build-menu], которая рассмотрена в разделе Секция [build-menu].

Формат файла

Секция [styling] — стиль

В этой секции определяются цвета подсветки синтаксиса. Формат определения:

Цвета кодируются шестнадцатиричными значениями уровней в каналах RGB с добавлением префикса 0x. Например, код чистого красного цвета 0xff0000, синего — 0x0000ff. Регистр здесь не важен, но мы предпочитаем использовать строчные буквы. Bold и italic — флаги установки жирного и курсивного начертаний, они могут принимать значения «true» или «false» (любой другой вариант будет воспринят как «false»).

Например, код key=0xff0000;;true определяет красный шрифт, фон по умолчанию, жирное начертание.

Именованные стили

Второй возможный способ — сослаться на имя стиля, определенного в файле filetypes.common.

Параметры bold и italic опциональны, их действие заключается в реверсировании соответствующих флагов именованного стиля на который сделана ссылка. В отличие от булевых параметров стиля, это строки, вместо точки с запятой разделителем здесь служит запятая.

Например, запись key=comment,italic

определяет стиль с параметрами стиля «comment» но с курсивным шрифтом (если в образце шрифт прямой).

Имена и параметры стилей можно увидеть в секции [named_styles] файла filetypes.common.

Секция содержит ключевые слова для различных списков, специфичных для типа файла. Некоторые типы файлов не поддерживают ключевые слова, для них добавление в секцию новых ключей работать не будет. Можно изменять только существующие списки, добавляя или удаляя слова.

Ключевые слова должны быть записаны в одну строку.

Секция [lexer_properties]

Секция [settings] — настройки

Расширение файла, по умолчанию используемое при сохранении файла (не включая точку). Используемое расширение должно соответствовать одному из ассоциированных с данным типом файлов (см. Расширения файлов).

Символы, которые могут служить границей слов. Используются при пословном выделении и при поиске.

Пример: (смотрите в системных файлах типов filetypes.* files)

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

Символ(ы), закрывающие многострочный комментарий.

Поставьте ‘false’, если символы начала комментария должны располагаться начиная с самого начала строки, или ‘true’, если перед ними возможен отступ.

Отметим, что эта настройка имеет смысл только для однострочных комментариев, например, начинающихся с ‘//’, ‘#’ или ‘;’.

Команда, которая может вызываться для обработки текущего слова или выделения (подставляется на место параметра %s).

Пример использования: открыть документацию по API для функции, на названии которой стоит курсор.

Совет: для файлов PHP весьма полезна следующая настройка: context_action_cmd=firefox «http://www.php.net/%s»

tag_parser Название языка для менеджера тегов например «C». lexer_filetype Имя типа файла для синтаксических выделений в файле другого типа. Имена не должны быть рекурсивными, т.е. имя не должно использоваться самим ключом lexer_filetype.

Секция [build_settings]

В Geany v0.19 эта секция заменена секцией [build-menu]. Настройки из секции [build-menu] имеют преимущество в случае наличия в файле и старой секции.

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

Geany считывает только два первых полученных результата. Цифровая часть интерпретируется как номер строки, остальное как имя файла.

Пример разбираемого сообщения: test.py:7:24: E202 whitespace before ‘]’

Команды сборки

При конфигурировании любой команды меню «Сборка» с помощью формы «Сборка» в настройках проекта результаты работы сохраняются в секции [build-menu], заменяя предыдущие настройки.

Команда запуска компилятора. Однако, ее можно использовать и для интерпретируемых языков, таких как Perl или Python. Для этих языков опцию можно применить для проверки синтаксиса, выдача которой будет направлена в окно сообщений компилятора.

Для работы с именами файлов, содержащими пробелы, такие имена следует заключать в кавычки. Доступны следующие шаблоны имен файлов:

Команда запуска готового исполняемого файла. Параметр %e означает только имя этого файла без расширения; для подстановки полного имени используйте параметр %f (например, для скриптов оболочки).

Файл filetypes.common

В файле filetypes.common хранятся общие настройки, не зависящие от конкретного типа файлов.

Секция [named_styles]

Объявленные в этой секции именованные стили могут использоваться для ссылок в секциях [styling] остальных файлах описания типов filetypes.* file.

В файле filetypes.common:

В файле filetypes.c:

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

Секция [styling]

Стиль по умолчанию, используется для файлов типов, не связанных с исходными текстами.

Стиль для показа выделений. Формат:

Цвета будут использованы только при установке для 3-го и 4-го аргументов значения ‘true’. По умолчанию цвет фона темно-серый, цвет шрифта зависит от синтаксического выделения.

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

Стиль для подсвечивания скобок, для которых не найдены парные.

Стиль курсора. Интерпретируются только первый и третий аргументы. Установка третьего аргумента изменит вид курсора на «block».

Ширина курсора в пикселах, максимум — 3. Интерпретируется только первый аргумент. Значение 0 сделает курсор невидимым.

Окраска линий размера отступов. Интерпретируются только первый и второй аргументы.

Окраска пробельного пространства (табуляций и пробелов). Третий аргумент определяет, использовать ли заданный здесь цвет переднего плана или цвет, заданный для определенного типа файла в соотв. файле настроек.

Значки сворачивания блоков текста. Интерпретируются только первый и второй аргументы.

Возможные значения первого аргумента, определяющие тип значков:

Возможные значения второго аргумента:

По умолчанию: folding_style=1;1;

Тонкая горизонтальная линия в месте сворачивания текста. Интерпретируется только первый аргумент, его возможные значения:

Визуальные отметки, показывающие что данная строка переносится по ширине окна. Значения для первого аргумента:

Второй аргумент определяет, показывать ли отметку около границы окна или вплотную к тексту. Значения:

Остальные аргументы не интерпретируются.

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

Интерпретируется только первый аргумент.

Уровни непрозрачности для текущей строки (первый аргумент) и выделения (второй аргумент). Допустимы значения от 0 до 256.

Для Windows 95, 98 and ME следует всегда устанавливать 256 для отключения прозрачности, в противном случае Geany может зависнуть.

Интерпретируются только первый и второй аргументы.

Стиль для подсветки строки (например, при использовании команд перехода). Первый аргумент, цвет символов, используется только если включены маркеры (см. меню «Вид»).

Интерпретируются только первый и второй аргументы.

Маркер пометки результатов поиска (когда в диалоге поиска включена опция «Mark»). Интерпретируется только второй аргумент, задающий цвет фона при отображении прямоугольника.

Отмеченные строки (команда «Переключить маркер», Ctrl-M). Первый аргумент, цвет символов, используется только если включены маркеры (см. меню «Вид»).

Интерпретируются только первый и второй аргументы.

Уровни непрозрачности для маркера строк (первый аргумент) и маркера поиска (второй аргумент). Допустимы значения от 0 до 256.

Для Windows 95, 98 and ME следует всегда устанавливать 256 для отключения прозрачности, в противном случае Geany может зависнуть.

Интерпретируются только первый и второй аргументы.

Интерпретируются только первый и второй аргументы.

Секция [settings]

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

Сюда должны входить пробел (\s) и табуляция (\t).

Расширения типов файлов

Например, список задания набора расширений для Make /home/username/.config/geany/filetype_extensions.conf должен выглядеть примерно так:

Формат файла настройки предпочтений

/.config/geany/geany.conf содержит все выбранные вами настройки и опции работы Geany. Его не следует редактировать во время работы Geany, поскольку при выходе будут сохранены настройки текущего сеанса работы и файл окажется перезаписан.

Скрытые предпочтения

Имеется ряд редко используемых настроек, не показанных в диалоге Preferences. Они могут быть изменены редактированием файла настроек, после чего следует перезагрузить настройки (Инструменты->Обновить настройки) или рестартовать Geany. Ищите требуемый ключ и меняйте его значение. Пример:

В следующей таблице приведены имена ключей скрытых настроек в файле конфигурации.

Секция [build-menu]

В секции [build-menu] описывается конфигурация меню «Сборка». Такая секция может входить в файлы конфигурации для типов файлов, предпочтений, проектов; во всех случаях она имеет описанный1 ниже формат. Разные команды меню загружаются из разных файлов, см. таблицу в разделе Конфигурация меню «Сборка». Все настройки могут быть сделаны с помощью окон диалога, за исключением команд исполнения в описаниях типов файлов и определений типов файлов в файле проекта, которые требуют ручного редактирования.

Для каждой команды меню в секции build-menu имеется запись следующего формата:

Формат файла проекта

Кроме относящихся к проекту настроек такой файл может содержать список файлов текущего сеанса работы с Geany.

Добавления в секции [build-menu]

Файл проекта может содержать в секции [build-menu] добавочные поля сверх тех, что были рассмотрены выше в разделе Секция [build-menu].

Шаблоны

Geany поддерживает работу со следующими шаблонами:

Для использования этих шаблонов откройте меню «Правка» или контекстное меню окна редактора, выберите команду «Вставить комментарии» выберите и вставьте необходимый шаблон.

Заголовок файла и запись об изменениях всегда вставляются в начале файла.

Для вставки описания функции курсор должен находиться внутри нее, чтобы автоматически могло быть найдено имя функции. Описание вставляется на одну строку выше функции. Если имя функции найти не удалось, в тексте описания вместо правильного имени появится «unknown».

Geany автоматически перезагружает шаблоны, обнаружив сохранение файла в каталоге для шаблонов. Перезагружаются шаблоны и по команде Инструменты->Обновить настройки.

Шаблоны с мета-данными

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

В диалоге конфигурации имеется страница «Шаблоны» (см. Настройка шаблонов). Здесь можно определить данные, по умолчанию вставляемые в шаблоны. Чтобы изменения вступили в силу, вызовите команду Инструменты->Обновить настройки или перезагрузите Geany.

Шаблоны файлов

Это шаблоны для создания новых файлов. Чтобы воспользоваться ими, выберите в меню «Файл» команду «Создать из шаблона«.

Несколько шаблонов для разных типов файлов устанавливаются по умолчанию. Можно добавить шаблоны, создав соответствующие файлы.

Собственные шаблоны файлов

Шаблоны считываются из следующих каталогов:

/.config/geany/templates/files (создается при первом запуске Geany).

Соответствующий тип файла определяется по расширению имени файла шаблона, если оно имеется. Например, созданный файл module.c появится в меню для создания с помощью шаблонов файлов с типом ‘C’.

Шаблоны типов файлов

вместо этих шаблонов рекомендуется использовать собственные шаблоны файлов.

Шаблоны типов файлов считываются из каталога

Настройка шаблонов

Шаблоны находятся в каталоге

Параметры в шаблонах

Параметры для подстановки символов

Общие параметры

Являются настраиваемыми, см. Настройки шаблонов.

Дата и время

Формат настраиваемый, см. Настройка шаблонов. Можно использовать спецификации, предусмотренные для функции ANSI C strftime. Подробности см. на http://man.cx/strftime.

Динамические параметры

Вставка фрагментов

Специальный параметр

Параметр вызывает исполнение указанной команды, а ее выдача (stdout) вставляется в файл.

Используя этот прием, поместите в шаблон рядом с параметром необходимый поясняющий текст.

если указанная команда (программа) не нашлась или не была запущена, в текст будет подставлена пустая строка. Определить в чем дело можно с помощью сообщения об ошибке (stderror) которое будет показано в окне сообщений и в диалоге Справка->Сообщения отладки.

Настройка панели инструментов

С помощью редактора панели или ручного редактирования файла ui_toolbar.xml можно добавлять, удалять и переставлять кнопки и другие элементы панели инструментов.

Редактор панели вызывается из настройки предпочтений на самой панели инструментов или щелчком по ней правой кнопкой мыши и выбором из контекстного меню.

Редактирование размещения панели вручную

Затем можно редактировать файл, добавляя любые доступные элементы перечисленные в файле, удаляя и переставляя существующие, в том числе разделители. Если при правке возникнут ошибки формата XML, вместо исправленного файла Geany использует общий.

Доступные элементы панели инструментов

Документация по модулям

Сохранение

Мгновенное сохранение

Модуль дает каждому вновь созданному файлу случайное имя, устанавливая тип файла по использованному шаблону. Это позволяет быстро компилировать файл и делать прочие операции, не отвлекаясь на диалог «Сохранить как». Это может быть полезно, если вы часто пишете небольшие фрагменты чтобы их тут же протестировать.

Резервные копии

При сохранении текущего файла модуль создаст его резервную копию с предыдущим состоянием. В менеджере модулей можно задать каталог для сохранения копий и указать, какое расширение им присваивать.

Как принять участие в работе над документацией

Если вы довольны результатами работы, создайте патч:

и предложите этот файл для списка рассылки.

Клавишные команды Scintilla

Copyright В© 1998, 2006 Neil Hodgson

Данное приложение распространяется на условиях лицензии для Scintilla и SciTE. Копия текста лицензии включена в комплект исходных кодов программы ( scintilla/License.txt ) и дана в приложении к настоящему документу, см. Лицензия на Scintilla и SciTE.

Клавишные команды

Клавишные команды для Scintilla в основном следуют общепринятым соглашениям для Windows и GTK+. Все клавиши перемещения (стрелки, page up/down, home, end) позволяют менять размеры выделения при удержании клавиши Shift для потокового выделения и клавиш Shift и Ctrl для прямоугольного выделения. Некоторые команды могут оказаться недоступны при работе с теми или иными локализациями раскладки клавиатуры, так как будут использованы в системных целях. В меню указаны клавишные эквиваленты команд. Некоторые менее употребительные команды не имеют эквивалентных команд меню:

Советы и подсказки

«Блокнот» документов

Редактор

Интерфейс

Следующие свойства унаследованы от X-Windows (GTK поддерживает их в Windows):

Опции, устанавливаемые при компиляции

большинству пользователей все это ни к чему.

src/geany.h

project.h

editor.h

keyfile.c

Эти настройки по умолчанию могут быть переопределены в диалоге Настройка предпочтений.

build.h

build.c

GNU General Public License

License for Scintilla and SciTE

Copyright 1998-2003 by Neil Hodgson

All Rights Reserved

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

NEIL HODGSON DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL NEIL HODGSON BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Источник