nicethings/README.md

51 lines
1.6 KiB
Markdown
Raw Normal View History

# nicethings
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
A program for shared unix servers, specifically [tilde.town](https://tilde.town), to cheer people up .
2020-01-20 19:17:21 +00:00
2020-06-15 18:19:47 +00:00
# Table of Contents
2020-01-20 19:17:21 +00:00
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
- [How it works](#how-it-works)
2020-06-15 18:09:05 +00:00
- [How it works in detail](#how-it-works-in-detail)
- [Installation](#installation)
2020-01-20 19:17:21 +00:00
- [Usage](#usage)
<!-- markdown-toc end -->
2018-11-12 02:50:10 +00:00
# How it works
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
Users collaborate by adding or removing nice messages to their own
list, where the messages are combined and then displayed at random by
any user.
2020-06-15 18:09:05 +00:00
## How it works in detail
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
* Each user has a `~/.nicethings` directory.
* Users can add messages to this file using the `nicethings add "your nice message here"` interface.
* Each message is stored in the file as separate lines. No file format is used.
* Users can display a numbered list of the messages they have stored using the `nicethings ls` interface.
* Users can remove their own messages using the `nicethings rm 2` interface, where the number refers to an item in their list.
* Users can view a random message from a random user using the `nicethings` interface (with no arguments).
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
# Installation
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
1. Run `git clone https://github.com/m455/nicethings`
2. Run `cd nicethings`
3. Run `make` for further instructions.
2018-08-07 18:12:28 +00:00
2020-06-15 18:09:05 +00:00
# Usage
2020-01-20 19:17:21 +00:00
2020-06-15 18:09:05 +00:00
```
town nicethings [<command>] [<args>]
Commands:
No command - Print a random nice thing.
add - Add a message to the list of nice things.
ls - Print a numbered list of the nice things you have added.
rm - Remove a message you have added from the list of nice things.
Examples:
town nicethings
town add \"You are beautiful\"
town ls
town rm 2
```