aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorV.Krishn <vkrishn4@gmail.com>2015-08-12 12:56:49 +0530
committerV.Krishn <vkrishn4@gmail.com>2015-08-12 12:56:49 +0530
commit985072dacbdb35e73ed3ba0d901d507c31f951f6 (patch)
tree79855d470c57f1ef88f4317952e13a7cb3f6ff98 /doc
downloadnbreader-985072dacbdb35e73ed3ba0d901d507c31f951f6.tar.bz2
initial commit
Diffstat (limited to 'doc')
-rw-r--r--doc/.docs1
-rw-r--r--doc/bookmarks.md1
-rw-r--r--doc/install-alpinelinux.md21
-rw-r--r--doc/install.md50
4 files changed, 73 insertions, 0 deletions
diff --git a/doc/.docs b/doc/.docs
new file mode 100644
index 0000000..8d1c8b6
--- /dev/null
+++ b/doc/.docs
@@ -0,0 +1 @@
+
diff --git a/doc/bookmarks.md b/doc/bookmarks.md
new file mode 100644
index 0000000..8d1c8b6
--- /dev/null
+++ b/doc/bookmarks.md
@@ -0,0 +1 @@
+
diff --git a/doc/install-alpinelinux.md b/doc/install-alpinelinux.md
new file mode 100644
index 0000000..67965cd
--- /dev/null
+++ b/doc/install-alpinelinux.md
@@ -0,0 +1,21 @@
+
+## Package dependencies
+
+* php-apache2
+* php-xml
+* php-phar
+* php-sqlite3
+* php-json
+* php-ctype
+* php-curl
+* wget
+* newsbeuter
+
+eg.
+`apk add php-apache2 php-xml php-phar php-sqlite3 php-json php-ctype php-curl wget newsbeuter`
+
+### Issues (see `doc/install.md`):
+1. Download required 3rd party libs/css used in application.
+2. Set session path in `config/config.ph`p
+3. Set session, db, data folder permissions in `var/newsbeuter`
+
diff --git a/doc/install.md b/doc/install.md
new file mode 100644
index 0000000..ba7af3d
--- /dev/null
+++ b/doc/install.md
@@ -0,0 +1,50 @@
+
+
+## A. Create rss/atom list file
+
+1. Add rss/atom feeds url in 'urls list file'.
+ See `config/readme.notes`
+2. For every url list file in `config/url.local`
+ there needs to be a corresponding database file
+ in `var/newsbeuter/db`.
+
+ If you have not run `update`, you can test run by
+ copying `config/empty.loc.db` to `var/newsbeuter/db`.
+
+ eg. for list file `config/url/news` the database file
+ name would be `var/newsbeuter/db/news.loc.db`
+
+ There is no need to have multiple urls list file,
+ if you want to keep things simple and store all
+ data into single file.
+
+## B. 3rd Party libs
+
+1. Download 3rd party libs/css used in application,
+ unzip it in public/lib/<other web libs>
+
+## C. Configs
+
+1. Change install variables in `scripts/env.sh` as needed.
+
+2. Change install variables in `public/index.php` as needed.
+
+3. Change install variables in
+ `public/application/config/newsbeuter.php` as needed.
+
+4. Run `sh run.sh config`
+
+
+## D. Fix Directory Permissions
+
+**Make sure following directory/files are web writable**
+1. `var/newsbeuter/db`
+2. `var/newsbeuter/data`
+3. `var/newsbeuter/session`
+
+
+
+**ENJOY !**
+
+
+