{"id":16610991,"url":"https://github.com/alefragnani/vscode-numbered-bookmarks","last_synced_at":"2025-03-17T14:07:57.637Z","repository":{"id":3895034,"uuid":"51248033","full_name":"alefragnani/vscode-numbered-bookmarks","owner":"alefragnani","description":"Numbered Bookmarks Extension for Visual Studio Code","archived":false,"fork":false,"pushed_at":"2024-09-01T18:33:15.000Z","size":4574,"stargazers_count":147,"open_issues_count":17,"forks_count":24,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-24T18:25:55.962Z","etag":null,"topics":["bookmark","delphi","visual-studio-code","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alefragnani.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"alefragnani","patreon":"alefragnani","custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"}},"created_at":"2016-02-07T13:12:00.000Z","updated_at":"2024-10-31T12:34:56.000Z","dependencies_parsed_at":"2024-10-25T18:29:53.211Z","dependency_job_id":"a48ca747-4ec8-48d5-ade6-7d41ada60053","html_url":"https://github.com/alefragnani/vscode-numbered-bookmarks","commit_stats":{"total_commits":230,"total_committers":5,"mean_commits":46.0,"dds":0.07391304347826089,"last_synced_commit":"488a030f11e085ddf208afdec85a60c028015880"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-numbered-bookmarks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-numbered-bookmarks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-numbered-bookmarks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alefragnani%2Fvscode-numbered-bookmarks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alefragnani","download_url":"https://codeload.github.com/alefragnani/vscode-numbered-bookmarks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244047631,"owners_count":20389206,"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":["bookmark","delphi","visual-studio-code","vscode","vscode-extension"],"created_at":"2024-10-12T01:34:16.730Z","updated_at":"2025-03-17T14:07:57.611Z","avatar_url":"https://github.com/alefragnani.png","language":"TypeScript","funding_links":["https://github.com/sponsors/alefragnani","https://patreon.com/alefragnani","https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted","https://www.patreon.com/alefragnani"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cbr /\u003e\n  \u003ca title=\"Learn more about Numbered Bookmarks\" href=\"http://github.com/alefragnani/vscode-numbered-bookmarks\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/vscode-numbered-bookmarks/master/images/vscode-numbered-bookmarks-logo-readme.png\" alt=\"Numbered Bookmarks Logo\" width=\"70%\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# What's new in Numbered Bookmarks 8.5\n\n* Published to **Open VSX**\n* Adds **Getting Started / Walkthrough**\n* Adds **Rename file** support\n* New **Sticky Engine**\n\n# Support\n\n**Numbered Bookmarks** is an extension created for **Visual Studio Code**. If you find it useful, please consider supporting it.\n\n\u003ctable align=\"center\" width=\"60%\" border=\"0\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n      \u003ca title=\"Paypal\" href=\"https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=EP57F3B6FXKTU\u0026lc=US\u0026item_name=Alessandro%20Fragnani\u0026item_number=vscode%20extensions\u0026currency_code=USD\u0026bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted\"\u003e\u003cimg src=\"https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca title=\"GitHub Sponsors\" href=\"https://github.com/sponsors/alefragnani\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/oss-resources/master/images/button-become-a-sponsor-rounded-small.png\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca title=\"Patreon\" href=\"https://www.patreon.com/alefragnani\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/alefragnani/oss-resources/master/images/button-become-a-patron-rounded-small.png\"/\u003e\u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n# Numbered Bookmarks\n\nIt helps you to navigate in your code, moving between important positions easily and quickly. No more need to _search for code_. All of this in **_in Delphi style_**.\n\n# Features\n\n## Available commands\n\n* `Numbered Bookmarks: Toggle Bookmark '#number'` Mark/unmark the current position with a numbered bookmark\n* `Numbered Bookmarks: Jump to Bookmark '#number'` Move the cursor to the numbered bookmark\n* `Numbered Bookmarks: List` List all bookmarks from the current file\n* `Numbered Bookmarks: List from All Files` List all bookmarks from the all files\n* `Numbered Bookmarks: Clear` remove all bookmarks from the current file\n* `Numbered Bookmarks: Clear from All Files` remove all bookmarks from the all files\n\n\u003e Both **Toggle Bookmark** and **Jump to Bookmark** commands are numbered from 0 to 9\n\n\u003e The Numbered Bookmark **0** has been reactivated in [PR #16](https://github.com/alefragnani/vscode-numbered-bookmarks/pull/16), but because of [this issue](https://github.com/Microsoft/vscode/issues/2585) it has no _keyboard shortcut_ defined. If sometime in the future these OS related limitation disappears, the shortcuts will be restored.\n\n\u003e MacOS users should be aware that some commands shortcuts should conflict with native shortcuts, and uses `Cmd` instead of `Ctrl` (`Cmd + Shift + 3` and `Cmd + Shift + 4`)\n\n## Manage your bookmarks\n\n### Toggle Bookmark '#number'\n\nYou can easily Mark/Unmark bookmarks on any position. \n\n![Toggle](images/numbered-bookmarks-toggle.png)\n\n\u003e The default shortcuts are numbered from 0 to 9: `Toggle Bookmark #` (`Ctrl + Shift + #`)\n\n### Navigation\n\n### Jump to Bookmark '#number'\n\n\u003e The default shortcuts are numbered from 0 to 9: `Jump to Bookmark #` (`Ctrl + #`)\n\n### List\n\nList all bookmarks from the current file and easily navigate to any one. It shows you the line contents and temporarily scroll to that position.\n\n### List from All Files\n\nList all bookmarks from all files and easily navigate to any one. It shows you the line contents and temporarily scroll to that position.\n\n![List](images/numbered-bookmarks-list-from-all-files.gif)\n\n* Bookmarks from the active file shows the line content and the position\n* Bookmarks from other files also shows the relative file path\n\n### Improved Multi-root support\n\nWhen you work with **multi-root** workspaces, the extension can manage the bookmarks individually for each folder. \n\nSimply define `saveBookmarksInProject` as `true` on your **User Settings** or in the **Workspace Settings**, and when you run the `Numbered Bookmarks: List from All Files` command, you will be able to select from which folder the bookmarks will be shown.\n\n![List](images/numbered-bookmarks-list-from-all-files-multi-root.gif)\n\n### Remote Development support\n\nThe extension now fully supports **Remote Development** scenarios. \n\nIt means that when you connect to a _remote_ location, like a Docker Container, SSH or WSL, the extension will be available, ready to be used. \n\n\u003e You don't need to install the extension on the remote anymore.\n\nBetter yet, if you use `numberedBookmarks.saveBookmarksInProject` setting defined as `true`, the bookmarks saved locally _will be available_ remotely, and you will be able to navigate and update the bookmarks. Just like it was a resource from folder you opened remotely.\n\n## Available Settings\n\n* Bookmarks are always saved between sessions, and you can decide if it should be saved _in the Project_, so you can add it to your Git/SVN repo and have it in all your machines _(`false` by default)_. Set to `true` and it will save the bookmarks in `.vscode\\numbered-bookmarks.json` file.\n```json\n    \"numberedBookmarks.saveBookmarksInProject\": true\n```\n\n* Controls whether to show a warning when a bookmark is not defined _(`false` by default)_\n```json\n    \"numberedBookmarks.showBookmarkNotDefinedWarning\": true\n```\n\n* Per [User Requests](https://github.com/alefragnani/vscode-numbered-bookmarks/issues/6) it is now possible to choose how Bookmarks _Navigate Through All Files_:\n\n```json\n    \"numberedBookmarks.navigateThroughAllFiles\"\n```\n\nPossible Values:\n\nValue | Explanation\n--------- | ---------\n`false` | _default_ - same behavior as today\n`replace` | you can't have the same numbered bookmark in different files\n`allowDuplicates` | you can have the same numbered bookmark in different files, and if you jump repeatedly to the same number, it will look on other files\n\n* **Experimental**. Enables the new **Sticky engine** with support for Formatters, improved source change detections and undo operations _(`true` by default)_\n\n```json\n    \"numberedBookmarks.experimental.enableNewStickyEngine\": false\n```\n\n* \"Specifies whether bookmarks on deleted line should be kept on file, moving it down to the next line, instead of deleting it with the line where it was toggled.\" _(`false` by default)_\n\n```json\n    \"numberedBookmarks.keepBookmarksOnLineDelete\": true\n```\n\n\u003e **Limitation:** It does not support `Undo` operations. It means that, once you delete a line and the bookmark is moved to the next available line, the `Undo` operation won't move the bookmark back to the previous line. The next line is now the new location of the bookmark.\n\n* Choose the gutter icon fill color\n\n```json\n    \"numberedBookmarks.gutterIconFillColor\"\n```\n\n* Choose the gutter icon number color\n\n```json\n    \"numberedBookmarks.gutterIconNumberColor\"\n```\n\n* Choose the location where the bookmarked line will be revealed _(`center` by default)_\n\n  * `top`: Reveals the bookmarked line at the top of the editor\n  * `center`: Reveals the bookmarked line in the center of the editor\n\n```json\n    \"numberedBookmarks.revealPosition\": \"center\"\n```\n\n## Available Colors\n\n* Choose the background color to use on a bookmarked line\n```json\n    \"workbench.colorCustomizations\": {\n      \"numberedBookmarks.lineBackground\": \"#157EFB22\"  \n    }\n```\n\n* Choose the border color to use on a bookmarked line\n```json\n    \"workbench.colorCustomizations\": {\n      \"numberedBookmarks.lineBorder\": \"#FF0000\"  \n    }\n```\n\n* Choose marker color to use in the overview ruler\n```json\n    \"workbench.colorCustomizations\": {\n      \"numberedBookmarks.overviewRuler\": \"#157EFB88\"  \n    }\n```\n\n\n\u003e For any of the _Color_ settings, you can use color names `blue`, RGB `rgb(0, 255, 37)`, RGBA `rgba(0, 255, 37, 0.2)` or HEX `#00ff25` format.\n\n## Project and Session Based\n\nThe bookmarks are saved _per session_ for the project that you are using. You don't have to worry about closing files in _Working Files_. When you reopen the file, the bookmarks are restored.\n\nIt also works even if you only _preview_ a file (simple click in TreeView). You can put bookmarks in any file and when you preview it again, the bookmarks will be there.\n\n# License\n\n[GPL-3.0](LICENSE.md) \u0026copy; Alessandro Fragnani","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falefragnani%2Fvscode-numbered-bookmarks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falefragnani%2Fvscode-numbered-bookmarks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falefragnani%2Fvscode-numbered-bookmarks/lists"}