eec5ba6577
* documentation formatting: Mon Apr 5 20:50:44 UTC 2021 * Built-in files auto-update: Mon Apr 5 20:49:17 UTC 2021
75 lines
3.7 KiB
Org Mode
75 lines
3.7 KiB
Org Mode
#+TITLE: Pocket layer
|
|
|
|
#+TAGS: layer|web service
|
|
|
|
[[file:img/pocket.png]]
|
|
|
|
* Table of Contents :TOC_5_gh:noexport:
|
|
- [[#description][Description]]
|
|
- [[#features][Features:]]
|
|
- [[#install][Install]]
|
|
- [[#authentication][Authentication]]
|
|
- [[#key-bindings][Key bindings]]
|
|
- [[#bindings-in-pocket-reader-buffer][Bindings in pocket-reader buffer]]
|
|
|
|
* Description
|
|
This layer adds [[https://getpocket.com/][Pocket]] support to Spacemacs via the package
|
|
[[https://github.com/alphapapa/pocket-reader.el][pocket-reader]].
|
|
|
|
** Features:
|
|
- Manage reading list: add, remove, delete, tag, view, favorite, etc.
|
|
- Open links in Emacs or external browser
|
|
- Sort views by date, title, domain, tags, favorite, etc.
|
|
- Search items by keywords, tags, favorite status, unread/archived
|
|
status, etc.
|
|
|
|
* Install
|
|
To use this configuration layer, add it to your =~/.spacemacs=. You
|
|
will need to add =pocket= to the existing
|
|
=dotspacemacs-configuration-layers= list in this file.
|
|
|
|
* Authentication
|
|
Just run the =pocket-reader= command. A URL will be copied to the
|
|
clipboard/kill ring. Open the URL in a web browser and follow the
|
|
instructions to log into your Pocket account.
|
|
|
|
Note: Please ignore any =Page Not Found= error you might see on the
|
|
Pocket Web site after authorizing. Just run the =pocket-reader=
|
|
command after authorizing, and it should work. You can verify that
|
|
authorization completed by checking the file
|
|
=~/.cache/emacs-pocket-lib-token.json=.
|
|
|
|
* Key bindings
|
|
|
|
| Key binding | Description |
|
|
|-------------+---------------------------|
|
|
| ~SPC a w p~ | Open pocket-reader buffer |
|
|
|
|
** Bindings in pocket-reader buffer
|
|
|
|
| Key binding | Description |
|
|
|-------------+-------------------------------------------------------------------|
|
|
| ~RET~ | Open with default browse function |
|
|
| ~TAB~ | Open with default pop-to function |
|
|
| ~b~ | Open with external browser function |
|
|
| ~a~ | Toggle archived/unread status |
|
|
| ~c~ | Copy URL to the kill ring |
|
|
| ~d~ | Show default view |
|
|
| ~D~ | Delete item |
|
|
| ~e~ | Show excerpt |
|
|
| ~E~ | Show excerpt for all items |
|
|
| ~*~, ~f~ | Toggle favorite status |
|
|
| ~F~ | Show unread, favorite items |
|
|
| ~gr~ | Re-sort list |
|
|
| ~gR~ | Refresh list using last query (or default query) |
|
|
| ~s~ | Search for items (or display default view if no query is entered) |
|
|
| ~m~ | Toggle mark of current item |
|
|
| ~M~ | Mark all items |
|
|
| ~U~ | Unmark all items |
|
|
| ~o~ | Show more items (using the current count limit) |
|
|
| ~l~ | Limit current view to items matching string |
|
|
| ~R~ | Open random item from current items |
|
|
| ~ta~ | Add tags |
|
|
| ~tr~ | Remove tags |
|
|
| ~tt~ | Set tags |
|
|
| ~ts~ | Search for a tag |
|