Если требуется добавить новое сочетание клавиш для какого-либо действия в ipython-notebook
, достаточно добавить соответствующую запись в файл <profile>/static/custom/custom.js
своего профиля, где <profile>
- это путь к настройкам профиля ipython.
По умолчанию ipython
запускается под стандартным профилем, настройки которого обычно расположены по адресу ~/.ipython/profile_default/
.
Открываем соответствующий файл custom.js
в любом редакторе и добавляем действие при загрузке ipython notebook
(для примера назначим клавиши Shift-j
и Shift-k
командам "опустить ячейку" и "поднять ячейку" соответственно):
$([IPython.events]).on('app_initialized.NotebookApp', function() {
IPython.keyboard_manager.command_shortcuts.add_shortcut(
'shift-j',
'ipython.move-selected-cell-down');
IPython.keyboard_manager.command_shortcuts.add_shortcut(
'shift-k',
'ipython.move-selected-cell-up');
});
В первой строке мы добавили анонимную функцию, которая будет запущена при старте ipython notebook
.
В ней происходит добавление двух сочетаний клавиш для стандартных действий с помощью метода add_shortcut
объекта IPython.keyboard_manager.command_shortcuts
.
В метод add_shortcut
в простейшем случае передаются две строки. Первая соответствует сочетанию клавиш, а вторая отвечает за действие по этому сочетанию.
Объект IPython.keyboard_manager.command_shortcuts
отвечает за сочетания клавиш в командном режиме. Если требуется добавить сочетание в режим редактирования, используйте объект IPython.keyboard_manager.edit_shortcuts
Список всех стандартных действий (и соответствующих им строк) я нашёл только в исходном коде jupyter
. Важно помнить, что названия стандартных действий должны иметь префикс ipython.
, как в примере выше.
Как я понял, отсутствие официальной документации аргументируется тем, что IPython JavaScript API постоянно изменяется.
Также существует расширенное создание действий на сочетание клавиш: вторым аргументом функции add_shortcut
вместо строки можно передать объект со следующими полями:
help
: строка, которая будет показываться в справке по всем сочетаниям клавиш.
help_index
: строка (по умолчанию zz
), в соответствии с которой осуществляется сортировка сочетаний клавиш в справке.
handler
: функция, принимающая один аргумент (объект event
), описывающая действие по сочетанию клавиш.
Если эта функция возвращает false
, то обработка сочетания клавиш будет на этом завершена, а также не будет вызвана обработка по умолчанию (обычно и возвращают false
). Подробнее в документации по обработке событий jQuery.
Посмотрим на примере, как это выглядит:
IPython.keyboard_manager.command_shortcuts.add_shortcut('shift-j', {
help : 'move cell down',
help_index : 'zz',
handler : function(event) {
IPython.notebook.move_cell_down();
return false;
}}
);
Это второй, известный мне, и более общий способ добавить действие по сочетанию клавиш.
Источники: