{"id":17982839,"url":"https://github.com/t9md/atom-project-find-navigation","last_synced_at":"2026-03-03T03:45:19.680Z","repository":{"id":35409670,"uuid":"39674277","full_name":"t9md/atom-project-find-navigation","owner":"t9md","description":"Improve project-find-result navigation by dirty hack.","archived":false,"fork":false,"pushed_at":"2017-06-11T05:00:57.000Z","size":40,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-11T06:08:40.352Z","etag":null,"topics":["atom","find-and-replace"],"latest_commit_sha":null,"homepage":"https://atom.io/packages/project-find-navigation","language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/t9md.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-25T05:56:32.000Z","updated_at":"2016-12-18T00:43:16.000Z","dependencies_parsed_at":"2022-09-17T04:11:03.648Z","dependency_job_id":null,"html_url":"https://github.com/t9md/atom-project-find-navigation","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t9md%2Fatom-project-find-navigation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t9md%2Fatom-project-find-navigation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t9md%2Fatom-project-find-navigation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/t9md%2Fatom-project-find-navigation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/t9md","download_url":"https://codeload.github.com/t9md/atom-project-find-navigation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241145223,"owners_count":19917411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atom","find-and-replace"],"created_at":"2024-10-29T18:15:21.181Z","updated_at":"2026-03-03T03:45:14.661Z","avatar_url":"https://github.com/t9md.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# :warning: [Deprecated] Don't use.\n\n- Why? Because I no longer use this package in daily editing.  I use [narrow](https://atom.io/packages/narrow) instead.\n- It's difficult to have motivation to maintain package I don't use.\n- Unpublished at 2017/06/11\n\n# project-find-navigation\n\n![gif](https://raw.githubusercontent.com/t9md/t9md/55e7fd32500d45751e2d7824f008e42b06763cd1/img/atom-project-find-navigation.gif)\n\nProvides keyboard navigation for project-find-result.\n\n# What's this?\n\nProvide keyboard navigation for project-find-result of [find-and-replace](https://github.com/atom/find-and-replace) package.  \nfind-and-replace provides `project-find:show` command which shows found entries in project.  \nWith this package you can navigate each match with keyboard.  \n\n# Excuse\n\nThis package's code is greatly and directly depending on internal variables and functions of [find-and-replace](https://github.com/atom/find-and-replace) provides.\n\nSo this package might not work in future version of find-and-replace.  \nIf code change made on find-and-replace was too big, I might give up this navigation hack package.  \nSo essentially this is proof of concept to evaluate how project-find's result pane navigation could be improved.  \n\n# Features\n\nHere is summary table of what project-find-navigation provides.\n\n| available on | command               | pure project-find              | project-find-navigation                                                  |\n|:-------------|:----------------------|:-------------------------------|:-------------------------------------------------------------------------|\n| results-pane | confirm               | Jump to found entry and select | Jump to found entry with flashing effect, no select                      |\n| results-pane | confirm-and-continue  | N/A                            | Scroll to found entry with flashing effect, focus remains on result pane |\n| results-pane | show-next             | N/A                            | Select next item and then confirm-and-continue(auto preview)             |\n| results-pane | show-prev             | N/A                            | Select previous item and then confirm-and-continue(auto preview)         |\n| global       | next                  | N/A                            | goto next result                                                         |\n| global       | prev                  | N/A                            | goto previous result                                                     |\n| global       | activate-results-pane | N/A                            | Focus to results-pane if exists                                          |\n\nOther features.\n\n- Focus to result-pane by keymap.\n- Highlight(decorate) found entries on editor, auto-cleared when result-pane destroyed.\n- Open found entry in **adjacent** pane. This mean, if result-pane was on left pane open found entry on right pane when confirmed.\n\n# Keymap\n\nFrom v0.2.0, default keymap are provided for result-pane\nBut you still **need to set keymap for workspace**.\n\n### On result pane\n\n| keystroke      | command                             | action                                |\n|:---------------|:------------------------------------|:--------------------------------------|\n| `j`            | `project-find-navigation:show-next` | Visit next match                      |\n| `k`            | `project-find-navigation:show-prev` | Visit previous match                  |\n| `l`            | `core:move-right`                   | Expand matches                        |\n| `h`            | `core:move-left`                    | Collapse matches                      |\n| `o` or `enter` | `core:confirm`                      | Open editor where current match found |\n| `q`            | `core:close`                        | Close result pane                     |\n| `g g`          | `core:move-to-top`                  | Move to top of result pane            |\n| `G`            | `core:move-to-bottom`               | Move to bottom of result pane         |\n| `ctrl-f`       | `core:page-down`                    | Scroll down                           |\n| `ctrl-b`       | `core:page-up`                      | Scroll up                             |\n\n### For keymap in text-editor\n\nYou have to set in your `keymap.cson`.\n\ne.g.\n\n```coffeescript\n'atom-workspace:not([mini])':\n  # This key override window:toggle-full-screen(I'm not using it).\n  'ctrl-cmd-f': 'project-find-navigation:activate-results-pane'\n  'ctrl-cmd-n': 'project-find-navigation:next'\n  'ctrl-cmd-p': 'project-find-navigation:prev'\n```\n\n# Style\n\nIn your `styles.less`, you can tweak match entry's decoration like following.\n\n```less\n@import \"syntax-variables\";\natom-text-editor::shadow {\n  .project-find-navigation-match .region {\n    background-color: @syntax-selection-color;\n    border: none;\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft9md%2Fatom-project-find-navigation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ft9md%2Fatom-project-find-navigation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ft9md%2Fatom-project-find-navigation/lists"}