From 623a2134817f91e333cfa8735b26a2de8136718c Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Wed, 27 May 2015 23:29:02 -0500 Subject: Extend README * Section about the question buffer * More specific info about authentication process Begins to address #291. --- README.org | 67 ++++++++++++++++++++++++++++++++++++++++++++++---------------- 1 file changed, 50 insertions(+), 17 deletions(-) diff --git a/README.org b/README.org index 9fec35b..9e75753 100644 --- a/README.org +++ b/README.org @@ -6,36 +6,56 @@ [[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]] -SX is a full featured Stack Exchange mode for GNU Emacs 24+. Using the official +SX is a full-featured Stack Exchange mode for GNU Emacs 24+. Using the official API, it provides a versatile experience for the Stack Exchange network within Emacs itself. [[file:list-and-question.png]] * Features +As always, =C-h m= is the definitive resource for functionality, but here are a +few highlights: ** Viewing Questions -View questions with one of the ~sx-tab-~ commands. These translate to the -different 'tabs' that you can view on the official site. Implemented tabs +*** Question Lists +View questions with one of the ~sx-tab-~ commands. These translate roughly to +the different 'tabs' that you can view on the official site. Implemented tabs include: - ~sx-tab-all-questions~ :: All questions. -- ~sx-tab-unanswered~ :: Unanswered questions. -- ~sx-tab-unanswered-my-tags~ :: Unanswered questions in your followed tags. -- ~sx-tab-featured~ :: Featured questions. -- ~sx-tab-starred~ :: Your starred questions. - -Each of these opens up a list of questions, and you can further customize the +- ~sx-tab-unanswered~ :: u Unanswered questions. +- ~sx-tab-unanswered-my-tags~ :: U Unanswered questions in your followed tags. +- ~sx-tab-featured~ :: f Featured questions. +- ~sx-tab-starred~ :: * Your starred questions. +- ~sx-tab-frontpage~ :: h The frontpage of the site. +- ~sx-tab-meta-or-main~ :: m Toggle between the meta and main sites. +- ~sx-tab-newest~ :: n Newest questions first. +- ~sx-tab-topvoted~ :: v Highest-scoring questions first. +- ~sx-tab-week~ :: w Hot questions of the week. + +You can use ~sx-tab-switch~ (=s t=) to switch between some of these tabs. Each +of these opens up a list of questions, and you can further customize the ordering of the list with =O=. Other keys include: -- =s s= :: Switch site. - =n= and =p= :: Navigate the list. - =j= and =k= :: Navigate while viewing the question in a separate buffer. -- =v= :: Visit the thing-at-point in your browser -- =w= :: Copy the thing-at-point (usually a link). -- =u= and =d= :: Upvote and downvote. +- =s s= :: Switch site. +- =v= :: Visit the ~thing-at-point~ in your browser. +- =w= :: Copy the ~thing-at-point~ (usually a link). +n- =u= and =d= :: Upvote and downvote. - =RET= :: Open the question buffer. -As always, =C-h m= is the definitive resource for the functions of this mode. +*** Questions and Answers +- =u= and =d= :: Upvote and downvote the question, answer, or comment at point. +- =a= :: Add an answer. +- =e= :: Edit the question or answer (or comment if it's yours; the usual rules + apply) +- =*= :: Star the question. +- =K= :: Delete the question/answer/comment if you are able. +- =w= :: Copy code at point. + +** Your Inbox +- ~sx-inbox~ :: View your inbox +- ~RET~ :: Visit inbox item * Installation SX is now available on MELPA! Both the stable release and the development @@ -44,9 +64,22 @@ version can be found there. Install it via the Package Menu or just run M-x package-install RET sx RET= #+END_SRC -If you are going to be doing any asking / answering / commenting / upvoting / -downvoting / /etc./, you must use ~sx-authenticate~ to provide SX with an -authentication token to act on your behalf. +** Authenticating +If you are going to be doing any +asking/answering/commenting/upvoting/downvoting/ /etc./, you must use +~sx-authenticate~ to provide SX with an authentication token to act on your +behalf. + +After authentication, you will be redirected to the project page. This page +will prominently display your authentication token. *Keep this secret!* It's as +good as your password as far as StackExchange is concerned. Copy and paste the +token into the prompt in Emacs. + +#+BEGIN_QUOTE +SX will store this authentication token in plain text in the =sx= folder of +your =.emacs.d=. Please take any and all steps necessary to protect the +security of your account. This token is as good as a password. +#+END_QUOTE * Contributing Please help contribute! Doing any of the following will help us immensely: -- cgit v1.2.3 From eadd51cce8cce89eed5bdc85c71e2bc5140b26f1 Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Thu, 28 May 2015 06:26:37 -0500 Subject: Add sample keybindings Related: #291 --- README.org | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/README.org b/README.org index 9e75753..dbd7528 100644 --- a/README.org +++ b/README.org @@ -81,6 +81,36 @@ your =.emacs.d=. Please take any and all steps necessary to protect the security of your account. This token is as good as a password. #+END_QUOTE +** Sample Keybindings +*** With =use-package= +#+BEGIN_SRC elisp + (require 'use-package) + + (use-package sx + :config + (bind-keys :prefix "C-c s" + :prefix-map my-sx-map + :prefix-docstring "Keymap for SX global functionality." + ("q" . sx-tab-all-questions) + ("i" . sx-inbox) + ("o" . sx-open-link) + ("u" . sx-tab-unanswered-my-tags) + ("a" . sx-ask) + ("s" . sx-search))) +#+END_SRC +*** Standard +Shamelessly stolen from [[http://endlessparentheses.com/sx-el-announcement-and-more-launcher-map.html][Endless Parentheses]]. +#+BEGIN_SRC elisp +(define-prefix-command 'launcher-map) +(global-set-key (kbd "s-l") 'launcher-map) +(define-key launcher-map "qq" #'sx-tab-all-questions) +(define-key launcher-map "qi" #'sx-inbox) +(define-key launcher-map "qo" #'sx-open-link) +(define-key launcher-map "qu" #'sx-tab-unanswered-my-tags) +(define-key launcher-map "qa" #'sx-ask) +(define-key launcher-map "qs" #'sx-search) +#+END_SRC + * Contributing Please help contribute! Doing any of the following will help us immensely: - [[https://github.com/vermiculus/sx.el/issues/new][Open an issue]] -- cgit v1.2.3 From 48a338a57ab4dd0eb465432cda2aeaaebbb2761c Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Thu, 28 May 2015 06:40:05 -0500 Subject: Typo --- README.org | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.org b/README.org index dbd7528..50af62c 100644 --- a/README.org +++ b/README.org @@ -41,7 +41,7 @@ ordering of the list with =O=. Other keys include: - =s s= :: Switch site. - =v= :: Visit the ~thing-at-point~ in your browser. - =w= :: Copy the ~thing-at-point~ (usually a link). -n- =u= and =d= :: Upvote and downvote. +- =u= and =d= :: Upvote and downvote. - =RET= :: Open the question buffer. *** Questions and Answers -- cgit v1.2.3 From a2df7b5626c76fd5545f493020329f3def58e760 Mon Sep 17 00:00:00 2001 From: Sean Allred Date: Tue, 26 Jan 2016 20:48:40 -0600 Subject: Update README --- README.org | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/README.org b/README.org index 50af62c..f3f1a83 100644 --- a/README.org +++ b/README.org @@ -22,19 +22,21 @@ the different 'tabs' that you can view on the official site. Implemented tabs include: - ~sx-tab-all-questions~ :: All questions. -- ~sx-tab-unanswered~ :: u Unanswered questions. -- ~sx-tab-unanswered-my-tags~ :: U Unanswered questions in your followed tags. -- ~sx-tab-featured~ :: f Featured questions. -- ~sx-tab-starred~ :: * Your starred questions. -- ~sx-tab-frontpage~ :: h The frontpage of the site. -- ~sx-tab-meta-or-main~ :: m Toggle between the meta and main sites. -- ~sx-tab-newest~ :: n Newest questions first. -- ~sx-tab-topvoted~ :: v Highest-scoring questions first. -- ~sx-tab-week~ :: w Hot questions of the week. - -You can use ~sx-tab-switch~ (=s t=) to switch between some of these tabs. Each -of these opens up a list of questions, and you can further customize the -ordering of the list with =O=. Other keys include: +- ~sx-tab-unanswered~ :: =u= Unanswered questions. +- ~sx-tab-unanswered-my-tags~ :: =U= Unanswered questions in your followed tags. +- ~sx-tab-featured~ :: =f= Featured questions. +- ~sx-tab-starred~ :: =*= Your starred questions. +- ~sx-tab-frontpage~ :: =h= The frontpage of the site. +- ~sx-tab-meta-or-main~ :: =m= Toggle between the meta and main sites. +- ~sx-tab-newest~ :: =n= Newest questions first. +- ~sx-tab-topvoted~ :: =v= Highest-scoring questions first. +- ~sx-tab-week~ :: =w= Hot questions of the week. + +Inside SX buffers, you can switch to other tabs by typing =s= followed by the key +listed with the tab above. You can also use ~sx-tab-switch~ (=s t=) to switch +between tabs with completion. Each of these opens up a list of questions, and +you can further customize the ordering of the list with =O=. Other keys +include: - =n= and =p= :: Navigate the list. - =j= and =k= :: Navigate while viewing the question in a separate buffer. @@ -90,7 +92,7 @@ security of your account. This token is as good as a password. :config (bind-keys :prefix "C-c s" :prefix-map my-sx-map - :prefix-docstring "Keymap for SX global functionality." + :prefix-docstring "Global keymap for SX." ("q" . sx-tab-all-questions) ("i" . sx-inbox) ("o" . sx-open-link) @@ -98,7 +100,7 @@ security of your account. This token is as good as a password. ("a" . sx-ask) ("s" . sx-search))) #+END_SRC -*** Standard +*** Standard (With Prefix Key) Shamelessly stolen from [[http://endlessparentheses.com/sx-el-announcement-and-more-launcher-map.html][Endless Parentheses]]. #+BEGIN_SRC elisp (define-prefix-command 'launcher-map) -- cgit v1.2.3