From ce9871692a2e34220c0f4986f5ce1b307cc77c1a Mon Sep 17 00:00:00 2001
From: elijah <elijah@riseup.net>
Date: Fri, 19 Oct 2012 18:51:19 -0700
Subject: updated readme

---
 README | 122 +++++++++++++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 84 insertions(+), 38 deletions(-)

(limited to 'README')

diff --git a/README b/README
index fe15f45..3c98d8d 100644
--- a/README
+++ b/README
@@ -1,76 +1,122 @@
-ABOUT THIS APP
+About this web application
+============================
 
-  The LEAP public website is lightweight rails application that just mostly
-  serves up (semi) static templates.
+The LEAP public website is lightweight rails application that just mostly
+serves up (semi) static templates.
 
-  No databases are used or harmed in the making of this website.
+No databases are used or harmed in the making of this website.
 
-  The goal with this web app is to be as flexible and lightweight as possible,
-  and to support stellar localization.
+The goal with this web app is to be as flexible and lightweight as possible,
+and to support stellar localization.
 
-  There are numerous ruby tools to build static websites, but I found them to
-  not be good for localization and to be too inflexible.
+There are numerous ruby tools to build static websites, but I found them to
+not be good for localization and to be too inflexible.
 
 Installation
 
-  bundle install
+    sudo apt-get install ruby ruby-dev rubygems
+    gem install bundler
+    git clone git://leap.se/leap_website
+    cd leap_website
+    bundle
 
-Running
+Running in development mode
 
-  rails server
+    cd leap_website
+    rails server
 
-Console
+Console examples
 
-  rails console
-  rails console production
-  rails dbconsole
+    rails console
+    rails console production
+    rails dbconsole
 
 Rake takes
 
-  rake doc:app
+    rake doc:app
 
 Running in production (with webrick)
 
-  bundle exec rake assets:precompile
-  RAILS_ENV=production rails server
+    bundle exec rake assets:precompile
+    RAILS_ENV=production rails server
+
+
+Modifying pages
+======================================
+
+Edit the HAML files found in leap_website/pages
+
 
 Deploying
+======================================
+
+Manually
+----------------
+
+    rsync -a leap_website server:~
+    ssh server
+    cd leap_website
+    bundle install --deployment
+
+With Capistrano
+---------------------
+
+    Edit config/deploy.rb
+    cap setup
+    cap deploy
 
-  Edit config/deploy.rb
+Running with Apache
+------------------------
 
-  Apache requirements:
-    Install mod_rack
+Install Passenger (mod_rack)
 
-  Apache configuration:
+   sudo apt-get install libapache2-mod-passenger
+   
+Configure Apache
+    
     <VirtualHost *:80>
       ServerName leap.se
-      DocumentRoot /home/leap/leap.se/public
-      <Directory /home/leap/leap.se/public>
+      DocumentRoot /home/leap/leap_website/public
+      <Directory /home/leap/leap_website/public>
         Allow from all
         Options -MultiViews
       </Directory>
     </VirtualHost>
 
 
-DEV NOTES
+Development
+==============================
+
+If you change a sass source file, you must run:
+
+  rake assets:precompile RAILS_ENV=production
+
+This app uses precompiled assets.
+
+
+Development Notes
 =============================
 
-SEARCH
+Search
+---------------------------
+
+Maybe we should add search. 
 
-use this one:
-http://xapian.org/docs/bindings/ruby/
+This appears to be the most appropriate search tool to use for this static webapp: http://xapian.org/docs/bindings/ruby/
 
-how flask does it:
-  http://librelist.com/browser//flask/2012/3/21/maillinglist-archive-searchable/#ff1d34246a16845c410d2c9a411f5829
-  https://github.com/mitsuhiko/flask/blob/website/flask_website/search.py
-  https://github.com/mitsuhiko/flask/blob/website/flask_website/views/mailinglist.py
+Some notes on how flask does a similar thing::
+* http://librelist.com/browser//flask/2012/3/21/maillinglist-archive-searchable/#ff1d34246a16845c410d2c9a411f5829
+* https://github.com/mitsuhiko/flask/blob/website/flask_website/search.py
+* https://github.com/mitsuhiko/flask/blob/website/flask_website/views/mailinglist.py
 
 pure ruby, for ar: https://github.com/dougal/acts_as_indexed/
 
-STATIC CMSs
+Other static CMS in ruby
+-----------------------------
+
+* http://nestacms.com/
+* https://github.com/gma/nesta
+* https://github.com/gma/nesta-rails
+* https://github.com/quickleft/regulate -- git, engine, cms, rails
+
 
-see
-  http://nestacms.com/
-  https://github.com/gma/nesta
-  https://github.com/gma/nesta-rails
-  https://github.com/quickleft/regulate -- git, engine, cms, rails
\ No newline at end of file
-- 
cgit v1.2.3