File	Date	Author	Commit
img	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
libs	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
nws	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
README.org	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
feeds.xml	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
index.php	2014-04-20	xaccrocheur	[fd5992] Seconde one
nws-clean-cache.php	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
nws-favicon.php	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
nws-load-feed.php	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
nws-manage.php	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
nws-style.css	2014-04-20	xaccrocheur	[5f0bc2] Initial commit
screenshot.png	2014-04-20	xaccrocheur	[5f0bc2] Initial commit

Read Me

* NWS

** NWS is an online news reader

   NWS is a php CMS to manage various XML (RSS, aTom, etc) news feeds
   and present them in a nice, ergonomic fashion. I made it to replace the online
   news services that I use up until around 2007, when they became bloated and
   crippled with spyware. It's really a [[https://github.com/xaccrocheur/nws/blob/master/screenshot.png][barebones]] system, but I've
   been using it for +weeks+ years now, and it basically does what I want.

*** Features
   - AJAX (asynchronous) loading of the feeds (ie reload one single feed w/o reloading the whole page)
   - Handles any charset encoding/langage
   - Grabs the most out of the description text and displays it as standard tooltip on mouse hover
   - Does its best to parse any given feed and identify it w/o questions
   - Plays nice with different resolutions & ergonomics, ie phones, tablets, etc
   - Directly links to any included image (and sound file)
   - If any, displays item image, wrapped around text (displays it full width if it's the only item's element, or if it comes from a photoblog - set those up [[https://github.com/xaccrocheur/nws/blob/master/nws-load-feed.php][here]])
   - Totally self-contained. No linked librairies, online commodities or, heaven forbid, "statistics" trackers
   - Lightweight and standard (valid HTML5 code)

*** Installation
   - Copy the files in a directory within a webserver root.
   - Point your browser to that webserver's directory. That's it.
   - Recommended : Protect (restrict access to) the back-office
     - Use [[https://duckduckgo.com/?q%3Dhtpassword%2Bgenerator][a trusted online htpassword generator]] (You can also create user/password pair(s) directly on the server with the command "htpasswd -b .access username password")
     - Paste this user/password pair in a file, and upload it as nws/.access (or another - secure - location, see below)
     - Optional : Move the .access out of the http server root, and edit .htaccess to reflect this change.

*** Usage
   - Navigate the tabs with < left and > right arrow keys (and r & t)
   - Use the "Manage feeds" link to access the "back office"
     - Use the "add a new feed" text entry field at the bottom to enter a new feed
     - Use the "new tab" text entry field to create a new category
     - Use the "change this feed's tab" menu to re-categorize the feed
     - Use the "promote this feed" (^) link to bump up a feed as 1st of its tab
     - Use the "delete this feed" (x) link to delete a feed
   - Or directly edit [[https://github.com/xaccrocheur/nws/blob/master/feeds.xml][feeds.xml]] (way faster).
   - Use "Pin tab" in your browser to prevent tab clutter
   - Use [[http://www.firefoxfacts.com/2013/08/14/back-is-close/][Back is close]] to quickly go back to where you were

*** LICENSE
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.