Предварительный просмотрщик: предварительный просмотр в реальном времени для режима Org.

Git-клиент: полностью многопоточный git-клиент для Emacs.

Менеджер файлов: полностью многопоточная замена для dired-режима.

... и многое другое (https://github.com/orgs/emacs-eaf/repositories)!

EAF в EmacsConf

Установка

EAF поддерживает Linux (X11 и Wayland), Windows, macOS и FreeBSD. Метод установки очень прост.

1. Скачайте EAF

git clone --depth=1 -b master https://github.com/emacs-eaf/emacs-application-framework.git ~/.emacs.d/site-lisp/emacs-application-framework/

2. Установите или обновите приложения EAF и зависимости

Вы можете использовать M-x eaf-install-and-update или вручную запустить скрипт install-eaf.py в каталоге EAF:

cd emacs-application-framework
chmod +x ./install-eaf.py
./install-eaf.py

Для скрипта install-eaf.py доступно множество полезных флагов, вы можете проверить их самостоятельно с помощью команды --help. Существует четыре типа поддержки среды Wayland:

• XWayland: EAF может работать непосредственно под XWayland;
• Gnome3 Wayland Native: вам нужно выполнить команду cp -r emacs-application-framework/gnome-shell/eaf-wayland@emacs-eaf.org ~/.local/share/gnome-shell/extensions и активировать плагин eaf-wayland@emacs-eaf.org в gnome-extensions;
• Sway Wayland Native: jq должен быть установлен;
• Hyprland Wayland Native. Поддержка среды Unity: требуется установить xdotool.

3. Загрузите ядро EAF

С этого момента вы можете добавить полный путь к каталогу установки EAF в ваш Emacs load-path, а затем добавить следующее в init.el:

(add-to-list 'load-path "~/.emacs.d/site-lisp/emacs-application-framework/")
(require 'eaf)

Или, если вы используете use-package, вы можете использовать следующую примерную конфигурацию для вашего удобства.

(use-package eaf
  :load-path "~/.emacs.d/site-lisp/emacs-application-framework"
  :custom
  ; See https://github.com/emacs-eaf/emacs-application-framework/wiki/Customization
  (eaf-browser-continue-where-left-off t)
  (eaf-browser-enable-adblocker t)
  (browse-url-browser-function 'eaf-open-browser)
  :config
  (defalias 'browse-web #'eaf-open-browser)
  (eaf-bind-key scroll_up "C-n" eaf-pdf-viewer-keybinding)
  (eaf-bind-key scroll_down "C-p" eaf-pdf-viewer-keybinding)
  (eaf-bind-key take_photo "p" eaf-camera-keybinding)
  (eaf-bind-key nil "M-q" eaf-browser-keybinding)) ;; unbind, see more in the Wiki

4. Загрузите приложения EAF

Вы можете использовать следующий код для загрузки приложений browser и pdf-viewer, которые вы установили. Полный список см. в разделе «Приложения» (https://github.com/emacs-eaf/emacs-application-framework#features):

(require 'eaf-browser)
(require 'eaf-pdf-viewer)

5. Ура!

Поздравляем, вы только что установили EAF! Вы можете попробовать M-x eaf-open-demo (если у вас установлено demo, конечно), чтобы убедиться, что всё работает правильно, и насладиться новыми возможностями Emacs. Ниже приведены команды запуска приложений EAF. | Браузер | M-x eaf-open-browser — поиск или переход по URL | | --- | --- | | HTML Email Renderer | M-x eaf-open-mail-as-html в gnus, mu4e, notmuch — HTML-почта | | PDF Viewer | M-x eaf-open — файл PDF | | Видеоплеер | M-x eaf-open — видеофайл | | Просмотрщик изображений| M-x eaf-open — изображение | | Предварительный просмотр Markdown| M-x eaf-open — файл Markdown, выберите markdown-previewer| | Предварительный просмотр Org| M-x eaf-open — файл Org, выберите org-previewer | | Камера | M-x eaf-open-camera | | Терминал | M-x eaf-open-pyqterminal | | Файловый менеджер | M-x eaf-open-in-file-manager | | RSS-ридер | M-x eaf-open-rss-reader | | Git-клиент | M-x eaf-open-git | | Планирование маршрута на карте| M-x eaf-open-map | | Отправитель файлов | M-x eaf-file-sender-qrcode или eaf-file-sender-qrcode-in-dired | | Браузер файлов | M-x eaf-file-browser-qrcode | | Airshare | M-x eaf-open-airshare | | Markmap | M-x eaf-open — файл Markdown или Org, выберите markmap | | Mindmap | M-x eaf-create-mindmap или M-x eaf-open-mindmap | | MS Office Viewer | M-x eaf-open-office | | Jupyter | M-x eaf-open-jupyter | | Музыкальный плеер | M-x eaf-open-music-player | | Системный монитор | M-x eaf-open-system-monitor | | Демо | M-x eaf-open-demo для проверки базовой функциональности | | Vue Demo | M-x eaf-open-vue-demo для проверки функциональности vue.js |

— Браузер и просмотрщик PDF поддерживают встроенную функцию закладок Emacs с помощью команд M-x bookmark-set (по умолчанию C-x r m) и M-x bookmark-bmenu-list (по умолчанию C-x r l).

Обновление

Также вам следует регулярно выполнять git pull и запускать install-eaf.py (M-x eaf-install-and-update), чтобы обновлять EAF, его приложения и связанные зависимости.

Сообщить об ошибке

Для получения помощи по установке и настройке обратитесь к Вики и FAQ.

Если у вас возникли проблемы с EAF и они появились после извлечения последнего коммита, пожалуйста, сначала ознакомьтесь со страницей «Обязательные процедуры для поддержания актуальности EAF» (https://github.com/emacs-eaf/emacs-application-framework/discussions/527?sort=new).

Для любых других проблем, пожалуйста, используйте emacs -q и загрузите минимальную настройку только с EAF, чтобы убедиться, что ошибка воспроизводима. Если emacs -q работает нормально, возможно, что-то не так с вашей конфигурацией Emacs.

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

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

1. Установите gdb и включите опцию (setq eaf-enable-debug t).
2. Используйте команду eaf-stop-process, чтобы остановить текущий процесс.
3. Перезапустите eaf, отправьте проблему с содержимым eaf при следующем сбое.

EAF в сообществе

Список других пакетов сообщества, использующих EAF для улучшения графического интерфейса! Пропущен ваш пакет, пожалуйста, создайте PR, чтобы добавить его в список.

• obr-viz: визуализация отношений org-brain с использованием EAF.
• netease-cloud-music: музыкальный клиент netease для emacs.
• 2048pyqt6: игра 2048, которая может работать в emacs.
• pyqterminal: терминал, написанный на PyQt6.

Contributor

Присоединяйтесь к нам

Хотите сделать Emacs настоящей «операционной системой»?

Хотите жить в Emacs более комфортно?

Хотите революционизировать возможности Emacs?

Давайте вместе создадим что-то новое!