public
Description: BrowserCMS: Humane Content Management for Rails
Homepage: http://browsercms.org
Clone URL: git://github.com/browsermedia/browsercms.git
peakpg (author)
Mon Jun 01 10:32:04 -0700 2009
commit  13f82a4b14c222d9846dd9a4d023951eb7455c85
tree    11959640d8c19103a9068f3b3152b664dc4e112e
parent  17b125e098970fc618972bdf7cb68159f8d36846
name age message
file .gitignore Wed Apr 29 13:37:48 -0700 2009 Git should now ignore local .idea files for Rub... [peakpg]
file COPYRIGHT.txt Wed Feb 25 12:33:15 -0800 2009 Added initial version of License (LGPL), GPL an... [patrick]
file GPL.txt Wed Feb 25 12:33:15 -0800 2009 Added initial version of License (LGPL), GPL an... [patrick]
file LICENSE.txt Wed Feb 25 12:33:15 -0800 2009 Added initial version of License (LGPL), GPL an... [patrick]
file README.markdown Thu May 14 14:21:53 -0700 2009 Updated user documentation and API docs to depl... [peakpg]
file Rakefile Sun Apr 19 15:25:11 -0700 2009 Changing to browsercms.gemspec as github requir... [nate]
file VERSION.yml Mon Aug 24 08:34:10 -0700 2009 Version bump to 3.0.2 [peakpg]
directory app/ Tue May 26 13:36:20 -0700 2009 Fix for #36. The Rich text editor toggle now co... [peakpg]
file browsercms.gemspec Loading commit data...
directory config/ Wed May 27 13:24:40 -0700 2009 Fix for #56. Condensed all TIMESTAMP_create_xyx... [peakpg]
directory db/ Wed May 27 13:24:40 -0700 2009 Fix for #56. Condensed all TIMESTAMP_create_xyx... [peakpg]
directory doc/
directory lib/ Mon Jun 01 10:31:13 -0700 2009 Bumped internal build # [peakpg]
directory log/ Wed Aug 27 08:27:56 -0700 2008 removing all log files from subversion git-svn... [pbarry]
directory public/ Tue May 26 13:11:17 -0700 2009 Fix for #17. Refined the behavior of the file u... [peakpg]
directory rails/ Wed Apr 22 07:15:28 -0700 2009 Renamed gem to browsercms [pjb3]
directory rails_generators/ Fri May 29 15:27:52 -0700 2009 Fix for #2. Project creation and script/generat... [unknown]
directory script/ Wed Dec 03 17:38:51 -0800 2008 Major refactoring for behaviors, User.current, ... [pbarry]
directory templates/ Fri May 29 15:27:52 -0700 2009 Fix for #2. Project creation and script/generat... [unknown]
directory test/ Fri May 29 15:27:52 -0700 2009 Fix for #2. Project creation and script/generat... [unknown]
directory tmp/ Wed Aug 27 08:27:56 -0700 2008 removing all log files from subversion git-svn... [pbarry]
directory vendor/ Tue Mar 03 07:49:42 -0800 2009 Replaced rspec tests with test unit tests git... [pbarry]
README.markdown

BrowserCMS: Humane Content Management for Rails

(3.0 Beta) - Not quite done, but ready to be tinkered with.

BrowserCMS is a general purpose, open source Web Content Management System (CMS), written in Ruby on Rails. It is designed to support three distinct groups of people:

  1. Non-technical web editors who want a humane system to manage their site, without needing to understand what HTML or even Rails is.
  2. Designers who want to create large and elegantly designed websites with no artificial constraints by the CMS.
  3. Developers who want to drop a CMS into their Rails projects, or create CMS driven websites for their clients.

Features

BrowserCMS is intended to offer features comparable to commercial CMS products, which can support larger teams of editors. This means having a robust set of features as part of its core, as well as the capability to customize it via modules.

Here's a quick overview of some of the more notable features:

  • It's just Rails: Each CMS project is a rails project that depends on the BrowserCMS gem. Developers can add new controllers, views, etc; just like any rails project.
  • Direct in context editing: Users can browse their site to locate content and change it right on the page itself.
  • Design friendly Templates: Pages aren't just a template and giant single chunk of HTML. Templates can be built to have multiple editable areas, to allow for rich designs that are still easy to manage by non-technical users.
  • Sitemap: An explorer/finder style view of sections and pages in a site allowing users to add and organize pages.
  • Content Library: Provides a standardized 'CRUD' interface to allow users to manage both core and custom content types.
  • Content API: A set of behaviors added to ActiveRecord which allow for versioning, auditing, tagging and other content services provided by the CMS.
  • Section Based Security: Admins can control which users can access specific sections (public users), as well as who can edit which pages (cms users).
  • Workflow: Supports larger website teams where some users can contribute, but not publish. Users can assign work to other publishers to review.
  • Page Caching: Full page caching allows the web server (Apache) to serve HTML statically when they don't change.

License

BrowserCMS is released under a LGPL license, and is copyright 1998-2009 BrowserMedia. The complete copyright can be found in COPYRIGHT.txt, and copy of the license can be found in LICENSE.txt.

Getting Started

Before you can use BrowserCMS, you will need to install the gem. See the Getting Started guide at http://browsercms.org/doc/guides/html/getting_started.html, or packaged with this source code (under doc/guides/html/getting_started.html)

Documentation

The user documentation and guides for this version of the application can be found at:

  1. http://browsercms.org/doc/guides/html/index.html - User guides and manuals that cover the features and general functionality of the project. (Found locally at doc/guides/html/index.html)
  2. http://browsercms.org/doc/app/index.html - The RDoc API documenation (locally at doc/app/index.html)

Modifying the source

If you want to experiment with the source code, the BrowserCMS project can bootstrap itself as a web application. This allows developers who want to contribute to the project to easily alter and test changes. To run the application itself, do the following:

cd /path/to/browsercms_source_code
rake reset
script/server

This will drop the 'browsercms_development' database, loads the same sample data from the demo.rb template. By default, the core project is setup to use mysql as the database, but you can change that via the database.yml files.

Support

The homepage for the BrowserCMS project is http://browsercms.org. From there you can find links to the discussion groups and our twitter account. If you have questions about the project or want to get involved, the Google group is the best way to do so. If you would like to report a bug, please do so at https://browsermedia.lighthouseapp.com/projects/28481-browsercms-30