|build-status| |melpa-dev|

  Procrastination can be a full-time job.

A Gnus backend for Hacker News.

.. |build-status|
   image:: https://github.com/dickmao/nnhackernews/workflows/CI/badge.svg?branch=dev
   :target: https://github.com/dickmao/nnhackernews/actions
   :alt: Build Status
.. |melpa-dev|
   image:: https://melpa.org/packages/nnhackernews-badge.svg
   :target: http://melpa.org/#/nnhackernews
   :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:: screencast.gif

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 nnhackernews RET

Alternatively, copy ``nnhackernews.el`` to a directory among ``C-h v RET load-path`` and add ``(require 'nnhackernews)`` to ``.emacs``.

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 (nnhackernews ""))))

or, if you're an existing Gnus user,

::

   ;; Applies to existing Gnus users
   (add-to-list 'gnus-secondary-select-methods '(nnhackernews ""))

Then ``M-x gnus``.

Enter the ``nnhackernews:news`` newsgroup with ``RET``.

Gnus will only show followup comments for threads you read, so be selective.  If you accidentally read a thread, or decide the thread is uninteresting, you may ``C-k`` it to prevent Gnus from showing followups.  Use ``C-k`` liberally.

The signal-to-noise of the hackernews firehose is such that I often "catch-up" via ``c`` to flush the unread threads.

Create a post via ``a``.

Reply to articles with ``f`` or ``r``.  Include original with ``F``.

Vote articles by ``R =`` (up), or ``R 0`` (retract).

From the ``*Group*`` buffer, press ``g`` to refresh all groups.  ``M-g`` on a particular group to refresh individually.

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

``S c`` cancels articles.

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

Gnus For a New Generation
=========================
The Gnus software that the author himself uses is at https://github.com/dickmao/gnus.
His changes include non-blocking fetch, and fixing threads sorting.

.. _Getting started: http://melpa.org/#/getting-started