Интерактивное использование

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

Цвета, используемые fish для подсветки синтаксиса, можно настроить, изменив значения различных переменных. Значение этих переменных может быть одним из цветов, принимаемых командой set_color. Также принимаются переключатели модификаторов, принимаемые set_color, такие как --bold, --dim, --italics, --reverse и --underline.

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

set fish_color_error red --bold

Следующие переменные доступны для изменения цветов подсветки в fish:

Если переменная не установлена или пуста, fish обычно пытается $fish_color_normal, за исключением:

• $fish_color_keyword, где сначала пытается $fish_color_command.
• $fish_color_option, где сначала пытается $fish_color_param.
• Для $fish_color_valid_path, если у него нет цвета, а только модификаторы, он добавляет их к цвету, который в противном случае использовался бы, например $fish_color_param. Но если у допустимых путей есть цвет, он использует его и добавляет модификаторы из другого цвета.

Переменные цвета средства просмотра

fish иногда представляет список вариантов в таблице, называемой средством просмотра.

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

set fish_pager_color_background --background=white

Чтобы иметь черный текст на чередующихся белых и серых фонах:

set fish_pager_color_prefix black
set fish_pager_color_completion black
set fish_pager_color_description black
set fish_pager_color_background --background=white
set fish_pager_color_secondary_background --background=brwhite

Переменные, влияющие на цвета средства просмотра:

Когда вторичные или выбранные переменные не установлены или пусты, используются обычные переменные, за исключением $fish_pager_color_selected_background, где сначала пытается фон $fish_color_search_match.

Общие привязки

Некоторые привязки являются общими для режимов Emacs и Vi, потому что они не являются привязками к редактированию текста, или потому что действия Vi/Vim для конкретной клавиши не имеют смысла для оболочки.

• Tab завершает текущий токен. Shift+Tab завершает текущий токен и запускает режим поиска в просмотрщике. Tab эквивалентно Control+I.
• ← (влево) и → (вправо) перемещают курсор влево или вправо на один символ. Если курсор уже находится в конце строки, а доступна автоматическая подсказка, → принимает автоматическую подсказку.
• Enter выполняет текущую командную строку или вставляет символ новой строки, если она ещё не завершена (например, отсутствует ) или end).
• Alt+Enter вставляет символ новой строки в позиции курсора.
• Alt+← и Alt+→ перемещают курсор на одно слово влево или вправо (к следующему пробелу или знаку препинания) или перемещает вперёд/назад в истории каталогов, если командная строка пустая. Если курсор уже находится в конце строки, и доступна автоматическая подсказка, Alt+→ (или Alt+F) принимает первое слово в подсказке.
• Control+← и Control+→ перемещают курсор на одно слово влево или вправо. Эти сочетания принимают одно слово из автоматической подсказки — ту часть, по которой они перемещаются.
• Shift+← и Shift+→ перемещают курсор на одно слово влево или вправо, не останавливаясь на знаках препинания. Эти сочетания принимают одно большое слово из автоматической подсказки.
• ↑ (вверх) и ↓ (вниз) (или Control+P и Control+N для любителей Emacs) ищут в истории команд предыдущую/следующую команду, содержащую строку, указанную в командной строке до начала поиска. Если командная строка была пустой при старте поиска, все команды подходят. См. раздел история для получения дополнительной информации о поиске в истории.
• Alt+↑ и Alt+↓ ищут в истории команд предыдущий/следующий токен, содержащий токен под курсором до начала поиска. Если командная строка не находилась на токене при старте поиска, все токены подходят. См. раздел история для получения дополнительной информации о поиске в истории.
• Control+C прерывает/уничтожает выполняемое действие (SIGINT).
• Control+D удаляет один символ справа от курсора. Если командная строка пустая, Control+D завершит работу fish.
• Control+U удаляет содержимое от начала строки до курсора (перемещая его в буфер обмена).
• Control+L очищает и перерисовывает экран.
• Control+W удаляет предыдущий компонент пути (всё до предыдущего “/”, “:” или “@”) (перемещая его в буфер обмена).
• Control+X копирует текущий буфер в буфер обмена системы, Control+V вставляет содержимое буфера обмена. (см. fish_clipboard_copy и fish_clipboard_paste)
• Alt+D перемещает следующее слово в буфер обмена.
• Alt+H (или F1) отображает страницу справки для текущей команды, если она существует.
• Alt+L отображает содержимое текущего каталога, если курсор не установлен на аргументе каталога; в этом случае будет отображено содержимое этого каталога.
• Alt+O открывает файл в позиции курсора в просмотрщике.
• Alt+P добавляет строку &| less; в конец задания под курсором. В результате вывод команды будет отображаться в просмотрщике.
• Alt+W выводит краткое описание команды под курсором.
• Alt+E редактирует текущую командную строку в внешнем редакторе. Редактор выбирается из первого доступного из переменных $VISUAL или $EDITOR.
• Alt+V То же, что и Alt+E.
• Alt+S Добавляет sudo к началу текущей командной строки. Если командная строка пуста, добавит sudo к последней командной строке.
• Control+Space Вставляет пробел без раскрытия сокращения. Для режима vi это относится только к режиму вставки.

