/nndiscourse

A Gnus backend for Discourse

Primary LanguageEmacs LispGNU General Public License v3.0GPL-3.0

Build Status

A Gnus backend for Discourse.

screenshot.png

Install

As described in Getting started, ensure melpa's whereabouts in init.el or .emacs:

(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/"))

Then

M-x package-refresh-contents RET
M-x package-initialize RET
M-x package-install RET nndiscourse RET

Alternatively, directly clone this repo and make install.

Also see Troubleshooting.

Usage

Suppose you want to follow https://emacs-china.org. In your .emacs or init.el, use ONE of the following:

;; Applies to first-time Gnus users
(custom-set-variables '(gnus-select-method
    (quote (nndiscourse "emacs-china.org" (nndiscourse-scheme "https")))))

or, if you're an existing Gnus user,

;; Applies to existing Gnus users
(add-to-list 'gnus-secondary-select-methods
    (quote (nndiscourse "emacs-china.org" (nndiscourse-scheme "https"))))

Then M-x gnus.

Select a topic category via RET. Rapidly catch yourself up via N and P. Instantly catch-up with c.

From the *Group* buffer, press g to refresh all categories. M-g on a particular category to refresh individually.

From the summary buffer, /o redisplays posts already read. x undisplays them.

Gnus beginners may find the interface bewildering. In particular, categories with no unread posts do not display. Use L to bring them out of hiding.

Troubleshooting

Clone this repo. Then install Cask. Then try make test-run-interactive.