https://github.com/masutaka/emacs-helm-esa

esa with helm interface (\( ⁰⊖⁰)/)
https://github.com/masutaka/emacs-helm-esa

emacs-helm emacs-lisp esa

Last synced: about 1 month ago
JSON representation

esa with helm interface (\( ⁰⊖⁰)/)

• Host: GitHub
• URL: https://github.com/masutaka/emacs-helm-esa
• Owner: masutaka
• Created: 2019-05-26T08:03:26.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-07-21T14:30:19.000Z (over 5 years ago)
• Last Synced: 2024-10-13T16:44:49.206Z (3 months ago)
• Topics: emacs-helm, emacs-lisp, esa
• Language: Emacs Lisp
• Homepage:
• Size: 301 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# helm-esa.el

[![melpa badge][melpa-badge]][melpa-link]

[![melpa stable badge][melpa-stable-badge]][melpa-stable-link]

[melpa-link]: https://melpa.org/#/helm-esa

[melpa-stable-link]: https://stable.melpa.org/#/helm-esa

[melpa-badge]: https://melpa.org/packages/helm-esa-badge.svg

[melpa-stable-badge]: https://stable.melpa.org/packages/helm-esa-badge.svg

## Introduction

`helm-esa.el` is a helm interface for [esa](https://esa.io/).

You can open esa articles to the web browser using helm interface.

## Screenshot

![helm-esa](image/helm-esa.gif)

## Requirements

* Emacs 26.2 or higher

* helm 3.2 or higher

## Installation

You can install `helm-esa.el` from [MELPA](https://melpa.org) with package.el (`M-x package-install helm-esa`).

## Setup

```lisp

(setq helm-esa-team-name "Your esa team name")

(setq helm-esa-access-token "Your Access Token") ;; See https://{team_name}.esa.io/user/applications

(helm-esa-initialize)

```

The required scope is `Read` for `helm-esa-access-token`.

## Usage

### `helm-esa`

* A function to be able to select the searched esa articles

### `helm-esa-source`

* A helm source for the searched esa articles

### `helm-esa-search-query`

* Query for searching esa articles

You can customize it. e.g;

```lisp

(setq helm-esa-search-query "watched:true -in:日報")

```

The default value is `"watched:true kind:stock"`.

See also [help/記事の検索方法 \- docs\.esa\.io](https://docs.esa.io/posts/104).