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

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

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

$ ./configure
$ make

% make install

Waf - сборка

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

$ ./waf configure
$ ./waf build

% ./waf install

$ mkdir -p ~/.cache/waf

export WAFCACHE=/home/username/.cache/waf

$ find /home/username/.cache/waf -mtime +14 -exec rm {} \;

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

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

$ ./configure -help

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

$ ./waf -help

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

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

Если ваша система не поддерживает динамическую загрузку, вероятно вы захотите включить опцию -disable-vte в скрипте configure. Это предотвратит компиляцию Geany с поддержкой динамической загрузки libvte.so.4 (в случае доступности).

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

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

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

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

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

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

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

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

geany some_file.foo:55:4

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

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

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

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

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

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

Оболочку, которая будет использована в VTE, можно указать в настройке предпочтений. Для входа используйте командную строку, необходимые команды вы найдете в manual оболочки. Для zsh и bash используйте аргумент -login.

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

# ln -s /usr/lib/libvte.so.X /usr/lib/libvte.so

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

Можно также задать имя библиотеки VTE в командной строке (см. Опции командной строки) или во время компиляции, указав опцию -with-vte-module-path для ./configure.

Определение собственных стилей виджетов с помощью .gtkrc-2.0

Для многих частей графического интерфейса Geany можно создать свой стиль виджетов. Для этого отредактируйте ваш .gtkrc-2.0 (обычно он находится в вашем домашнем каталоге в UNIX-подобных системах и в подкаталоге etc при установке Geany в Windows).

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

widget "Geany*" style "geanyStyle"

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

• GeanyMainWindow
• GeanyEditMenu
• GeanyToolbarMenu
• GeanyDialog
• GeanyDialogPrefs
• GeanyDialogProject
• GeanyDialogSearch
• GeanyMenubar
• GeanyToolbar

Пример задания стиля шрифта .gtkrc-2.0:

style "geanyStyle"
{
    font_name="Sans 12"
}
widget "GeanyMainWindow" style "geanyStyle"

style "geanyStyle"
{
    font_name="Sans 10"
}
widget "GeanyPrefsDialog" style "geanyStyle"

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

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

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

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

Кодировки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<meta http-equiv="content-type" content="text/html; charset=ISO-8859-15" />

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

/* geany_encoding=ISO-8859-15 */

или:

# geany_encoding=ISO-8859-15 #

# и /* .... */ — примеры символов, указывающих на комментарий, который будет пропущен компилятором. Формат записи комментариев зависит от конкретного языка программирования; для нас сейчас ограничивающие символы не важны: кодировка указана подстрокой " geany_encoding=ISO-8859-15 " (в которую входят начальный и концевой пробелы). Кодировку ISO-8859-15 Geany постоянно принимает за ISO-8859-1; после вставки в файл приведенной подстроки файл будет открываться правильно.

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

Примеры:

# encoding = ISO-8859-15

или:

# coding: ISO-8859-15

Кодировка "None"

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

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

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

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

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

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

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

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

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

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

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

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

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

Отступы

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

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

ТАБ (TAB)

- с помощью символов табуляции.

ПРБ (SP)

- с помощью пробелов.

ТАБ/ПРБ (T/S)

- и табуляцией, и пробелами.

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

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

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

Пустой

- установка отступа отключена.

Базовый

- отступ следующей строки равен отступу предыдущей.

Текущие символы

- как Базовый, но, кроме того, строка с отступом делается после открывающей фигурной скобки '{', а при вводе закрывающей скобки '}' отступ убирается. Для языка Python роль открывающей скобки играет двоеточие ':' в конце строки.

Совмещать скобки

- как Текущие символы, но отступы для открывающей и закрывающей скобок одинаковы.

Закладки

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

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

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

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

• Объявления тегов
• Определения тегов
• Символы из списка
• Ошибки сборки
• Сообщения

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

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

Выделенный фрагмент текста можно переслать из Geany в другое приложение, записав соответствующую команду в диалоге "Установить пользовательские команды" ("Правка -> Форматирование" или контекстное меню). Эту функцию можно использовать, например, для передачи фрагмента кода в текстовый процессор, а после форматирования или какой-то дополнительной обработки назад в Geany. Передача выполняется командой "Правка->Форматирование->Отправить выделенное в". Выделенный текст посылается на стандартный вход stdin команды пересылки, результат обработки передается на стандартный выход stdout, откуда считывается назад в Geany и в итоге замещает сделанное выделение. Стандартный выход сообщений об ошибках внешней программы stderror также передается в stdout Geany, что поможет разобраться в случае появления ошибок обработки.

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

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

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

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

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

firefox "http://www.php.net/%s"

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

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

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

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

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

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

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

