Signet Bookmarks

by cepthomas ST4

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

Details

Version 1.0.7
Homepage github.com
Issues github.com
Modified 2 weeks ago
Last Seen 4 hours ago
First Seen 9 months ago

Installs

Total 94
Win 62
Mac 22
Linux 10

	Aug 8	Aug 7	Aug 6	Aug 5	Aug 4	Aug 3	Aug 2	Aug 1	Jul 31	Jul 30	Jul 29	Jul 28	Jul 27	Jul 26	Jul 25	Jul 24	Jul 23	Jul 22	Jul 21	Jul 20	Jul 19	Jul 18	Jul 17	Jul 16	Jul 15	Jul 14	Jul 13	Jul 12	Jul 11	Jul 10	Jul 9	Jul 8	Jul 7	Jul 6	Jul 5	Jul 4	Jul 3	Jul 2	Jul 1	Jun 30	Jun 29	Jun 28	Jun 27	Jun 26	Jun 25	Jun 24
Windows	0	0	1	1	0	0	0	0	3	1	0	0	0	0	0	0	1	0	5	1	0	0	0	1	0	1	0	0	1	0	1	0	0	0	0	0	0	0	0	0	0	1	1	1	0	0
Mac	0	2	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	1	0	0	0	0	0	0	1	1	0	0	0	0	1	0	1	0	1
Linux	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	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.