From 1b91a31c1f2be8fd5fac501b2affa8390b74f6b3 Mon Sep 17 00:00:00 2001 From: Dendy Date: Fri, 1 Jan 2021 14:17:38 +0100 Subject: [PATCH] Update README.md, .gitignore and settings organization --- .gitignore | 4 ++++ README.md | 21 ++++++++++++++------- include/settings.php.default | 10 ++++++++++ 3 files changed, 28 insertions(+), 7 deletions(-) create mode 100644 include/settings.php.default diff --git a/.gitignore b/.gitignore index 50e73d5..ca57ae0 100755 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,10 @@ +### Project specific ### + +config.php *.db *~ *.secret +include/settings.php ### Vim ### # Swap diff --git a/README.md b/README.md index 5f90a97..41684d7 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,28 @@ +# Librecat + 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. +It's PHP based, only depending on the SQLite3 PHP extension. -# Features +## Features - Fancy URL handling (opt-in) -- Social media response posting (mastodon API and Twitter support) +- Social media response posting (Mastodon API and Twitter support) - Custom theme support - No JS used by default -# URL Rewrites +## Installing -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. +1. Choose the web server you want, install PHP and PHP's SQLite3 extension. +2. Copy ```include/settings.php.default``` to ```include/settings.php``` and customize the options you want + +## URL Rewrites + +URL Rewrites are optional, but recommended for a more polished look. They can be activated in ```include/settings.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 ``` nginx rewrite ^/$ /index.php last; @@ -28,6 +35,6 @@ rewrite ^/(.*)\.(.*)$ /$1.$2 last; rewrite ^/(.*)$ /$1.php last; ``` -# Contributing +## Contributing Pull requests and issues are welcome diff --git a/include/settings.php.default b/include/settings.php.default new file mode 100644 index 0000000..c213eb5 --- /dev/null +++ b/include/settings.php.default @@ -0,0 +1,10 @@ +