debian-mirror-gitlab/doc/user/project/repository/file_finder.md

43 lines
1.6 KiB
Markdown
Raw Normal View History

2019-12-26 22:10:19 +05:30
---
2020-10-24 23:57:45 +05:30
stage: Create
group: Editor
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2019-12-26 22:10:19 +05:30
disqus_identifier: 'https://docs.gitlab.com/ee/workflow/file_finder.html'
---
2021-04-17 20:07:23 +05:30
# File finder **(FREE)**
2019-12-26 22:10:19 +05:30
The file finder feature allows you to search for a file in a repository using the
2021-04-29 21:17:54 +05:30
GitLab UI. To use it:
2019-12-26 22:10:19 +05:30
2021-04-29 21:17:54 +05:30
1. Go to your project's **Repository > Files**.
1. In the upper right corner, select **Find File**.
2019-12-26 22:10:19 +05:30
2021-04-29 21:17:54 +05:30
If you prefer to keep your fingers on the keyboard, use the
2021-03-11 19:13:27 +05:30
[shortcut button](../../shortcuts.md), which you can invoke from anywhere
2019-12-26 22:10:19 +05:30
in a project.
Press `t` to launch the File search function when in **Issues**,
**Merge requests**, **Milestones**, even the project's settings.
Start typing what you are searching for and watch the magic happen. With the
up/down arrows, you go up and down the results, with `Esc` you close the search
2020-05-24 23:13:21 +05:30
and go back to **Files**
2019-12-26 22:10:19 +05:30
## How it works
The File finder feature is powered by the [Fuzzy filter](https://github.com/jeancroy/fuzz-aldrin-plus) library.
2020-05-24 23:13:21 +05:30
It implements a fuzzy search with the highlight and tries to provide intuitive
2019-12-26 22:10:19 +05:30
results by recognizing patterns that people use while searching.
2020-05-24 23:13:21 +05:30
For example, consider the [GitLab FOSS repository](https://gitlab.com/gitlab-org/gitlab-foss/tree/master) and that we want to open
2019-12-26 22:10:19 +05:30
the `app/controllers/admin/deploy_keys_controller.rb` file.
2020-05-24 23:13:21 +05:30
Using a fuzzy search, we start by typing letters that get us closer to the file.
2019-12-26 22:10:19 +05:30
2021-02-22 17:27:13 +05:30
NOTE:
2020-10-24 23:57:45 +05:30
To narrow down your search, include `/` in your search terms.
2019-12-26 22:10:19 +05:30
2020-05-24 23:13:21 +05:30
![Find file button](img/file_finder_find_file_v12_10.png)