{"id":21053404,"url":"https://github.com/thecodechef/sublime-sidebar-enhancements-extended","last_synced_at":"2025-06-24T13:06:40.624Z","repository":{"id":79863520,"uuid":"161141300","full_name":"thecodechef/sublime-sidebar-enhancements-extended","owner":"thecodechef","description":null,"archived":false,"fork":false,"pushed_at":"2018-12-10T17:36:15.000Z","size":86,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-20T18:45:32.484Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thecodechef.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2018-12-10T08:21:50.000Z","updated_at":"2018-12-10T17:36:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"b96c3075-19f6-4e0c-957a-2f585202a427","html_url":"https://github.com/thecodechef/sublime-sidebar-enhancements-extended","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodechef%2Fsublime-sidebar-enhancements-extended","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodechef%2Fsublime-sidebar-enhancements-extended/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodechef%2Fsublime-sidebar-enhancements-extended/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecodechef%2Fsublime-sidebar-enhancements-extended/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thecodechef","download_url":"https://codeload.github.com/thecodechef/sublime-sidebar-enhancements-extended/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243497557,"owners_count":20300273,"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":[],"created_at":"2024-11-19T16:06:19.842Z","updated_at":"2025-03-13T23:26:50.763Z","avatar_url":"https://github.com/thecodechef.png","language":"Python","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=DD4SL2AHYJGBW"],"categories":[],"sub_categories":[],"readme":"\n# Sidebar Enhancements\n\n### In other languages\n\nJapanese - \u003chttp://taamemo.blogspot.jp/2012/10/sublime-text-2-sidebarenhancements.html?m=1\u003e\n\nRussian - \u003chttps://www.youtube.com/watch?v=8I0dJTd58kI\u0026feature=youtu.be\u0026a\u003e\n\nChinese - \u003chttps://github.com/52fisher/SideBarEnhancements\u003e\n\n## Description\n\n### [Sublime Text 3+][] Package, It does NOT WORK with ST2, DOES NOT; Use Sublime Text 3 Please.\n\nProvides enhancements to the operations on Sidebar of Files and Folders for Sublime Text. \u003chttp://www.sublimetext.com/\u003e\n\nNotably provides delete as \"move to trash\", open with.. and a clipboard.\n\nClose, move, open and restore buffers affected by a rename/move command. (even on folders)\n\nProvides the basics: new file/folder, edit, open/run, reveal, find in selected/parent/project, cut, copy, paste, paste in parent, rename, move, delete, refresh....\n\nThe not so basic: copy paths as URIs, URLs, content as UTF8, content as \u003cdata:uri\u003e base64 ( nice for embedding into CSS! ), copy as tags img/a/script/style, duplicate\n\nPreference to control if a buffer should be closed when affected by a deletion operation.\n\nAllows to display \"file modified date\" and \"file size\" on statusbar.\n\n![][]\n\n## Installation\n\nDownload or clone the contents of this repository to a folder named exactly as the package name into the Packages/ folder of ST.\n\nTroubleshooting Installation:\n\nIf you have problems with the installation, do this:\n\n-   First please note this package only adds a context menu to the \"Folders\" section and not to the \"Open Files\" section.\n-   Open the package folder. Main menu -\\\u003e Preferences -\\\u003e Browse Packages.\n-   Close Sublime Text.\n-   Remove the folder \"Packages/SideBarEnhancements\"\n-   Remove the folder \"User/SideBarEnhancements\"\n-   Navigate one folder up, to \"Installed Packages/\", check for any instance of SideBarEnhancements and remove it.\n-   Open ST, with Package Control go to : Remove Package, check for any instance of SideBarEnhancements and remove it.\n-   Restart ST\n-   Open ST, check if there is any entry about SideBarEnhancements in Package Control(in sections: \"Remove Package\" and just in case in \"Enable Package\")\n-   Repeat until you find there no entry about SideBarEnhancements\n-   Restart ST\n-   Install it.\n-   It works\n\n## F12 key\n\n(Please note that from version 2.122104 this package no longer provides the key, you need to manually add it to your sublime-keymap file (see next section))\n\nF12 key allows you to open the current file in browser.\n\n`url_testing` allows you to set the url of your local server, opened via F12\n\n`url_production` allows you to set the url of your production server, opened via ALT+F12\n\n### With absolute paths\n-   Right click any file on sidebar and select: \"Project -\\\u003e Edit Projects Preview URLs\"\n-   Edit this file, and add your paths and URLs with the following structure:\n\n\u003c!-- --\u003e\n\n\t{\n\t\t\"S:/www/domain.tld\":{\n\t\t\t\"url_testing\":\"http://testing\",\n\t\t\t\"url_production\":\"http://domain.tld\"\n\t\t},\n\t\t\"C:/Users/luna/some/domain2.tld\":{\n\t\t\t\"url_testing\":\"http://testing1\",\n\t\t\t\"url_production\":\"http://productiontld2\"\n\t\t}\n\t}\n\n### With relative paths\n\nImagine we have a project with the following structure\n\n\tProject/ \u003c - root project folder\n\tProject/libs/\n\tProject/public/ \u003c - the folder we want to load as \"http://localhost/\"\n\tProject/private/\n\tProject/experimental/ \u003c - other folder we may run as experimental/test in another url \"http://experimental/\"\n\nThen we create configuration file:\n\n`Project/.sublime/SideBarEnhancements.json`\n\nwith content:\n\n\t{\n\t\t\"public/\":{\n\t\t\t\"url_testing\":\"http://localhost/\",\n\t\t\t\"url_production\":\"http://domain.tld/\"\n\t\t},\n\t\t\"experimental/\":{\n\t\t\t\"url_testing\":\"http://experimental/\",\n\t\t\t\"url_production\":\"http://domain.tld/\"\n\t\t},\n\t\t\"\":{\n\t\t\t\"url_testing\":\"http://the_url_for_the_project_root/\",\n\t\t\t\"url_production\":\"http://the_url_for_the_project_root/\"\n\t\t}\n\t}\n\n...\n\nYou can create config files `some/folder/.sublime/SideBarEnhancements.json` anywhere.\n\n#### F12 key conflict\n\nOn Sublime Text 3 `F12` key is bound to `\"goto_definition\"` command by default. This package was conflicting with that key, this no longers happens. You need to manually add the keys now: Go to `Preferences -\u003e Package Settings -\u003e Side Bar -\u003e Key Bindings - User` and add any of the following:\n\n\t\t[\n\t\t\t{ \"keys\": [\"f12\"],\n\t\t\t\t\"command\": \"side_bar_open_in_browser\" ,\n\t\t\t\t\"args\":{\"paths\":[], \"type\":\"testing\", \"browser\":\"\"}\n\t\t\t},\n\t\t\t{ \"keys\": [\"alt+f12\"],\n\t\t\t\t\"command\": \"side_bar_open_in_browser\",\n\t\t\t\t\"args\":{\"paths\":[], \"type\":\"production\", \"browser\":\"\"}\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"keys\": [\"ctrl+t\"],\n\t\t\t\t\"command\": \"side_bar_new_file2\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"keys\": [\"f2\"],\n\t\t\t\t\"command\": \"side_bar_rename\"\n\t\t\t},\n\t\t]\n\n## Keybinding for Find in paths:\n\nYou may wish to add a key for opening \"find in paths..\"\n\n\t[\n\t\t{\n\t\t\t\"keys\": [\"f10\"],\n\t\t\t\"id\": \"side-bar-find-files\",\n\t\t\t\"command\": \"side_bar_find_files_path_containing\",\n\t\t\t\"args\": {\n\t\t\t\t\"paths\": []\n\t\t\t}\n\t\t}\n\t]\n\n\n## Notes on configuring the `Open With` menu:\n\n\nDefinitions file: `User/SideBarEnhancements/Open With/Side Bar.sublime-menu` (note the extra subfolder levels). To open it, right-click on any file in an open project and select `Open With \u003e Edit Applications...`\n\n-   On OSX, the 'application' property simply takes the *name* of an application, to which the file at hand's full path will be passed as if with `open ...`, e.g.: \"application\": \"Google Chrome\"\n-   On OSX, invoking *shell* commands is NOT supported.\n\n\u003c!-- --\u003e\n\n\t//application 1\n\t{\n\t\t\"caption\": \"Photoshop\",\n\t\t\"id\": \"side-bar-files-open-with-photoshop\",\n\t\t\"command\": \"side_bar_files_open_with\",\n\t\t\"args\": {\n\t\t\t\"paths\": [],\n\t\t\t\"application\": \"Adobe Photoshop CS5.app\", // OSX\n\t\t\t\"extensions\":\"psd|png|jpg|jpeg\",  //any file with these extensions\n\t\t\t\"args\":[]\n\t\t}\n\t\t\"open_automatically\" : true // will close the view/tab and launch the application\n\t},\n\n### Vars on \"args\" param\n\n- $PATH - The full path to the current file, e. g., C:\\Files\\Chapter1.txt.\n- $PROJECT - The root directory of the current project.\n- $DIRNAME - The directory of the current file, e. g., C:\\Files.\n- $NAME - The name portion of the current file, e. g., Chapter1.txt.\n- $EXTENSION - The extension portion of the current file, e. g., txt.\n\n## FAQ\n\nQ: Why the menu is not shown on `Open Files`?\n\n-   It should be mentioned that the package's context menu is only available for files and folders **in a project (section** `Folders` **in the side bar)**, and *not* on the open files listed at the top of the side bar, due to a limitation of ST.\n\nQ: Can the package stop \"show preview in a **right** click to a file\".\n\n-   No, ​I'm sorry, can't figure out how to prevent it.\n\n## Using the External Libraries\n\n(check each license in project pages)\n\n-   \"getImageInfo\" to get width and height for images from \"bfg-pages\". See: \u003chttp://code.google.com/p/bfg-pages/\u003e\n-   \"desktop\" to be able to open files with system handlers. See: \u003chttp://pypi.python.org/pypi/desktop\u003e\n-   \"send2trash\" to be able to send to the trash instead of deleting for ever!. See: \u003chttp://pypi.python.org/pypi/Send2Trash\u003e\n-   \"hurry.filesize\" to be able to format file sizes. See: \u003chttp://pypi.python.org/pypi/hurry.filesize/\u003e\n-   \"Edit.py\" ST2/3 Edit Abstraction. See: \u003chttp://www.sublimetext.com/forum/viewtopic.php?f=6\u0026t=12551\u003e\n\n## Source-code\n\n\u003chttps://github.com/SideBarEnhancements-org/SideBarEnhancements\u003e\n\n## Forum Thread\n\n\u003chttp://www.sublimetext.com/forum/viewtopic.php?f=5\u0026t=3331\u003e\n\n# Contributors:\n\n(Thank you so much!)\n-   Aleksandar Urosevic\n-   bofm\n-   Dalibor Simacek\n-   Devin Rhode\n-   Eric Eldredge\n-   Hewei Liu\n-   Jeremy Gailor\n-   Joao Antunes\n-   Leif Ringstad\n-   MauriceZ\n-   Nick Zaccardi\n-   Patrik Göthe\n-   Peder Langdal\n-   Randy Lai\n-   Raphael DDL Oliveira\n-   robwala\n-   Stephen Horne\n-   Sven Axelsson\n-   Till Theis\n-   Todd Wolfson\n-   Tyler Thrailkill\n-   Yaroslav Admin\n\n## TODO\n\n\u003chttps://github.com/SideBarEnhancements-org/SideBarEnhancements/issues/223\u003e\n\n## License\n\n\"None are so hopelessly enslaved as those who falsely believe they are free.\" Johann Wolfgang von Goethe\n\nCopyright (C) 2014 Tito Bouzout [tito.bouzout@gmail.com][]\n\nThis license apply to all the files inside this program unless noted different for some files or portions of code inside these files.\n\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation. \u003chttp://www.gnu.org/licenses/gpl.html\u003e\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program. If not, see \u003chttp://www.gnu.org/licenses/gpl.html\u003e\n\n## Helpful!? Support, Many thanks ^_^\n\n\n[Donate to support this project.][]\n\n  [Sublime Text 3+]: http://www.sublimetext.com/\n  []: https://www.dropbox.com/s/ckz5n2ncn2pxkii/sidebar.png?dl=1\n  [desktop]: http://pypi.python.org/pypi/desktop\n  [Send2Trash]: http://pypi.python.org/pypi/Send2Trash\n  [bfg-pages]: http://code.google.com/p/bfg-pages/\n  [tito.bouzout@gmail.com]: tito.bouzout@gmail.com\n  [Donate to support this project.]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=DD4SL2AHYJGBW\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodechef%2Fsublime-sidebar-enhancements-extended","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecodechef%2Fsublime-sidebar-enhancements-extended","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecodechef%2Fsublime-sidebar-enhancements-extended/lists"}