diff options
author | elijah <elijah@riseup.net> | 2012-10-19 18:51:19 -0700 |
---|---|---|
committer | elijah <elijah@riseup.net> | 2012-10-19 18:51:19 -0700 |
commit | ce9871692a2e34220c0f4986f5ce1b307cc77c1a (patch) | |
tree | b9f23d9c5fc404d72883831e714d2353d7623c33 | |
parent | e4f2547fbabab8080e9a7678f38203874c52c45d (diff) |
updated readme
-rw-r--r-- | Capfile | 2 | ||||
-rw-r--r-- | README | 122 |
2 files changed, 85 insertions, 39 deletions
@@ -1,3 +1,3 @@ load 'deploy' -load 'deploy/assets' +# load 'deploy/assets' (disabled. see development.rb comment regarding the config.assets.prefix option) load 'config/deploy' # remove this line to skip loading any of the default tasks @@ -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 |