Folding

From WikEmacs
Jump to navigation Jump to search

Folding is a way to hide and show text in an emacs buffer, i.e. to do code folding. For example, we can do the same thing as with org-mode but with source code.

You may look at the differences between narrowing and hiding text in Emacs : http://wikemacs.org/index.php/Emacs_Terminology#Narrow_and_widen

Outline-minor-mode

outline is a built in mode to cycle visibility and edit the code structure. You should check it out !

It works with headings, so it is more geared towards documents than code. For example, it works very well with markdown documents to hide or show document sections (even if the TAB key on a markdown header already does this). We can also move sections around. For example, move a h1 section and all its subsections up, with one keypresse (outline-move-subtree-up).

Once you enabled the minor mode (outline-minor-mode), you can discover commands with the menu entry.

Evil users

evil-mode users have pre-defined keys: use za to toggle visibility, zc (close), zm (close all), zr (open all). They are an interface to other folding packages, most notably hideshow. The value of the variable evil-fold-list determines which backend is used for which major or minor modes, and what functions are available for those backends.

You might also like vimish-fold: it works with regions, it is persistent, it has mouse support, avy support, …

Third party packages

Yafolding

yafolding, in melpa, is based on indentation.

Origami

origami works well with languages that use braces to delimit blocks.

Fold this region

To fold the active region, see fold-this (in Melpa).

Yafolding.png