From df6f3d1bb8b62599e6f7d3b9c17bea7f1f6250bb Mon Sep 17 00:00:00 2001 From: Ben Morrison Date: Thu, 29 Aug 2019 06:41:45 -0400 Subject: updated readme with build deps, installation --- README.md | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file 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. + -- cgit 1.4.1-2-gfad0