separedit.el: 在单独的缓冲区编辑注释、docstring 或其中的代码块

Emacs-general
31

可以加一个 feature 吗？

例如这样

class Foo {
    /// 这是一个加一操作
    /// 当前 buffer 的 fill-column 为 80, 如果在 comment-edit 编辑时，自动计算
    /// 好 comment-edit 里的 fill-column 为 80 - (4空格 + 3个/ + 1个空格) = 72
    /// 这样只需要在 comment-edit 的 buffer 里调用一下 fill-paragraph 就可以排版好而无需写完
    /// documentation comment 之后再排版一下。
    int add1(int x) {
        return x + 1;
    }
};
32

你把这个 feature request: adjust `fill-column' in comment edit buffer · Issue #3 · twlz0ne/separedit.el · GitHub 重新打开。

我稍后看看怎么实现。

33

lentic后来我也放弃了，有一些特殊情况需要注意，每次都用的小心翼翼。。。

34

我是习惯直接在el文件中裸写 org 格式的 commentary 然后生成 readme.md

2 个赞
35

功能已经好了，待我明天提交。

用法是这样：

(require 'comment-edit)

;; 继续源 buffer 没有用完的 fill-column 宽度
(setq comment-edit-continue-fill-column t)

;; 在 hook 中决定如何使用 fill-column 或者做更多的事
(add-hook 'comment-edit-buffer-creation-hook #'auto-fill-mode)

剩余 fill-column 有可能计算错误，这取决于快首空白行的情况。如需修正，也可以自行在 hook 中完成。

2 个赞
36

增加了手动选择编模式的支持。

例如想要把字符串 "console.log(\"foo\") 当作 js 代码编辑，然而当前上下文没有足够的信息让 comment-edit 去猜测该使用何种模式。

这时就需要手动模式了，按 C-u C-c ’ 即可在进入编辑之前选择模式。

37

改名之心日盛。

昨晚一不小心又通宵了，顺便想了几个名称：

  • transient-edit 表示短暂离开当前模式，临时进入到另一种编辑状态
  • separedit 取 separate 前半部，表示隔离、分开编辑的意思
  • ripedit 表示把内容剥离出来编辑

目前比较满意的是 separedit，应该不会有歧义。

38

期待上 melpa

39

commented

40

Org-mode 的快捷键是 C-c ' 进入代码块的编辑模式，在编辑模式中按 C-c ' 完成编辑。

看能不能兼容一下，或者可以方便这样子定制。

41

目前这个包就是这么设计的，因为要考虑到在 edit buffer 中再打开 edit buffer 再打开 edit buffer…，所以【进入】和【退出】分别采用不同的按键。

如果你不需要嵌套进入，你可以试着改一下。

42

现在这个模式跟 magit 的操作方式是一样的，我觉得挺好的。 都是 C-c C-c 提交， C-c C-k 取消

43

没办法，个人使用时的心理模型跟 org-mode 的 source code 编辑一样，平时操作起来按 快捷键是靠肌肉记忆，hack 了一下基本上跟 org-mode 一样了：

(defun my/ad-comment-edit (orig-fun &optional block)
  (if (string-prefix-p "*edit-indirect " (buffer-name))
      (progn
        (if (buffer-modified-p)
            (edit-indirect-commit)
          (edit-indirect-abort)))
    (funcall orig-fun block)))
(advice-add 'comment-edit :around 'my/ad-comment-edit)

另外，我感觉如果出现嵌套编译注释的情况，就该反思是不是注释写得太复杂了，快捷键一 般来讲应该是为常用直观的场景进行设置，如果不常用估计也记不住。

1 个赞
44

已更名为 separedit.el

45

注释／文档中嵌代码块很常见，所以必须保证功能上可以应对这种情况，具体用什么键在其次。

另外，进入／提交／中断这几个键都是可定制的，不需要 advice：

1 个赞
46

似乎在 indirect buffer 里 markdown-mode-map 是不生效的？ 这个带来的一个问题是，在 markdown-mode-map 里熟悉的按键绑定没有了…… 通过手工开启 markdown-mode 似乎可以解决，不知道这是有意为之还是其他原因呢？

47

的确存在这个问题。因为此时的 keymap 都被覆盖了。但是如果直接 M-x markdown-mode 又会破坏编辑环境的设定。

我改了按键绑定，你获取新代码试试看。

48

试用了一下，可以了。 markdown-mode 的绑定可以使用了

49

改了之后出现新问题了，不该这么仓储推上去。

已修复，并写了测试，以后再怎么改都不会跑偏了。

50

其实我更好奇，什么代码的注释还有那么多代码