Files
oak-gpui/docs/src/outline-panel.md
T
Danilo Leal ddcd45bb45 docs: Add tweaks to the outline panel page (#18697)
Thought we could be extra clear here with the meaning of "singleton
buffers".

Release Notes:

- N/A
2024-10-03 12:27:42 -03:00

32 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Outline Panel
In addition to the modal outline (`cmd-shift-o`), Zed offers an outline panel. The outline panel can be deployed via `cmd-shift-b` (`outline panel: toggle focus` via the command palette), or by clicking the `Outline Panel` button in the status bar.
When viewing a "singleton" buffer (i.e., a single file on a tab), the outline panel works similarly to that of the outline modalit displays the outline of the current buffer's symbols, as reported by tree-sitter. Clicking on an entry allows you to jump to the associated section in the file. The outline view will also automatically scroll to the section associated with the current cursor position within the file.
![Using the outline panel in a singleton buffer](https://zed.dev/img/outline-panel/singleton.png)
## Usage with multibuffers
The outline panel truly excels when used with multi-buffers. Here are some examples of its versatility:
### Project Search Results
Get an overview of search results across your project.
![Using the outline panel in a project search multi-buffer](https://zed.dev/img/outline-panel/project-search.png)
### Project Diagnostics
View a summary of all errors and warnings reported by the language server.
![Using the outline panel while viewing project diagnostics multi-buffer](https://zed.dev/img/outline-panel/project-diagnostics.png)
### Find All References
Quickly navigate through all references when using the `editor: find all references` action.
![Using the outline panel while viewing `find all references` multi-buffer](https://zed.dev/img/outline-panel/find-all-references.png)
The outline view provides a great way to quickly navigate to specific parts of your code and helps you maintain context when working with large result sets in multi-buffers.