aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorFuwn <[email protected]>2021-02-20 23:22:00 +0000
committerFuwn <[email protected]>2021-02-20 23:22:00 +0000
commitb1b29f1b6c91879838c8b01c4f5a3c4b7a86ec77 (patch)
treebf5e932b2ee8e0899743b4963375156ca13ceff0 /README.md
parentchore, fix: refactor returns, grammar. (diff)
downloadchan-b1b29f1b6c91879838c8b01c4f5a3c4b7a86ec77.tar.xz
chan-b1b29f1b6c91879838c8b01c4f5a3c4b7a86ec77.zip
chore, fix, refactor: desc.
chore: - update readme fix: - grammer refactor: - undo previous commit return refactor
Diffstat (limited to 'README.md')
-rw-r--r--README.md29
1 files changed, 23 insertions, 6 deletions
diff --git a/README.md b/README.md
index a51a6ac..ae9a26a 100644
--- a/README.md
+++ b/README.md
@@ -23,25 +23,42 @@ A simple "chan"-like board written in Rust.
```
## Inspirational
-Originally, this project was supposed to be a public [OpenPGP](https://www.openpgp.org/) key server because I was frustrated with the current selection of key servers, but I randomly had the idea to make a "chan"-like forum and I had this sitting around so I made this!
+Originally, this project was supposed to be a public [OpenPGP](https://www.openpgp.org/) key server
+because I was frustrated with the current selection of key servers, but I randomly had the idea to
+make a "chan"-like forum and I had this sitting around so I made this!
## Limitations
-At the moment, the board is missing automatic post pruning and moderation features, but I have plans to finish adding them in the near future. As well, at the moment, there has to be a 'empty' thread entry in the 'threads' table within the database, for now. This is becaus of the way that the thread making feature grabs valid board data. I'll probably fix this sometime soon also.
+At the moment, the board is missing automatic post pruning and moderation features, but I have plans
+ to finish adding them in the near future. As well, at the moment, there has to be a 'empty' thread
+ entry in the 'threads' table within the database, for now. This is because of the way that the
+ thread making feature grabs valid board data. I'll probably fix this sometime soon also.
-Ignore my messy Handlebars templates, I didn't really have a purpose to make them fancy or whatever because of the simplicity of the project.
+Ignore my messy Handlebars templates, I didn't really have a purpose to make them fancy or whatever
+because of the simplicity of the project.
## Usage
1. Install [Rust](https://www.rust-lang.org/).
2. Clone the repository.
-3. `$ cargo run`.
+3. Rename the [`chan.db.example`](./chan.db.example) file to `chan.db`.
+4. `$ cargo run`.
+
+### Usage Notes
+[`chan.db.example`](./chan.db.example) is the default format of the database. If you ever want to
+"restore" the database to its default state, I recommend you keep a copy of the original state of
+this file.
+
+In the future, I will *most likely* add a `setup_db()` function to validate the database state and
+properly setup the database when an invalid format is found.
### Adding boards
-To add boards, open the example database in a SQLite viewer add a board entry to the 'boards' table (examples provided in database).
+To add boards, open the example database in a SQLite viewer add a board entry to the 'boards' table
+(examples provided in database).
Pre-built binaries *might* be available in the future if there is enough demand for them.
## Contribution
-Feel free to make pull requests or open issues if you think a feature should be added or you find a bug, or just anything --- within reason.
+Feel free to make pull requests or open issues if you think a feature should be added or you find a
+bug, or just anything -- within reason.
### License
[GNU Affero General Public License v3.0](https://github.com/fuwn/chan/blob/main/LICENSE.md)