dickmao / nndiscourse

A Gnus backend for Discourse

A Gnus backend for Discourse.

We Moved To Gitawonk

https://gitawonk.com/dickmao/nndiscourse.git

Git paid, not played.

Does not work for sites requiring login

Some discourse instances allow unfettered public viewing, e.g., emacs-china.org, devforum.roblox.com. Others require login, e.g., discourse.doomemacs.org. At the time I wrote nndiscourse, it was impossible to get login going, and while it does seem possible now, it still looks really hard and undocumented.

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-install RET nndiscourse RET

You will also need Bundler for Ruby.

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.