ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Signet Bookmarks

by cepthomas ST4

Enhanced bookmarks plugin for Sublime Text with persistence and selectable traversal range.

Labels bookmark, navigation

Details

Installs

  • Total 138
  • Win 97
  • Mac 28
  • Linux 13
Jun 3 Jun 2 Jun 1 May 31 May 30 May 29 May 28 May 27 May 26 May 25 May 24 May 23 May 22 May 21 May 20 May 19 May 18 May 17 May 16 May 15 May 14 May 13 May 12 May 11 May 10 May 9 May 8 May 7 May 6 May 5 May 4 May 3 May 2 May 1 Apr 30 Apr 29 Apr 28 Apr 27 Apr 26 Apr 25 Apr 24 Apr 23 Apr 22 Apr 21 Apr 20
Windows 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Mac 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Linux 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

Readme

Source
raw.​githubusercontent.​com

Signet Bookmarks

Sublime Text plugin for enhanced bookmarks. Bookmark and Mark are already well used so this is signet from the French:

“Petit ruban ou filet qu'on insère entre les feuillets d'un livre pour marquer l'endroit que l'on veut retrouver.”

Built for ST4 on Windows. Linux and OSX should be ok but are minimally tested - PRs welcome.

Features

  • Persisted per project to ...\Packages\User\SignetBookmarks\SignetBookmarks.store.
  • Next/previous traverses just the current file or all files in project.

Caveats: - Signets not supported in temp/unnamed views.

Commands and Menus

Command Description Args
sbot_toggle_signet Toggle signet at row
sbot_goto_signet Go to next/previous/select signet where: next OR prev OR sel
sbot_clear_all_signets Clear all signets in project
sbot_clear_file_signets Clear signets in current file

There is no default Context.sublime-menu file in this plugin. Add the commands you like to your own User\Context.sublime-menu file. Typical entries are:

{ "caption": "Signet",
    "children":
    [
        { "caption": "Toggle Signet", "command": "sbot_toggle_signet" },
        { "caption": "Next Signet", "command": "sbot_goto_signet", "args": { "where": "next" } },
        { "caption": "Previous Signet", "command": "sbot_goto_signet", "args": { "where": "prev" } },
        { "caption": "Select Signet", "command": "sbot_goto_signet", "args": { "where": "sel" } },
        { "caption": "Clear All", "command": "sbot_clear_all_signets" }
    ]
}

Or they could go in your User\Main.sublime-menu file under Goto.

{
    "id": "goto",
    "children":
    [
        {
            "id": "signets",
            "caption": "Signets",
            "children":
            [
                { "caption": "Toggle Signet", "command": "sbot_toggle_signet" },
                { "caption": "Next Signet", "command": "sbot_goto_signet", "args": { "where": "next" } },
                { "caption": "Previous Signet", "command": "sbot_goto_signet", "args": { "where": "prev" } },
                { "caption": "Clear All", "command": "sbot_clear_all_signets" },
            ]
        },
    ]
}

You may find it useful to replace the builtin bookmark key bindings with the new ones because you shouldn't need both. In User\Default (Windows or Linux).sublime-keymap file:

{ "keys": ["ctrl+f2"], "command": "sbot_toggle_signet" },
{ "keys": ["f2"], "command": "sbot_goto_signet", "args": { "where": "next" } },
{ "keys": ["shift+f2"], "command": "sbot_goto_signet", "args": { "where": "prev" } },

Settings

Setting Description Options
scope Scope name for gutter icon any valid - default is region.redish
nav_all_files Traverse extent true=all project files OR false=just current file

Notes

  • sbot_common.py contains miscellaneous common components primarily for internal use by the sbot family. This includes a very simple logger primarily for user-facing information, syntax errors and the like. Log file is in <ST_PACKAGES_DIR>\User\SignetBookmarks\SignetBookmarks.log.
  • If you pull the source it must be in a directory named Signet Bookmarks rather than the repo name. This is to satisfy PackageControl naming requirements.