Kungsgeten / ebuku

Emacs interface to the Buku Web bookmark manager.

ebuku - Interface to the buku Web bookmark manager

Author: Alexis [e-mail]
Version: 0

Ebuku provides a basic interface to the buku Web bookmark manager.

Table of Contents

• Installation
• Usage
• Customisation
• TODO
• Issues
• License

Installation

Install Ebuku from MELPA, or put the ebuku folder in your load-path and do a (load "ebuku").

Usage

Create an Ebuku buffer with M-x ebuku.

In the *Ebuku* buffer, the following bindings are available:

• s - Search for a bookmark (ebuku-search).

• r - Show recently-added bookmarks (ebuku-search-on-recent).

• * - Show all bookmarks (ebuku-show-all).

• - - Toggle results limit (ebuku-toggle-results-limit).

• g - Refresh the search results, based on last search (ebuku-refresh).

• RET - Open the bookmark at point in a browser (ebuku-open-url).

• n - Move point to the next bookmark URL (ebuku-next-bookmark).

• p - Move point to the previous bookmark URL (ebuku-previous-bookmark).

• a - Add a new bookmark (ebuku-add-bookmark).

• d - Delete a bookmark (ebuku-delete-bookmark). If point is on a bookmark, offer to delete that bookmark; otherwise, ask for the index of the bookmark to delete.

• e - Edit a bookmark (ebuku-edit-bookmark). If point is on a bookmark, edit that bookmark; otherwise, ask for the index of the bookmark to edit.

• q - Quit Ebuku.

Completion

The ebuku-gather-bookmarks function can be used to generate a list of the bookmarks in the buku database, which can then be utilised by completion frameworks such as Ivy or Helm. The format of list entries is specified via the ebuku-gather-bookmarks-format variable, and the list is cached in the ebuku-bookmarks variable.

Customisation

The ebuku customize-group can be used to customise:

• the path to the buku executable;

• the number of recently-added bookmarks to show;

• which bookmarks to show on startup;

• the maximum number of bookmarks to show; and

• the faces used by Ebuku.

TODO

• One should be able to edit bookmarks directly in the *Ebuku* buffer, à la wdired. Much of the infrastructure to support this is already in place, but there are still important details yet to be implemented.

Issues / bugs

If you discover an issue or bug in Ebuku not already noted:

• as a TODO item, or

• in the project's "Issues" section on GitHub,

please create a new issue with as much detail as possible, including:

• which version of Emacs you're running on which operating system, and

• how you installed Ebuku.

License

GNU General Public License version 3, or (at your option) any later version.

---

Converted from ebuku.el by el2markdown.