Команды режима Emacs

Для включения режима Emacs используйте fish_default_key_bindings. Это также значение по умолчанию.

• Home или Control+A перемещает курсор в начало строки.
• End или Control+E перемещает курсор в конец строки. Если курсор уже находится в конце строки, и доступна автоподсказка, End или Control+E принимает автоподсказку.
• Control+B, Control+F перемещают курсор на один символ влево или вправо или принимают автоподсказку, подобно общим привязанностям ← (влево) и → (вправо) (которые также доступны).
• Control+N, Control+P перемещают курсор вверх/вниз или по истории, как и общие привязанности стрелок вверх и вниз.
• Delete или Backspace удаляют по одному символу вперед или назад соответственно. Это также относится к Control+H, которое неотличимо от backspace.
• Alt+Backspace удаляет одно слово назад.
• Alt+< перемещает в начало командной строки, Alt+> перемещает в конец.
• Control+K удаляет от курсора до конца строки (перемещая его в Буфер обмена (Кольцо вырезания)).
• Alt+C делает текущее слово заглавным.
• Alt+U делает текущее слово заглавным.
• Control+T меняет местами последние два символа.
• Alt+T меняет местами последние два слова.
• Control+Z, Control+_ (Control+/ на некоторых терминалах) отменяет последнее изменение строки.
• Alt+/ отменяет последнюю отмену.
• Control+R открывает историю в просмотрщике. Это отобразит записи истории, соответствующие поиску, несколько за раз. Нажатие Control+R еще раз выполнит поиск более ранних записей, нажатие Control+S (в противном случае переключает поиск в просмотрщике) перейдет к более новым записям. Поле поиска всегда будет выделено.

Вы можете изменить эти привязки клавиш с помощью встроенной команды bind.

Команды режима Vi

Режим Vi позволяет использовать команды, похожие на команды Vi, в командной строке. Изначально активен режим вставки. Escape переключает в режим команд. Ниже описаны доступные команды в режимах команд, вставки и визуального режима. Режим Vi разделяет некоторые привязки с режимом Emacs.

Для включения режима vi используйте fish_vi_key_bindings.

Также можно добавить все привязки emacs-режима к vi-режиму, используя что-то вроде:

function fish_user_key_bindings
    # Execute this once per mode that emacs bindings should be used in
    fish_default_key_bindings -M insert

    # Then execute the vi-bindings so they take precedence when there's a conflict.
    # Without --no-erase fish_vi_key_bindings will default to
    # resetting all bindings.
    # The argument specifies the initial mode (insert, "default" or visual).
    fish_vi_key_bindings --no-erase insert
end

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

При переключении режима привязкой, индикатор режима будет перерисован, если он существует, а остальная часть строки перерисовывается только если он отсутствует. Если вы хотите индикатор режима в fish_prompt, вам нужно стереть fish_mode_prompt, например, добавив пустой файл по адресу ~/.config/fish/functions/fish_mode_prompt.fish. (Привязки, меняющие режим, должны вызывать функцию привязки repaint-mode, см. bind).

Функция fish_vi_cursor будет использоваться для изменения формы курсора в зависимости от режима в поддерживаемых терминалах. Следующий фрагмент кода можно использовать для ручного конфигурирования курсоров после включения vi-режима:

# Emulates vim's cursor shape behavior
# Set the normal and visual mode cursors to a block
set fish_cursor_default block
# Set the insert mode cursor to a line
set fish_cursor_insert line
# Set the replace mode cursor to an underscore
set fish_cursor_replace_one underscore
# The following variable can be used to configure cursor shape in
# visual mode, but due to fish_cursor_default, is redundant here
set fish_cursor_visual block

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

Если форма курсора не меняется после установки вышеперечисленных переменных, скорее всего, ваш эмулятор терминала не поддерживает необходимые возможности для этого. Также возможно, что fish_vi_cursor некорректно определил возможности вашего терминала (например, если вы используете tmux). В этом случае вы можете принудительно заставить fish_vi_cursor установить форму курсора, установив $fish_vi_force_cursor в config.fish. Для применения изменений необходимо перезапустить fish. Если проблема с формой курсора сохранится после этого, это почти наверняка проблема с вашим эмулятором терминала, а не с fish.

Настраиваемые привязки

Помимо стандартных привязок, перечисленных здесь, вы также можете определить свои собственные с помощью bind:

# Just clear the commandline on control-c
bind \cc 'commandline -r ""'

Поместите bind в config.fish или в функцию с именем fish_user_key_bindings.

Последовательность нажатий клавиш (\cc) зависит от вашей настройки, в частности от терминала. Чтобы узнать, что отправляет терминал, используйте fish_key_reader:

> fish_key_reader # pressing control-c
Press a key:
Press [ctrl-C] again to exit
bind \cC 'do something'

