https://github.com/ragone/asx

Ask StackExchange/StackOverflow in Emacs
https://github.com/ragone/asx

convenience emacs stackexchange stackoverflow

Last synced: 2 months ago
JSON representation

Ask StackExchange/StackOverflow in Emacs

• Host: GitHub
• URL: https://github.com/ragone/asx
• Owner: ragone
• License: gpl-3.0
• Created: 2019-08-29T11:47:28.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-07-26T08:53:46.000Z (over 2 years ago)
• Last Synced: 2024-08-05T06:03:30.073Z (6 months ago)
• Topics: convenience, emacs, stackexchange, stackoverflow
• Language: Emacs Lisp
• Homepage:
• Size: 2.16 MB
• Stars: 17
• Watchers: 1
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

README

        
[[file:example.gif]]

This package allows you to search any StackExchange site specified in

~asx-sites~ and insert the top post in an Org-mode buffer. For better searching,

this uses Google and DuckDuckGo as it is superior to StackExchange's searching

capabilities. More search engines can be defined using ~asx-search-engine-alist~.

Inspired by [[https://www.reddit.com/r/emacs/comments/cs6cb4/instant_stackoverflow_solutions_in_emacs_without/][this reddit post]] and [[https://github.com/thanhvg/emacs-howdoyou][howdoyou.el]], I decided to build a more robust

experience and make it compatible with Org-mode.

I chose to scrape the StackExchange posts, as StackExchange's API only allows

searching/getting posts from a single site.

If Ivy 0.13.0 or Helm is installed, suggestions from Google or DuckDuckGo will

be provided while you type.

* Install

Available on [[https://melpa.org/#/asx][MELPA]].

* Usage

Run ~M-x asx~ and enter query when prompted.

* Configuration

| Variable                  | Notes                                                               | Default                         |

|---------------------------+---------------------------------------------------------------------+---------------------------------|

| ~asx-sites~               | Sites to search.                                                    | ~("stackoverflow.com" ...)~     |

| ~asx-search-engine~       | Search engine to use.                                               | ~google~                        |

| ~asx-search-engine-alist~ | Alist of search engine configuration.                               | ~((google ..) (duckduckgo ..))~ |

| ~asx-number-of-answers~   | Answers to include.                                                 | ~3~                             |

| ~asx-prompt-post-p~       | If non-nil, prompt for post to show. Otherwise show the first post. | ~nil~                           |

| ~asx-buffer-name~         | Name of buffer to insert post.                                      | ~*AskStackExchange*~            |

| ~asx-skip-unanswered~     | If non-nil, skip posts which have no answers.                       | ~t~                             |

* Commands

| Variable                    | Notes                |

|-----------------------------+----------------------|

| ~asx~                       | Search for query.    |

| ~asx-jump~                  | Jump to post.        |

| ~asx-next-post~             | Go to next post.     |

| ~asx-previous-post~         | Go to previous post. |

| ~asx-reload-post~           | Reload current post. |

| ~asx-go-back-to-first-post~ | Go to first post.    |

* Similar projects

- [[https://github.com/vermiculus/sx.el][SX]]

- [[https://github.com/rudolfolah/emacs-sos][Emacs SOS]]

- [[https://github.com/thanhvg/emacs-howdoyou/blob/master/howdoyou.el][howdoyou]]

- [[https://github.com/santinic/how2][how2]]

- [[https://github.com/atykhonov/emacs-howdoi][howdoi]]