我稍后看看怎么实现。
lentic后来我也放弃了,有一些特殊情况需要注意,每次都用的小心翼翼。。。
我是习惯直接在el文件中裸写 org 格式的 commentary 然后生成 readme.md
功能已经好了,待我明天提交。
用法是这样:
(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 中完成。
增加了手动选择编模式的支持。
例如想要把字符串 "console.log(\"foo\")
当作 js 代码编辑,然而当前上下文没有足够的信息让 comment-edit
去猜测该使用何种模式。
这时就需要手动模式了,按 C-u C-c ’ 即可在进入编辑之前选择模式。
改名之心日盛。
昨晚一不小心又通宵了,顺便想了几个名称:
-
transient-edit
表示短暂离开当前模式,临时进入到另一种编辑状态 -
separedit
取 separate 前半部,表示隔离、分开编辑的意思 -
ripedit
表示把内容剥离出来编辑
目前比较满意的是 separedit
,应该不会有歧义。
期待上 melpa
commented
Org-mode 的快捷键是 C-c '
进入代码块的编辑模式,在编辑模式中按 C-c '
完成编辑。
看能不能兼容一下,或者可以方便这样子定制。
目前这个包就是这么设计的,因为要考虑到在 edit buffer 中再打开 edit buffer 再打开 edit buffer…,所以【进入】和【退出】分别采用不同的按键。
如果你不需要嵌套进入,你可以试着改一下。
现在这个模式跟 magit
的操作方式是一样的,我觉得挺好的。
都是 C-c C-c
提交, C-c C-k
取消
没办法,个人使用时的心理模型跟 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)
另外,我感觉如果出现嵌套编译注释的情况,就该反思是不是注释写得太复杂了,快捷键一 般来讲应该是为常用直观的场景进行设置,如果不常用估计也记不住。
已更名为 separedit.el
注释/文档中嵌代码块很常见,所以必须保证功能上可以应对这种情况,具体用什么键在其次。
另外,进入/提交/中断这几个键都是可定制的,不需要 advice:
似乎在 indirect buffer
里 markdown-mode-map
是不生效的?
这个带来的一个问题是,在 markdown-mode-map
里熟悉的按键绑定没有了……
通过手工开启 markdown-mode
似乎可以解决,不知道这是有意为之还是其他原因呢?
的确存在这个问题。因为此时的 keymap 都被覆盖了。但是如果直接 M-x markdown-mode
又会破坏编辑环境的设定。
我改了按键绑定,你获取新代码试试看。
试用了一下,可以了。
markdown-mode
的绑定可以使用了
改了之后出现新问题了,不该这么仓储推上去。
已修复,并写了测试,以后再怎么改都不会跑偏了。
其实我更好奇,什么代码的注释还有那么多代码
有的项目的文档直接写在注释里,码/档分离比较容易脱节。
文档里除了叙述性的文字,示范代码也是很重要的。有了示范代码,还可以在转成 html 之后,给读者提供一个可修改/运行的沙盒。