doom-emacs/modules/ui/treemacs
Henrik Lissner 1abcf913aa
revert: fix(docs): set mode in file-local vars
emacs-straight/org-mode@e22b4eb7aa introduced a breaking change that
made it impossible to rely on .dir-locals.el to change org-mode buffers
in $EMACSDIR to doom-docs-org-mode (without infinite recursion), so we
used file-local variables in 7e400ab.

emacs-straight/org-mode@215de6176b reverted that change, so we can use
.dir-locals.el again, and this is my preference, since it requires less
boilerplate across our hundreds of org files.

Ref: emacs-straight/org-mode@215de6176b
Ref: emacs-straight/org-mode@e22b4eb7aa
Revert: 7e400abdc0
2022-08-07 19:08:07 +02:00
..
autoload.el
config.el
doctor.el
packages.el bump: :ui 2022-03-31 21:08:31 +02:00
README.org

:ui treemacs

Description   unfold

Treemacs is a file and project explorer similar to NeoTree or vim's NerdTree, but largely inspired by the Project Explorer in Eclipse. It shows the file system outlines of your projects in a simple tree layout allowing quick navigation and exploration, while also possessing basic file management utilities. It includes:

Module flags

+lsp
Enable lsp-treemacs integration and add shortcuts for common commands.

Hacks

No hacks documented for this module.

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

If python3 is present on your $PATH, treemacs will use it to display git status for files.

TODO Usage

🔨 This module's usage documentation is incomplete. Complete it?

The project bar can be opened using SPC o p.

Keybind Description
o s Open a horizontal dired buffer on the currently highlighted node
o v Open a vertical dired buffer on the currently highlighted node

TODO Configuration

🔨 This module's configuration documentation is incomplete. Complete it?

The variable +treemacs-git-mode sets the type of git integration that treemacs has.

There are 3 possible values:

  1. 'simple (the default), which highlights only files based on their git status, and is slightly faster,
  2. 'extended, which highlights both files and directories, but requires python,
  3. 'deferred, same as extended, but highlights asynchronously.

🚧 +treemacs-git-mode must be set before treemacs is loaded.

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

🔨 This module has no appendix yet. Write one?