项目作者: flexibeast

项目描述 :
Emacs interface to the buku Web bookmark manager.
高级语言: Emacs Lisp
项目地址: git://github.com/flexibeast/ebuku.git
创建时间: 2019-11-14T04:30:44Z
项目社区:https://github.com/flexibeast/ebuku

开源协议:

下载


ebuku - Interface to the buku Web bookmark manager

Author: Alexis flexibeast@gmail.com, Erik Sjöstrand sjostrand.erik@gmail.com, Junji Zhi [https://github.com/junjizhi], Hilton Chain hako@ultrarare.space

Version: 0

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

Image of the EBuku UI

Table of Contents

Installation

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

Windows users should ensure that the LC_ environment variables,
and the LC_ALL environment variable in particular, are set
correctly for their locale (e.g. zh_CN.UTF-8). The value of an
environment variable can be determined via the getenv command
(e.g. M-x getenv RET LC_ALL RET).

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.

  • C - Copy the URL of the bookmark at point to the kill ring
    (ebuku-copy-url).

  • T - Copy the title of the bookmark at point to the kill ring
    (ebuku-copy-title).

  • I - Copy the index of the bookmark at point to the kill ring
    (ebuku-copy-index).

  • q - Quit Ebuku.

Bindings for Evil are available via the
evil-collection
package, in evil-collection-ebuku.el.

The index of a bookmark can be displayed in the echo area by moving
the screen pointer over the leading -- text for the bookmark.

Completion

Ebuku provides two cache variables for use by completion frameworks
(e.g. Ivy or Helm): ebuku-bookmarks and ebuku-tags, which can
be populated via the ebuku-update-bookmarks-cache and
ebuku-update-tags-cache functions, respectively.

Customisation

The ebuku customize-group includes variables for:

  • the path to the buku executable;

  • the path to the buku database;

  • the number of recently-added bookmarks to show;

  • which bookmarks to show on startup;

  • the maximum number of bookmarks to show;

  • whether to automatically retrieve URL metadata when adding a
    bookmark; and

  • the faces used by Ebuku;

  • whether to use sqlite to refresh the ebuku-bookmarks and
    ebuku-tags cache variables (requires separate installation of
    sqlite3 executable).

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:

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.