89 lines
2.9 KiB
ReStructuredText
89 lines
2.9 KiB
ReStructuredText
|build-status| |melpa-dev|
|
|
|
|
|
|
.. |build-status|
|
|
image:: https://github.com/dickmao/nnreddit/workflows/CI/badge.svg?branch=dev
|
|
:target: https://github.com/dickmao/nnreddit/actions
|
|
:alt: Build Status
|
|
.. |melpa-dev|
|
|
image:: https://melpa.org/packages/nnreddit-badge.svg
|
|
:target: http://melpa.org/#/nnreddit
|
|
:alt: MELPA current version
|
|
.. |melpa-stable|
|
|
image:: http://melpa-stable.milkbox.net/packages/ein-badge.svg
|
|
:target: http://melpa-stable.milkbox.net/#/ein
|
|
:alt: MELPA stable version
|
|
|
|
.. image:: https://github.com/dickmao/gnus-imap-walkthrough/blob/master/thumbnail.png
|
|
:target: https://youtu.be/DMpZtC98F_M
|
|
:alt: Replacing Thunderbird With Gnus
|
|
|
|
.. image:: screenshot.png
|
|
.. |--| unicode:: U+2013 .. en dash
|
|
.. |---| unicode:: U+2014 .. em dash, trimming surrounding whitespace
|
|
:trim:
|
|
|
|
Install
|
|
=======
|
|
Alas, you'll need Cask_. Then,
|
|
|
|
::
|
|
|
|
git clone https://github.com/dickmao/nnreddit.git
|
|
PYTHON=python3.8 make install
|
|
|
|
Also see Troubleshooting_.
|
|
|
|
Usage
|
|
=====
|
|
In your ``.emacs`` or ``init.el``, use ONE of the following:
|
|
|
|
::
|
|
|
|
;; Applies to first-time Gnus users
|
|
(custom-set-variables '(gnus-select-method (quote (nnreddit ""))))
|
|
|
|
or, if you're an existing Gnus user,
|
|
|
|
::
|
|
|
|
;; Applies to existing Gnus users
|
|
(add-to-list 'gnus-secondary-select-methods '(nnreddit ""))
|
|
|
|
Then ``M-x gnus``.
|
|
|
|
Initial setup should guide you through OAuth and find your existing subreddit subscriptions.
|
|
|
|
Select a subreddit via ``RET``. Rapidly catch yourself up via ``N`` and ``P``. Instantly catch-up with ``c``.
|
|
|
|
Create a post via ``a``.
|
|
|
|
Reply to articles with ``f`` or ``r``. Include original with ``F``.
|
|
|
|
Vote articles via ``R -`` (down), ``R =`` (up), or ``R 0`` (retract).
|
|
|
|
From the ``*Group*`` buffer, press ``g`` to refresh all subreddits. ``M-g`` on a particular subreddit to refresh individually.
|
|
|
|
From the summary buffer, ``/o`` redisplays articles already read. ``x`` undisplays them.
|
|
|
|
``S s`` edits articles.
|
|
|
|
``S c`` cancels articles.
|
|
|
|
``R g [subreddit]`` takes you to an *unsubscribed* subreddit.
|
|
|
|
You can subscribe to it via the ``u`` keybinding from the ``*Group*`` buffer [1]_.
|
|
|
|
Gnus beginners may find the interface bewildering. In particular, subreddits with no unread articles do not display. Use ``L`` to bring them out of hiding.
|
|
|
|
|
|
|
|
|
.. [1] Gnus users are familiar with the tragedy of ``u`` doing double duty as subscriber and unsubscriber. ``u`` is really a toggle even though the attached command is ``gnus-group-unsubscribe-current-group`` |---| if that doesn't trigger your UX sensibility, then never mind I mentioned it.
|
|
|
|
.. _walkthrough: https://github.com/dickmao/gnus-imap-walkthrough
|
|
.. _Cask: https://github.com/cask/cask#installation
|
|
.. _Getting started: http://melpa.org/#/getting-started
|
|
.. _ELPASO: http://github.com/dickmao/elpaso
|
|
.. _virtualenv: https://virtualenv.pypa.io/en/stable
|
|
.. _PRAW: https://github.com/praw-dev/praw/pull/1094
|