Add README.md

This commit is contained in:
Dendy 2021-01-01 14:02:48 +01:00
parent f101b8e259
commit 84e12ff78b
Signed by: dendy
GPG Key ID: 0168B35FFD7F608F
1 changed files with 42 additions and 0 deletions

42
README.md Normal file
View File

@ -0,0 +1,42 @@
Librecat is a ask.fm/curiouscat clone but FLOSS.
It tries to be as minimal as possible while being
a comfortable alternative to those mentioned while
not using JS (at least for default theme).
It's PHP based, only depending on the sqlite3 php
extension.
# Features
- Fancy URL handling (opt-in)
- Social media response posting (mastodon API and Twitter support)
- Custom theme support
- No JS used by default
# URL Rewrites
URL Rewrites are optional, but recommended for
a more polished look. They can be activated in
```include/config.php``` with proper http server
rewrite rules configurations.
For now there's only Nginx implementation of those.
Feel free to contribute since they're a little messy
(but they work as expected)
## Nginx
``` nginx
rewrite ^/$ /index.php last;
rewrite ^/(.*).php$ /$1.php last;
rewrite ^/(.*).css$ /$1.css last;
rewrite ^/user/(.*)?(.*) /user.php?q=$1&$2 last;
rewrite ^/user/(.*) /user.php?q=$1 last;
rewrite ^/config/(.*)$ /config.php?q=$1 last;
rewrite ^/(.*)\.(.*)$ /$1.$2 last;
rewrite ^/(.*)$ /$1.php last;
```
# Contributing
Pull requests and issues are welcome