> fish_key_reader # pressing the right-arrow
Press a key:
bind \e\[C 'do something'

Обратите внимание, что некоторые сочетания клавиш неразличимы или непривязываемы. Например, control-i то же самое, что и клавиша ввода табуляции. Это ограничение терминала, и fish не может с этим ничего поделать.

Также, Escape — то же самое, что и Alt в терминале. Чтобы отличить нажатие Escape и затем другой клавиши от нажатия Alt и этой клавиши (или последовательности символов, которую эта клавиша отправляет), fish ожидает определённое время после того, как увидит символ escape. Это настраивается через переменную fish_escape_delay_ms.

Если вы хотите, чтобы нажатие Escape и затем символа считалось нажатием Alt + этого символа, установите его значение больше, например:

set -g fish_escape_delay_ms 100

Копирование и вставка (Кольцо вырезания)

Fish использует кольцо вырезания в стиле Emacs для функций копирования и вставки. Например, используйте Control+K (kill-line) для вырезания от текущей позиции курсора до конца строки. Строка, которая вырезана (также известная как «убитая» в Emacs), вставляется в список вырезаний, называемый кольцом вырезания. Чтобы вставить последнее значение из кольца вырезания (Emacs называет это «вытягиванием»), используйте Control+Y (функция ввода yank). После вставки используйте Alt+Y (yank-pop) для вращения к предыдущему вырезанному элементу.

Также поддерживается копирование и вставка извне, как через сочетания Control+X / Control+V (функции fish_clipboard_copy и fish_clipboard_paste [2]), так и через функцию вставки терминала, для которой fish включает «Режим вставки в скобках», чтобы отличать вставку от вводимого вручную текста. Кроме того, при вставке внутри одинарных кавычек вставленные одинарные кавычки и обратные слэши автоматически экранируются, чтобы результат можно было использовать как один токен, просто закрыв кавычку после. Элементы кольца вырезания хранятся в переменной fish_killring.

Команды begin-selection и end-selection (по умолчанию не привязаны; используются для выделения в режиме визуального редактирования vi) управляют выделением текста вместе с командами перемещения курсора, которые расширяют текущее выделение. Переменная fish_cursor_selection_mode может использоваться для настройки включения в выделение символа под курсором (inclusive) или нет (exclusive). По умолчанию exclusive, что хорошо подходит для любого вида курсора. Для режима vi, и особенно для форм курсора block или underscore, возможно, вы предпочтёте inclusive.

Редактирование многострочных команд

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

• Нажатие клавиши Enter при незакрытом блоке команд, например, когда одна или несколько команд, таких как for, begin или if, не имеют соответствующей команды end.
• Нажатие Alt+Enter вместо Enter.
• Вставка символа обратного слэша (\) перед нажатием Enter, что экранирует символ новой строки.

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

Поисковая история команд

После выполнения команды она запоминается в списке истории. Любые дублирующие элементы истории автоматически удаляются. Нажав клавиши вверх и вниз, вы можете просматривать историю вперёд и назад. Если текущая строка команд не пустая при запуске поиска по истории, отображаются только команды, содержащие введенную в строку команд строку.

Нажимая Alt+↑ и Alt+↓, также выполняется поиск по истории, но вместо поиска всей строки команды каждая строка разбивается на отдельные элементы так же, как перед выполнением, и история просматривается на предмет соответствия элементу под курсором.

Для более сложных поисков вы можете нажать Ctrl+R, чтобы открыть средство просмотра, позволяющее искать в истории. Оно отображает ограниченное количество записей на странице, нажмите Ctrl+R [3] снова, чтобы перейти к следующей странице, и Ctrl+S [4] — чтобы перейти к предыдущей. Вы можете изменить текст, чтобы уточнить поиск.

Поиск по истории регистронезависимый, если в строке поиска нет заглавных букв. Вы можете остановить поиск, чтобы отредактировать строку поиска, нажав Esc или Page Down.

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

Журнал истории по умолчанию хранится в файле ~/.local/share/fish/fish_history (или $XDG_DATA_HOME/fish/fish_history, если эта переменная установлена). Однако вы можете установить переменную среды fish_history, чтобы изменить имя сессии истории (что приведёт к созданию файла <session>_history); как перед запуском оболочки, так и во время её работы.

См. команду history для других манипуляций.

Примеры:

Чтобы найти предыдущие записи, содержащие слово «make», введите make в консоли и нажмите клавишу вверх.

Если в строке команд отображается cd m, поместите курсор на символ m и нажмите Alt+↑, чтобы найти ранее введённые слова, содержащие «m».

История каталогов

Fish автоматически сохраняет историю посещённых каталогов с помощью cd, сохраняя эту историю в переменных dirprev и dirnext.

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

• dirh выводит историю
• cdh отображает приглашение для быстрого перехода по истории
• prevd перемещается назад по истории. Привязано к Alt+←
• nextd перемещается вперёд по истории. Привязано к Alt+→

Стек каталогов

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

• dirs выводит стек
• pushd добавляет каталог на вершину стека и делает его текущим рабочим каталогом
• popd удаляет каталог с вершины стека и изменяет текущий рабочий каталог