struct
{
    int i;
    char c;
} foo;

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

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

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

[Default]
myname=Enrico Trоеger

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

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

Общий файл конфигурации находится в каталоге $prefix/share/geany, где $prefix — каталог, в который установлен Geany (см. Префикс инсталляции). Не рекомендуется редактировать этот файл, поскольку при обновлении Geany он обновляется и внесенные изменения окажутся потеряны.

Для сохранения настроек скопируйте файл из $prefix/share/geany в свой каталог для конфигурационных файлов (обычно ~/.config/geany/).

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

% cp /usr/local/share/geany/snippets.conf /home/username/.config/geany/

Есть альтернатива: создать собственный конфигурационный файл ~/.config/geany/snippets.conf для своих настроек, при этом «стандартные» настройки Geany будет считывать из общего файла в $prefix/share/geany.

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

Для всех типов файлов действуют разделы "Default" и "Special" . Раздел "Special" отличается тем, что в нем хранятся сниппеты, применяемые только внутри других сниппетов. Благодаря этому можно создать общий сниппет - «шаблон», в котором вводить по мере надобности те или другие элементы (подробнее см. в snippets.conf).

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

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

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

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

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

[Default]
myname=My name is {developer}
mysystem=My system: {command:uname -a}

Условное слово 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.

Для GTK < 2.10 можно не нажимать Ctrl-Shift-u, но тогда возможны конфликты с другими клавишными определениями Geany.

Панель инструментов

На панели имеются форма поиска и форма для перехода к строке по номеру. Для перехода к этим инструментам имеются сочетания клавиш (см. Команды переноса фокуса). Клавиша Esc возвращает курсор в окно редактора.

Поиск

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

style "search_style"
{
    font_name="Monospace 8"
}
widget "GeanyDialogSearch.*.GtkEntry" style:highest "search_style"

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

Поиск использования ("Найти использование") охватывает все открытые файлы. Он подобен варианту "Найти все - В сессии" в диалоге поиска.

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

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

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

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

Замена

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

Заменить все

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

• В документе — в текущем документе
• В сессии — во всех открытых в данный момент документах
• В выделенном — в выделенном фрагменте текущего документа.

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

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

• C - GTK+ и GLib
• Pascal
• PHP
• HTML
• LaTeX
• Python

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

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

• Tagmanager
• Pipe-separated

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

Формат Tagmanager немного сложнее, он используется для файлов, создаваемых командой geany -g. Каждый тег помещается в новой строке, различные атрибуты (возвращаемое значение, список аргументов и др.) разделяются соответствующими символами.

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

basename|string|(string path [, string suffix])|

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

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

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

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

geany -g [-P] <Файл тегов> <Список файлов>

• Имя файла тегов должно отвечать приведенному выше формату.
• Список файлов — список имен файлов, которые следует дать с полными путями доступа (этого не требуется только в случае генерации тегов для C/C++ при соответствующим образом установленной переменной окружения CFLAGS).
• Ключ -P или -no-preprocessing при использовании препроцессора C отключает обработку директив #include для исходных текстов C/C++. Используйте такой вариант, если вы не хотите использовать общий заголовочный файл и будете вводить команду для каждого исходного файла, либо не хотите указывать переменную окружения CFLAGS.

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

