Как отобразить наложение, как этот скринкаст?

10

Как сделать наложение в Emacs следующим образом (возможно, это не наложение, я не знаю, это из company-coq inline-docs):

наложение как этот скринкаст

stardiviner
источник

Ответы:

8

Действительно, такое поведение достигается с помощью оверлеев. В частности, он использует 'after-stringсвойство для отображения документации (см .: Свойства наложения ).

Если вы изучите функцию company-coq--show-definition-overlay-at-point(например: via M-x find-function), вы увидите, как именно она создана:

(setq company-coq-definition-overlay (make-overlay ins-pos ins-pos))
(overlay-put company-coq-definition-overlay 'after-string ins-str)

Ссылка на оверлей сохраняется, company-coq-definition-overlayчтобы потом было легче удалить оверлей:

(delete-overlay company-coq-definition-overlay)
(setq company-coq-definition-overlay nil)
ebpa
источник
С (overlay-put OVERLAY 'after-string STR)не имеет фонтифа как в скринкасте.
stardiviner
@stardiviner вас интересуют конкретные символы / цвета / стиль? Вы можете использовать edebug для проверки строки ins-strв company-coq--show-definition-overlay-at-point. Конкретные грани и стили будут существовать как текстовые свойства в этой строке. Свойства текста: Специальные свойства - полезная ссылка для декодирования этих свойств.
ebpa
1
(defvar inline-docs-overlay nil)

(defgroup inline-docs nil
  "Show inline contextual docs in Emacs."
  :group 'docs)

(defcustom inline-docs-border-symbol ?―
  "Specify symbol for inline-docs border."
  :group 'inline-docs)

(defcustom inline-docs-prefix-symbol ?\s
  "Specify symbol for inline-docs prefix."
  :group 'inline-docs)

(defcustom inline-docs-indicator-symbol "➜"
  "Specify symbol for inline-docs indicator."
  :group 'inline-docs)

(defface inline-docs-face
  '((t (:inherit italic)))
  "Face for `inline-docs-mode'."
  :group 'inline-docs)

(defface inline-docs-border-face
  '((t (:inherit font-lock-doc-face)))
  "Face for inline docs border lines."
  :group 'inline-docs)

(defface inline-docs-prefix-face
  '((t (:inherit default)))
  "Face for inline docs prefix."
  :group 'inline-docs)

(defface inline-docs-indicator-face
  '((t (:inherit font-lock-doc-face)))
  "Face for inline docs indicator."
  :group 'inline-docs)

(defun inline-docs--clear-overlay ()
  "Clear inline-docs overlays."
  (when (overlayp inline-docs-overlay)
    (delete-overlay inline-docs-overlay))
  (remove-hook 'post-command-hook 'inline-docs--clear-overlay))

(defun inline-docs--string-display-next-line (string apply-face)
  "Show STRING contents below point line until next command with APPLY-FACE."
  (let* ((border-line (make-string (window-body-width) inline-docs-border-symbol))
         (prefix (make-string
                  (if (= (current-indentation) 0) ; fix (wrong-type-argument wholenump -1) when current indentation is 0 minus 1 will caused wholenump exception.
                      (current-indentation)
                    (- (current-indentation) 1))
                  inline-docs-prefix-symbol))
         (str (concat (propertize border-line
                                  'face 'inline-docs-border-face)
                      "\n"
                      prefix
                      (propertize (concat inline-docs-indicator-symbol " ")
                                  'face 'inline-docs-indicator-face)
                      (copy-sequence string) ; original eldoc string with format.
                      "\n"
                      (propertize border-line
                                  'face 'inline-docs-border-face)
                      "\n"
                      ))
         start-pos end-pos)
    (unwind-protect
        (save-excursion
          (inline-docs--clear-overlay)
          (forward-line)
          (setq start-pos (point))
          (end-of-line)
          (setq end-pos (point))
          (setq inline-docs-overlay (make-overlay start-pos end-pos (current-buffer)))
          ;; change the face
          (if apply-face
              (overlay-put inline-docs-overlay 'face 'inline-docs-face))
          ;; hide full line
          ;; (overlay-put inline-docs-overlay 'display "")
          ;; (overlay-put inline-docs-overlay 'display :height 20)
          ;; pre-pend indentation spaces
          ;; (overlay-put inline-docs-overlay 'line-prefix prefix)
          ;; auto delete overlay
          (overlay-put inline-docs-overlay 'evaporate t)
          ;; display message
          (overlay-put inline-docs-overlay 'before-string str))
      (add-hook 'post-command-hook 'inline-docs--clear-overlay))))

(defun inline-docs-display-docs-momentary (format-string &rest args)
  "Display inline docs FORMAT-STRING under point with extra ARGS."
  (when format-string
    (inline-docs--string-display-next-line
     (apply 'format format-string args)
     t)))

;;;###autoload
(defalias 'inline-docs 'inline-docs-display-docs-momentary)

Я создал для этого репозиторий , https://github.com/stardiviner/inline-docs.el и модуль, который используется inline-docs.elдля eldoc. https://github.com/stardiviner/eldoc-overlay-mode .

stardiviner
источник
Было бы неплохо иметь его в качестве модуля общего назначения, чтобы его можно было использовать не только для eldoc, но и для другой «modeline quickinfo».
Телдория
Я вижу, я создам общий режим для этого, затем создам отдельный режим для eldoc.
stardiviner