This extension adds codefolding functionality from CodeMirror to a codecell.
In edit mode, clicking on the triangle in the gutter (left margin of codecell) or typing the codefolding hotkey
Alt+F), folds the code.
In command mode, the folding hotkey relates to the first line of the codecell.
See the examples below. The folding status is saved in the cell metadata of the notebook, so reloading of a notebook will restore the folding view.
Three different folding modes are supported:
Python-style code folding, detetects indented code.
The unfolded code above can be folded like this:
Firstline Comment Folding¶
Allows collapsing of Python code cells to a single comment line. This is useful for long codecells. The algorithm simply looks for a comment in the first line and allows folding in the rest of the cell.
The code above can be folded like this:
If you specify a magic in the first line of a cell, it can be folded, too.
When saving a notebook, the folding information is saved in the metadata of each codecell. The number of the folding start line (beginning with 0) is stored in an array:
cell.metadata.code_folding = [ 3, 20, 33 ]
When reloading the notebook, the folding status is restored.
The codefolding hotkey can be customized using the notebook extensions configurator.
The settings are stored as
"codefolding_hotkey": "alt-f" in
the notebook.json configuration file.
To export a notebook containing folded cells, you will need to apply a custom
preprocessor for nbconvert.
The preprocessor is located in
The preprocessor is installed when you install the
To activate the preprocessor manually,
add the following lines to
Exporter.preprocessors += ['jupyter_contrib_nbextensions.nbconvert_support.CodeFoldingPreprocessor']