Reader refactoring

[dragfyre]

The reader functionality was originally conceived as a way to display the Baha'i Writings in a readable and attractive way, using Discord embeds. We did a fair bit of work on this and got the Hidden Words (Arabic and Persian) fully working, as seen in the screenshot below.

However, many of the other Writings we wanted to add contained paragraphs which were too long to be displayed within Discord embeds, which are limited to 2048 characters in length. As a result, we opened issue #2 to discuss the possibility of a paging system. Other bots have similar systems in place to display long messages.

To make a long story short, this issue was never resolved due to its growing complexity and a lack of free time to deal with it. For now, the paging issue has been closed as "wontfix", although there is no prejudice against reopening it in the future. We've taken a different tack for now, which is simply to add commands that jump to certain paragraphs and pages of the Writings which are hosted on the web (ex.: bahai-library.org).

This issue can serve as a home for ongoing discussions about what we want to do with the bot's reader / Writings reference functionality. Key questions include:

• Do we want to try adding more texts that can be displayed using embeds, as we had originally envisioned? If so, which texts?
• Should embeds be reserved for short quotes that don't need to be paged?
• How do we harmonize reader embeds with the "jump-to-para/jump-to-page" functionality? Do we even need to?

[brettz9]

We've taken a different tack for now, which is simply to add commands that jump to certain paragraphs and pages of the Writings which are hosted on the web (ex.: bahai-library.org).

Note that bahai-library.com has at least two advantages--it offers GET URLs which transparently lead to the paragraph/selection in question, and it's main page has a link leading back to one of the wikis (bahai9.com) (the tags lead back to the other wikis).

[dragfyre]

We came up with the idea of repurposing /read as a way of showing short inspirational quotes instead of reading entire texts. This would have a couple of benefits:

• We can keep the quotes short so that they display within the 2048 character embed limit, so paging isn't needed;
• We can organize and format quote files the way we like, which may help us avoid display issues;
• We can keep and further expand the reader beyond just the Hidden Words, providing even more value to users;
• We can have a clearer distinction between the Writings search commands and this one (which we could rename /quote).

Please feel free to discuss! We'll probably leave this task on the back burner for now and come back to it later.

[brettz9]

Already renamed now to /quote, so that to-do is done.

[dragfyre]

Per conversation on Discord earlier today, we will be adding functionality to display the Hidden Words in multiple languages, specifically "the 6 U.N. languages".

[dragfyre]

I'll close this issue and open a new one (#17) that focuses on /quote. It seems pretty clear that we're taking this path now, so the "question" that prompted this issue is more or less resolved.