Setup

<h2>Server setup</h2> <p>Stream of Consciousness runs with Ruby/<span class="caps">CGI</span>. I run this via mod_ruby but plain <span class="caps">CGI</span> mode should work. You can acquire mod_ruby <a href="http://www.modruby.net/en/">here</a>. Installation may vary, but on my Debian 4/Apache2 server, appended the following to apache2.conf worked for me:</p> <pre> AddType text/html .rhtml <IfModule mod_ruby.c> RubyRequire apache/ruby-run RubyRequire apache/eruby-run RubySafeLevel 0 # Execute *.rbx files as Ruby scripts <Files *.rbx> Options +ExecCGI SetHandler ruby-object RubyHandler Apache::RubyRun.instance </Files> # Handle *.rhtml files as eRuby files <Files *.rhtml> SetHandler ruby-object RubyHandler Apache::ERubyRun.instance </Files> </IfModule> </pre> <p>If you are setting this up on a shared web host, the following should be helpful: http://www.urbanhonking.com/ideasfordozens/archives/2008/03/developing_sing.html</p> <h2>Basic setup</h2> <p>Once this is done you should be able to drop the index.rbx file in any directory in your web site, create a directory to hold your blog posts, edit the “blog_title” and “datadir” options at the bare minimum.</p> <p>Posts should go in the directory specified by the “datadir” option. A post is a plain text file. The first line is the title of the post, and the read of it will be the body. You can place your posts in subdirectories which will show up on the site as categories.</p> <p>Go ahead and make a test post, then load up index.rbx in your browser, the posts should show up.</p> <p>You can also create content pages, define the “pagedir” option, and make your pages just like a blog post… title on the first line and the rest of the file will be the body. If you have pages, they will show up on the right hand side.</p> <h2>Advanced setup</h2> <p>In addition to the above, you can enable “pretty links” with the following .htaccess:</p> <pre> DirectoryIndex index.rbx <IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule (.*) /index.rbx/$1 [L] </IfModule> </pre> <p>Instead of editing the index.rbx file directly, you can also create an options file named “blog.conf.php” in the same dir as index.html. copy the @settings hash over removing the @. The file should look like:</p> <pre> settings = { :blog_title => "Blog Title", # What's this blog's description (for outgoing RSS feed)? :blog_description => "A Stream of Consciousness Blog", # What's this blog's primary language (for outgoing RSS feed)? :blog_language => "en", # Where are this blog's entries kept? :datadir => "/home/username/blogdata", #What directory will static pages be served from? :pagedir => "/home/username/pagedata", :pagevar => "pages", # What's my preferred base URL for this blog (leave blank for automatic)? :url => "http://www.mysite.com", # How many entries should I show on the home page? :num_entries => 10, # What file extension signifies a blosxom entry? :file_extension => "txt", # What is the default flavour? :default_flavour => "html", :plugindir => "/home/username/plugins", :themedir => "/home/username/theme" } </pre> <p>This allows you to run multiple sites from the same index.rbx file and makes for easier upgrades when new versions are released.</p> 2009-11-26T21:48:19-08:00 122061 setup

93145

Setup

2009-02-18T11:38:31-08:00

41378