geany -g wxd.d.tags /home/username/wxd/wx/*.d

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

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

Переменная окружения CFLAGS должна быть задана с правильными путями -I/path. Приводим пример для генерации тегов для библиотеки GnomeUI, работа в оболочке bash:

CFLAGS=`pkg-config -cflags libgnomeui-2.0` geany -g gnomeui.c.tags \
/usr/include/libgnomeui-2.0/gnome.h

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

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

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

Запуск

Загрузить файлы из последней сессии

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

Загружать виртуальный терминал

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

Включить поддержку модулей

Разрешить использование модулей.

Выход

Сохранять позицию и размеры окна

Сохранить размеры и положение окон.

Подтверждение выхода

Запрашивать подтверждение выхода.

Пути

Рабочий каталог при запуске

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

Файлы проекта

Путь к каталогу, который будет текущим для открытия файлов проектов.

Дополнительный путь для модулей

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

Разное

Сигнал об ошибках или по окончании сборки

Звуковой сигнал при завершении компиляции или в случае ошибки.

Перейти к дежурным сообщениях при появлении новых

При появлении нового сообщения о статусе Geany автоматически переключаться на окно сообщений

Подавлять вывод дежурных сообщений в строке состояния

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

Совет

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

Использовать диалоги Windows для сохранения/открытия файлов

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

Авто-фокус для виджетов (фокус следует за мышью)

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

Поиск

Всегда начинать поиск сначала и скрывать диалоговое окно поиска

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

Использовать слово под курсором для диалогов поиска

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

Использовать каталог текущего файла для "Найти в файлах"

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

Проекты

Использовать файлы сессий для проектов

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

Хранить файл проекта внутри основного каталога проекта

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

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

Показывать боковую панель

Показ боковой панели.

Отображать список тегов

Показ списка имен функций, переменных и другой информации о редактируемом документе.

Показывать список документов

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

Положение

Выбор положения боковой панели: слева или справа.

Шрифты

Редактор

Выбор шрифта для отображения документов в редакторе.

Список тегов

Выбор шрифта для списка имен в боковой панели.

Окно сообщений

Выбор шрифта для окна сообщений.

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

Показывать вкладки редактора текста

Показывать в редакторе закладки документов (позволяют выбирать документ щелчком мыши, не используя меню "Документ").

Показывать кнопки закрытия

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

Расположение новых вкладок

Выбор места для новых закладок при создании документов: слева или справа.

За текущей

Помещает закладку после закладки текущего документа, а не с краю.

Двойной щелчок скрывает все дополнительные окна

При двойном щелчке по полосе закладок скрывает дополнительные элементы управления (как команда Вид->Показать/Скрыть все панели).

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

Редактор

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

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

Выбор размещения закладок боковой панели.

Окно сообщений

Выбор размещения закладок окна сообщений.

Разное

Показ строки статуса

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

Панель

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

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

Добавить панель инструментов в меню

Объединить панель инструментов с меню, а не выводить ее ниже. Опция экономит рабочее пространство по вертикали.

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

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

Вид значков

Стиль панели инструментов

Выбор варианта показа значков: значки с текстом, одни значки или только текст. Вариант "Системные настройки" выбирает стиль, заданный в GTK.

Размер иконок

Размер значков: крупные, мелкие, очень мелкие. Вариант "Системные настройки" выбирает размер, заданный в GTK.

Опции

Перенос строк

Переносить длинные строки, отображая как несколько строк по ширине окна.

Использовать "умную" клавишу Home

При включенной опции первое нажатие клавиши Home перемещает курсор на первый непробельный символ текущей строки, повторное нажатие — на начало строки.

Отключить Drag&Drop

Отключение перетаскивания выделенного фрагмента мышью.

Включить сворачивание блоков кода

Разрешить скрытие групп строк «сворачиванием», что облегчает навигацию по длинному документу.

Сворачивать/разворачивать все вложенные элементы

При иерархическом сворачивании скрывать или раскрывать все вложенные уровни вместе с верхним.

Использовать индикаторы для показа ошибок при сборке

Красное подчеркивание строк, в которых компилятор выдал ошибки.

Новая строка убирает лишние пробелы

При завершении строки нажатием Enter/Return удалять концевые пробелы, если они есть.

Обрезать текст по столбцу

В заданной позиции автоматически обрывать строку и начинать новую.

Маркер переключения комментариев:

Помечать строки с комментариями в исходных текстах.

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

Тип

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

• Табуляция
• Пробелы
• — с помощью символов табуляции или пробелов.

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

Ширина

Ширина отступа в знакоместах (пробелах). По умолчанию 4.

Распознать по содержимому

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

Тип авто-отступа:

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

Базовый

Основной способ: отступ как в предыдущей строке.

Текущие символы

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

Совмещать скобки

По скобкам. Аналогично Текущие символы, но, например, для C-подобных языков закрывающая скобка } ставится с таким же отступом как открывающая.

Отступ при помощи клавиши Tab

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

Заметим, что

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

Завершения

Автозавершение фрагментов кода

Вставлять сниппеты. Набор предварительно определенных слов после табуляции будет приводить к замене этих слов текстовым фрагментом — сниппетом. См. Пользовательские фрагменты (сниппеты).

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

При вводе тега XML автоматически добавлять закрывающий тег.

Автоматическое продолжение многострочных коментариев

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

/*
 * Это многострочный коментарий, нажмите клавишу <Return>

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

*

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

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

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

Автозавершение всех слов в документе

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

Отбрасывать окончания слов при завершении

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

Количество символов, необходимых для автозавершения

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

Количество строк в списке завершения

Число строк, при котором будет выводиться окно автозавершения.

Максимальное количество предложений для имени тега

Максимальное число предлагаемых вариантов в списке автозавершения.

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

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

Скобки ( )

Автозакрытие круглых скобок.

Фигурные скобки { }

Автозакрытие фигурных скобок.

Угловые скобки [ ]

Автозакрытие квадратных скобок.

Одинарные ковычки ' '

Автозакрытие одинарных кавычек.

Двойные кавычки " "

Автозакрытие двойных кавычек.

Рабочее окно

Обратить цвета подсветки синтаксиса

При выделении инвертировать цвета (например, показывать белый цвет на черном фоне).

Показывать интикаторы отступа

Линии отступов. Показать вертикальные линии по размеру отступов, что поможет аккуратному вводу вручную следующих отступов.

Показывать пробелы

Показать пробелы. Знаки табуляции будут показаны стрелочками "->" пробелы точками.

Показывать окончания строк

Показать концы строк (символы CR - Carriage Return, «возврат каретки», или LF - Line Feed).

Показывать номера строк

Показывать на полях номера строк.

Отступ для маркера строк

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

Остановить прокрутку на последней строке

Останавливать прокрутку на последней строке документа.

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

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

Тип

Строка

Тонкая вертикальная линия в заданной позиции по длине строки.

Фон

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

Отключено

Отключить маркировку длинных строк.

Столбец

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

Цвет

Цвет для отметки длинных строк.

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

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

Отключено

Не показывать виртуальные пробелы (т.е. не пускать курсор дальше конца строки).

Только для выделения столбцом

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

Всегда

Всегда разрешать перемещение курсора за конец строки.

Новые файлы

Открывать новые документы из командной строки

Создавать новые документы при указании имен еще не существующих файлов в командной строке запуска Geany.

Кодировка по умолчанию (для новых файлов)

Кодировка, применяемая по умолчанию для новых файлов.

Использовать одну и ту же кодировку для открытия файлов формата отличного от Unicode

Считать все открываемые файлы с кодировкой отличной от Юникода имеющими одну кодировку, указанную ниже.

Кодировка по умолчанию (файлы с кодировкой отличной от Unicode)

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

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

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

Следить за наличием новой строки в конце файла

Если в конце документа нет пустой строки, она будет добавлена.

Убирать лишние пробелы и табуляции

Удалить из строк хвостовые пробелы.

Заменить табуляции пробелами

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

Заметим, что

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

Разное

Длина списка недавних файлов

Сколько файлов, с которыми вы работали раньше, показывать в списке Recent files.

Период проверки диска:

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

Заметим, что

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

Пути утилит - пути к исполняемым файлам программ:

Терминал

терминала,

Браузер

браузера (интернет-проводника),

Утилита grep

grep.

Команды

Контекстное действие

Контекстное действие. Здесь можно записать команду, параметром которой послужит текущее слово, представляемое в командной строке как "%s" .

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

Разработчик

Разработчик.

Инициалы

Его инициалы.

Электронная почта

Адрес e-mail.

Заметим, что

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

Компания

Компания.

Начальная версия

Начальная версия файла.

Дата; Дата и время

Форматы записи года, даты, даты и времени суток. Здесь можно использовать форматы, применяемых для функции ANSI C strftime. Подробнее см. в

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

Шрифт

Шрифт для окна терминала.

Цвет текста

Укажите цвет текста.

Цвет фона

Выбор цвета фона.

Прокручиваемые строки

Число строк в буфере прокрутки истории терминала.

Оболочка

Каталог, в котором находится системная оболочка.

Прокрутка по нажатию клавиши

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

Прокрутка по мере ввода

Прокрутка выдачи в окне вниз.

Мигающий курсор

Мигание курсора в окне терминала.

Переопределять сочетания клавиш Geany

Перехват терминалом клавишных команд (кроме команд установки фокуса).

Отключить горячую клавишу для меню (по умолчанию F10)

Отключить клавишу F10 входа в меню при работе с терминалом.

Следовать пути текущего файла

Изменять путь терминала в соответствии с путем к текущему файлу.

Выполнять программы в VTE

Исполнять в виртуальном терминале программы. Учтите, что при запуске нескольких программ их выдача в окне VTE может оказаться перемешана.

Не использовать скрипт для запуска

Не использовать скрипт отображения статуса выхода исполняемой программы. Это может быть полезно, если вы уже запустили в VTE программу подобную консоли Python. Используйте с осторожностью.

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

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

Компиляция

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

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

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

Сборка

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

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

Сделать

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

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

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

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

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

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

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

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

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

Выполнить

Команда запускает на исполнение собранный файл программы, или скрипт с оболочкой, или интерпретируемый скрипт в окне терминала. Путь к терминальной программе должен быть правильно задан в настройках на странице "Инструменты". Можно использовать любую терминальную программу, работающую в Bourne - совместимой оболочке и принимающую аргумент "-e" командной строки. Можно применять и встроенный виртуальный терминал VTE , см. Эмулятор виртуального терминала (VTE).

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

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

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

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

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

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

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

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

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

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

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

• %d - абсолютный путь к каталогу текущего файла,
• %e - имя текущего файла без пути и расширения,
• %f - имя текущего файла без пути,
• %p - если открыт проект, его базовый путь.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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