diff options
author | Ben Morrison <ben@gbmor.dev> | 2019-08-29 06:41:45 -0400 |
---|---|---|
committer | Ben Morrison <ben@gbmor.dev> | 2019-08-29 06:41:45 -0400 |
commit | df6f3d1bb8b62599e6f7d3b9c17bea7f1f6250bb (patch) | |
tree | 2c89805c308e6a757972c1953200bddf966ae4b6 | |
parent | 25323a54aed498f03fca1bd99935db004d4217fd (diff) | |
download | clinte-df6f3d1bb8b62599e6f7d3b9c17bea7f1f6250bb.tar.gz |
updated readme with build deps, installation
-rw-r--r-- | README.md | 60 |
1 files changed, 56 insertions, 4 deletions
diff --git a/README.md b/README.md index 0472192..fd2e6a0 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,61 @@ # clinte [![Build Status](https://travis-ci.com/gbmor/clinte.svg?branch=master)](https://travis-ci.com/gbmor/clinte) [![codecov](https://codecov.io/gh/gbmor/clinte/branch/master/graph/badge.svg)](https://codecov.io/gh/gbmor/clinte) -Command-line community notice board. Post simple notes for other users to see. Username is tagged automatically. +Command-line community notice board. Post simple notes for other users to see. -Limits: -* Title -> 30 chars -* Body -> 500 chars +## Features + +* Username is tagged based on the executing user +* Shows the 30 most recent posts in descending order +* Title <= 30 chars +* Body <= 500 chars [![Screenshot](https://github.com/gbmor/clinte/blob/master/assets/clinte.png)](https://github.com/gbmor/clinte/blob/master/assets/clinte.png) + +## Installation + +Current build dependencies are as follows: + +* `rustc/cargo >= 1.36` +* `libsqlite3-dev` + +The installation for the build deps will vary based on your OS (`Linux, BSD`) + +Clone the repository and jump into the directory: + +``` +$ git clone git://github.com/gbmor/clinte.git +... +$ cd clinte +``` + +Run the makefile and install: + +``` +$ make +... +...Done! + +$ sudo make install +``` + +## Usage + +Issuing the program name itself will list +the currently available posts, like in the screenshot above. + +To make a new post: + +``` +$ clinte post +``` + +`clinte` will then ask for the title of the post, and the body. The username will be +tagged automatically by your logged-in username, reflecting its intended use on +multi-user UNIX-like systems. + +## Contributing + +This is very new, so feel free to hack on it in any way you +please and submit a PR! I'll be working on it myself over the next several days +to flesh it out. + |