aboutsummaryrefslogtreecommitdiff
path: root/README.org
blob: f8b01ea6a0640fab77420cacbf5e7f84266b55a6 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
#+Title: SX -- Stack Exchange for Emacs

[[https://travis-ci.org/vermiculus/sx.el][https://travis-ci.org/vermiculus/sx.el.svg?branch=master]]
[[https://gitter.im/vermiculus/sx.el?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge][https://badges.gitter.im/Join Chat.svg]]
[[https://www.waffle.io/vermiculus/sx.el][https://badge.waffle.io/vermiculus/sx.el.svg]]

StackMode will be a full featured Stack Exchange mode for GNU Emacs 24
and up. Using the official API, we aim to create a more versatile
experience for the Stack Exchange network within Emacs itself.

* Features
- ~list-questions~ ::
     List questions on a StackExchange site.
- Viewing Posts ::
  - Use =jknp= to open questions from within ~list-questions~; use
    =RET= to move focus.
  - Use =v= to open the site in your browser.
  - Use =TAB= to fold questions and answers.
** Planned
- Archiving questions for offline access
- Browsing and favoriting networks
- Advanced searching
- Writing questions, answers, and comments (with source code in its
  native major mode)
- Notifications
- Reputation reporting
- ...

Have a feature in mind that isn't on the list?  Submit a pull request
to add it to the list!  If you want to discuss it first, pop in our
Gitter chatroom (badge above) -- someone will be around shortly to
talk about it.
* Installation
To install the development version, follow the usual steps:
- Clone this repository
- Add this directory to your ~load-path~
- Issue ~(require 'sx-question-list)~
This should give you access to the only entry point function at the
moment, ~list-questions~.

Eventually, this package will at least be available on MELPA.
Depending on community involvement, it may even be submitted to the
official GNU ELPA.
* Contributing
Please help contribute! Doing any of the following will help us immensely:
 - [[https://github.com/vermiculus/sx.el/issues/new][Open an issue]]
 - [[https://github.com/vermiculus/sx.el/pulls][Submit a pull request]]
 - [[https://gitter.im/vermiculus/sx.el][Suggest a package or library in our Chat on Gitter]]
 - Spread the word!

For a better view of all of the open issues, take a look at our lovely
[[http://www.waffle.io/vermiculus/sx.el][Waffle board]].  Feel free to take the torch on anything in =backlog= or
=ready=.  If you have thoughts on any other issues, don't hesitate to
chime in!
* Resources
- [[http://www.gnu.org/software/emacs/][GNU Emacs]]
- [[https://api.stackexchange.com/docs][Stack Exchange API v2.2]]
- [[http://stackapps.com/apps/oauth/register][StackApps Registration Page]]
- [[http://www.emacswiki.org/emacs/ModeTutorial][Creating Major Modes for Emacs]]
** Icons
Stack Exchange Mode for Emacs has no explicit use for an icon,
although standard SVG files have been gathered in =resources/= if
anyone would fancy a crack at it.

- [[file:resources/emacs.svg][Emacs icon]]
- [[file:resources/stackexchange.svg][Stack Exchange icon]]