RubyGems - compages - Versions diffs - 0.4.0 - Mend

compages 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (257) hide show

data/.project +18 -0
data/README +180 -0
data/Rakefile +10 -0
data/app/controllers/application.rb +4 -0
data/app/controllers/contents_controller.rb +116 -0
data/app/controllers/pages_controller.rb +59 -0
data/app/controllers/render_controller.rb +24 -0
data/app/helpers/application_helper.rb +6 -0
data/app/helpers/contents_helper.rb +5 -0
data/app/helpers/pages_helper.rb +5 -0
data/app/helpers/render_helper.rb +2 -0
data/app/models/content.rb +26 -0
data/app/models/meta_data.rb +3 -0
data/app/models/page.rb +106 -0
data/app/models/page_element.rb +9 -0
data/app/views/contents/_content_preview.rhtml +1 -0
data/app/views/contents/_contents_list.rhtml +3 -0
data/app/views/contents/_show_library.rhtml +60 -0
data/app/views/contents/_write_now.rhtml +42 -0
data/app/views/layouts/pages.rhtml +24 -0
data/app/views/layouts/render.rhtml +11 -0
data/app/views/pages/_change_theme.rhtml +0 -0
data/app/views/pages/_edit_menu.rhtml +62 -0
data/app/views/pages/_page_listed.rhtml +13 -0
data/app/views/pages/_select_theme.rhtml +4 -0
data/app/views/pages/edit.rhtml +35 -0
data/app/views/pages/index.rhtml +45 -0
data/app/views/pages/list.rhtml +41 -0
data/app/views/pages/list_a.rhtml +40 -0
data/app/views/pages/welcome.rhtml +27 -0
data/app/views/render/_blank.rhtml +3 -0
data/app/views/render/show.rhtml +1 -0
data/bin/compages +14 -0
data/config/boot.rb +44 -0
data/config/database.yml.home +35 -0
data/config/environment.rb +53 -0
data/config/environments/development.rb +21 -0
data/config/environments/production.rb +18 -0
data/config/environments/test.rb +19 -0
data/config/routes.rb +32 -0
data/db/Copia di schema.rb +48 -0
data/db/migrate/001_create_pages.rb +12 -0
data/db/migrate/002_create_contents.rb +12 -0
data/db/migrate/003_create_meta_datas.rb +14 -0
data/db/migrate/004_create_page_elements.rb +17 -0
data/db/migrate/005_add_urlnames.rb +15 -0
data/db/migrate/006_add_sessions.rb +15 -0
data/db/schema.mysql.sql +65 -0
data/db/schema.postgresql.sql +65 -0
data/db/schema.rb +49 -0
data/db/schema.sqlite.sql +65 -0
data/db/schema.sqlserver.sql +71 -0
data/db/schema_version +1 -0
data/doc/ER-model/v1.dia +0 -0
data/doc/ER-model/v2.dia +0 -0
data/doc/ER-model/v3.dia +0 -0
data/doc/README_FOR_APP +2 -0
data/doc/esempi/doc-vir/ecds.htm +2362 -0
data/doc/esempi/doc-vir/ecds_files/search.gif +0 -0
data/doc/esempi/doc-vir/ecds_files/upld.gif +0 -0
data/doc/esempi/doc-vir/ecds_files/upld.jpg +0 -0
data/installer/apache13.conf.example.template +33 -0
data/installer/apache20.conf.example.template +40 -0
data/installer/lighttpd.conf.example.template +6 -0
data/installer/rails_installer_defaults.yml +5 -0
data/lib/redcloth.rb +1130 -0
data/lib/render_engine.rb +94 -0
data/lib/tasks/release.rake +46 -0
data/public/.htaccess +41 -0
data/public/404.html +8 -0
data/public/500.html +8 -0
data/public/_index.html +277 -0
data/public/favicon.ico +0 -0
data/public/images/body_bg.gif +0 -0
data/public/images/body_bg_short.gif +0 -0
data/public/images/ie_shadow.png +0 -0
data/public/images/journal_reflex.gif +0 -0
data/public/images/journal_shadow.gif +0 -0
data/public/images/logo_journal_small.bmp +0 -0
data/public/images/logo_journal_small.png +0 -0
data/public/images/page_edit_shadow.png +0 -0
data/public/images/restore_bar.png +0 -0
data/public/images/spinner.gif +0 -0
data/public/javascripts/application.js +23 -0
data/public/javascripts/controls.js +815 -0
data/public/javascripts/dragdrop.js +913 -0
data/public/javascripts/effects.js +958 -0
data/public/javascripts/lowpro.js +307 -0
data/public/javascripts/prototype.js +2006 -0
data/public/robots.txt +1 -0
data/public/stylesheets/compages.css +196 -0
data/public/stylesheets/editing.css +180 -0
data/public/stylesheets/editing_ie_filth.css +36 -0
data/public/themes/Doc_basic/_script.js +342 -0
data/public/themes/Doc_basic/images/Thumbs.db +0 -0
data/public/themes/Doc_basic/images/search.gif +0 -0
data/public/themes/Doc_basic/images/upld.gif +0 -0
data/public/themes/Doc_basic/images/upld.jpg +0 -0
data/public/themes/Doc_basic/index.html +114 -0
data/public/themes/Doc_basic/style.css +1743 -0
data/public/themes/color7boxes/default2.css +42 -0
data/public/themes/color7boxes/index.html +40 -0
data/public/themes/prova/index.html +12 -0
data/public/zDoc/images/search.gif +0 -0
data/public/zDoc/images/upld.gif +0 -0
data/public/zDoc/images/upld.jpg +0 -0
data/public/zDoc/index.html +176 -0
data/public/zDoc/script.js +342 -0
data/public/zDoc/style.css +1741 -0
data/script/about +3 -0
data/script/breakpointer +3 -0
data/script/console +3 -0
data/script/destroy +3 -0
data/script/generate +3 -0
data/script/performance/benchmarker +3 -0
data/script/performance/profiler +3 -0
data/script/plugin +3 -0
data/script/process/reaper +3 -0
data/script/process/spawner +3 -0
data/script/runner +3 -0
data/script/server +3 -0
data/test/fixtures/contents.yml +5 -0
data/test/fixtures/meta_datas.yml +5 -0
data/test/fixtures/page_elements.yml +5 -0
data/test/fixtures/pages.yml +5 -0
data/test/functional/contents_controller_test.rb +18 -0
data/test/functional/pages_controller_test.rb +18 -0
data/test/functional/render_controller_test.rb +18 -0
data/test/test_helper.rb +28 -0
data/test/unit/content_test.rb +10 -0
data/test/unit/meta_data_test.rb +10 -0
data/test/unit/page_element_test.rb +10 -0
data/test/unit/page_test.rb +10 -0
data/tmp/sessions/ruby_sess.0ced4c30e36477ab +0 -0
data/tmp/sessions/ruby_sess.20fbe26671422e70 +0 -0
data/tmp/sessions/ruby_sess.2c72521f3a7e2ba9 +0 -0
data/tmp/sessions/ruby_sess.4107a69d982a2eb7 +0 -0
data/tmp/sessions/ruby_sess.573ded9c7fdd9035 +0 -0
data/tmp/sessions/ruby_sess.5a9767815bb96258 +0 -0
data/tmp/sessions/ruby_sess.85d723b794005388 +0 -0
data/tmp/sessions/ruby_sess.875b3b3e3529afdb +0 -0
data/tmp/sessions/ruby_sess.936766f3a397c88b +0 -0
data/tmp/sessions/ruby_sess.984e2e4c9a2e7891 +0 -0
data/tmp/sessions/ruby_sess.a1faebd7448bc45d +0 -0
data/tmp/sessions/ruby_sess.a415768c7635bc15 +0 -0
data/tmp/sessions/ruby_sess.b2dadcbe6c1b0add +0 -0
data/tmp/sessions/ruby_sess.ca9100beb103a428 +0 -0
data/tmp/sessions/ruby_sess.d649c800a046efde +0 -0
data/tmp/sessions/ruby_sess.db73bbfafd5a537c +0 -0
data/tmp/sessions/ruby_sess.e32487b847524df1 +0 -0
data/tmp/sessions/ruby_sess.f4e45d67828cc437 +0 -0
data/tmp/sessions/ruby_sess.f5a3f064f2f7a26f +0 -0
data/tmp/sessions/ruby_sess.ff0c47b35f238cda +0 -0
data/vendor/plugins/acts_as_urlnameable.tar.gz +0 -0
data/vendor/plugins/acts_as_urlnameable/LICENSE +19 -0
data/vendor/plugins/acts_as_urlnameable/README +193 -0
data/vendor/plugins/acts_as_urlnameable/Rakefile +25 -0
data/vendor/plugins/acts_as_urlnameable/TODO +5 -0
data/vendor/plugins/acts_as_urlnameable/db/00x_add_urlnames_table.rb +15 -0
data/vendor/plugins/acts_as_urlnameable/db/urlnames_table.sql +7 -0
data/vendor/plugins/acts_as_urlnameable/doc/classes/ActiveRecord/Acts/Urlnameable/ClassMethods.html +167 -0
data/vendor/plugins/acts_as_urlnameable/doc/classes/ActiveRecord/Acts/Urlnameable/InstanceMethods.html +213 -0
data/vendor/plugins/acts_as_urlnameable/doc/classes/ActiveRecord/Acts/Urlnameable/SingletonMethods.html +189 -0
data/vendor/plugins/acts_as_urlnameable/doc/created.rid +1 -0
data/vendor/plugins/acts_as_urlnameable/doc/files/LICENSE.html +129 -0
data/vendor/plugins/acts_as_urlnameable/doc/files/README.html +333 -0
data/vendor/plugins/acts_as_urlnameable/doc/files/TODO.html +121 -0
data/vendor/plugins/acts_as_urlnameable/doc/files/lib/acts_as_urlnameable_rb.html +101 -0
data/vendor/plugins/acts_as_urlnameable/doc/fr_class_index.html +29 -0
data/vendor/plugins/acts_as_urlnameable/doc/fr_file_index.html +30 -0
data/vendor/plugins/acts_as_urlnameable/doc/fr_method_index.html +34 -0
data/vendor/plugins/acts_as_urlnameable/doc/index.html +24 -0
data/vendor/plugins/acts_as_urlnameable/doc/rdoc-style.css +208 -0
data/vendor/plugins/acts_as_urlnameable/init.rb +3 -0
data/vendor/plugins/acts_as_urlnameable/lib/acts_as_urlnameable.rb +159 -0
data/vendor/plugins/acts_as_urlnameable/lib/urlname.rb +3 -0
data/vendor/plugins/acts_as_urlnameable/test/acts_as_urlnameable_test.rb +233 -0
data/vendor/plugins/acts_as_urlnameable/test/connection.rb +8 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/article.rb +13 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/articles.yml +62 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/page.rb +14 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/pages.yml +35 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/people.yml +9 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/person.rb +26 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/schema.rb +24 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/section.rb +5 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/sections.yml +9 -0
data/vendor/plugins/acts_as_urlnameable/test/fixtures/urlnames.yml +153 -0
data/vendor/plugins/acts_as_urlnameable/test/test_helper.rb +42 -0
data/vendor/plugins/gems/README +30 -0
data/vendor/plugins/gems/init.rb +9 -0
data/vendor/plugins/gems/tasks/gems_tasks.rake +32 -0
data/vendor/plugins/unobtrusive_javascript/CHANGELOG +72 -0
data/vendor/plugins/unobtrusive_javascript/README +73 -0
data/vendor/plugins/unobtrusive_javascript/Rakefile +33 -0
data/vendor/plugins/unobtrusive_javascript/about.yml +6 -0
data/vendor/plugins/unobtrusive_javascript/assets/javascripts/lowpro.js +307 -0
data/vendor/plugins/unobtrusive_javascript/init.rb +21 -0
data/vendor/plugins/unobtrusive_javascript/install.rb +1 -0
data/vendor/plugins/unobtrusive_javascript/lib/actionview_helpers_patches.rb +17 -0
data/vendor/plugins/unobtrusive_javascript/lib/asset_tag_helper_patches.rb +33 -0
data/vendor/plugins/unobtrusive_javascript/lib/behaviour_caching.rb +70 -0
data/vendor/plugins/unobtrusive_javascript/lib/controllers/unobtrusive_javascript_controller.rb +52 -0
data/vendor/plugins/unobtrusive_javascript/lib/prototype_helper_patches.rb +72 -0
data/vendor/plugins/unobtrusive_javascript/lib/scriptaculous_helper_patches.rb +62 -0
data/vendor/plugins/unobtrusive_javascript/lib/tag_helper_patches.rb +37 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs.rb +32 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/behaviour_helper.rb +62 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/behaviour_script.rb +54 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/behaviour_script_converter.rb +23 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/controller_methods.rb +55 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/helpers.rb +152 -0
data/vendor/plugins/unobtrusive_javascript/lib/ujs/javascript_proxies.rb +57 -0
data/vendor/plugins/unobtrusive_javascript/tasks/unobtrusive_javascript_tasks.rake +15 -0
data/vendor/plugins/unobtrusive_javascript/test/asset_tag_helper_patches_test.rb +32 -0
data/vendor/plugins/unobtrusive_javascript/test/behaviour_helper_test.rb +180 -0
data/vendor/plugins/unobtrusive_javascript/test/behaviour_script_converter_test.rb +72 -0
data/vendor/plugins/unobtrusive_javascript/test/behaviour_script_test.rb +98 -0
data/vendor/plugins/unobtrusive_javascript/test/config/environment.rb +8 -0
data/vendor/plugins/unobtrusive_javascript/test/config/routes.rb +4 -0
data/vendor/plugins/unobtrusive_javascript/test/config/schema.rb +3 -0
data/vendor/plugins/unobtrusive_javascript/test/controller_methods_test.rb +48 -0
data/vendor/plugins/unobtrusive_javascript/test/helpers_test.rb +186 -0
data/vendor/plugins/unobtrusive_javascript/test/javascript_proxies_test.rb +3 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/boot.rb +26 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/gem/action_controller.rb +11 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/gem/action_mailer.rb +4 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/gem/active_record.rb +27 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/gem/rails.rb +31 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/ptk.rb +148 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/ptk/suite/difference.rb +23 -0
data/vendor/plugins/unobtrusive_javascript/test/lib/stubs/controller_stub.rb +10 -0
data/vendor/plugins/unobtrusive_javascript/test/ptk_helper.rb +29 -0
data/vendor/plugins/unobtrusive_javascript/test/tag_helper_patches_test.rb +59 -0
data/vendor/plugins/unobtrusive_javascript/test/test_helper.rb +25 -0
data/vendor/plugins/unobtrusive_javascript/test/unobtrusive_javascript_controller_test.rb +95 -0
data/vendor/plugins/unobtrusive_javascript/uninstall.rb +1 -0
data/vendor/redcloth/bin/redcloth +3 -0
data/vendor/redcloth/doc/CHANGELOG +160 -0
data/vendor/redcloth/doc/COPYING +25 -0
data/vendor/redcloth/doc/README +106 -0
data/vendor/redcloth/doc/REFERENCE +216 -0
data/vendor/redcloth/doc/make.rb +359 -0
data/vendor/redcloth/lib/redcloth.rb +1130 -0
data/vendor/redcloth/run-tests.rb +28 -0
data/vendor/redcloth/setup.rb +1376 -0
data/vendor/redcloth/tests/code.yml +105 -0
data/vendor/redcloth/tests/hard_breaks.yml +26 -0
data/vendor/redcloth/tests/images.yml +171 -0
data/vendor/redcloth/tests/instiki.yml +39 -0
data/vendor/redcloth/tests/links.yml +155 -0
data/vendor/redcloth/tests/lists.yml +77 -0
data/vendor/redcloth/tests/markdown.yml +218 -0
data/vendor/redcloth/tests/poignant.yml +64 -0
data/vendor/redcloth/tests/table.yml +198 -0
data/vendor/redcloth/tests/textism.yml +406 -0
metadata +432 -0

data/vendor/plugins/acts_as_urlnameable/doc/created.rid ADDED

	@@ -0,0 +1 @@
1	+ Fri Mar 10 16:08:29 EST 2006

data/vendor/plugins/acts_as_urlnameable/doc/files/LICENSE.html ADDED

@@ -0,0 +1,129 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: LICENSE</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>LICENSE</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>LICENSE
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Fri Mar 10 14:52:56 EST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+Copyright &#169; 2006 Gabriel Gironda
+</p>
+<p>
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+&quot;Software&quot;), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+</p>
+<p>
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+</p>
+<p>
+THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.
+</p>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/vendor/plugins/acts_as_urlnameable/doc/files/README.html ADDED

@@ -0,0 +1,333 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>File: README</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+  <div id="fileHeader">
+    <h1>README</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>README
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Fri Mar 10 16:08:00 EST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <h2>About</h2>
+<p>
+This plugin provides an easy way to give your ActiveRecord models clean
+urlnames, for use anywhere you don&#8217;t want to use a plain old integer
+id.
+</p>
+<p>
+To use it, first either copy over the migration in
+<tt>db/00x_add_urlnames_table.rb</tt> and migrate it to it, or import the
+SQL in <tt>db/urlnames_table.sql</tt>.
+</p>
+<p>
+This plugin also requires at least Rails 1.1 (currently edge. See <a
+href="http://wiki.rubyonrails.com/rails/pages/EdgeRails">wiki.rubyonrails.com/rails/pages/EdgeRails</a>)
+For updates see <a
+href="http://gabriel.gironda.org">gabriel.gironda.org</a>, and for
+licensing see LICENSE.
+</p>
+<hr size="2"></hr><h2>Simple usage:</h2>
+<h3>Setting the url name</h3>
+<p>
+The usage that will work for 80% of cases is this:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title
+        end
+</pre>
+<p>
+This will format the value of the <tt>title</tt> attribute of the record to
+one suitable for use in a URL and save it. Further changes to
+<tt>title</tt> will not overwrite the url name. The value can then be
+accessed with +object.urlname+. If the url name already exists, an error
+will be added to the <tt>urlname</tt> attribute.
+</p>
+<p>
+To allow overwrites of the url name, call <tt>acts_as_urlname</tt> with the
+following option:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :overwrite =&gt; true
+        end
+</pre>
+<h3>Validation</h3>
+<p>
+The url name will now be overwritten if the value of <tt>title</tt>
+changes. To change the default validation message you can use the
+<tt>:message</tt> option:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :overwrite =&gt; true, :message =&gt; 'is unavailable.'
+        end
+</pre>
+<h3>Finding records</h3>
+<p>
+Records can be located via the <tt>find_by_urlname</tt> method, like so:
+</p>
+<pre>
+        Article.find_by_urlname('some_urlname')
+</pre>
+<hr size="2"></hr><h2>Advanced usage:</h2>
+<p>
+This section is for those of us who like to mess with ActiveRecord a little
+more than usual.
+</p>
+<h3>Setting the url name</h3>
+<p>
+You can set objects to be known by any past url names they may have had,
+even if the current one is different. The usage in this case would be:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :mode =&gt; :multiple
+        end
+</pre>
+<p>
+The instance method <tt>past_urlnames</tt> will then return all url names
+other than the current one, while <tt>all_urlnames</tt> will return all url
+names the object has ever been known by, including the current url name.
+The <tt>:overwrite</tt> option has no effect on objects with multiple
+urlnames for obvious reasons.
+</p>
+<p>
+You can also define your own <tt>urlnameify</tt> method if you would prefer
+not to use the default url name formatting.
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :mode =&gt; :multiple
+                protected
+                def urlnameify(text)
+                        text.to_s.downcase + '_permalink'
+                end
+        end
+</pre>
+<h3>Validation</h3>
+<p>
+Acts as Urlnameable gives you five options for validation:
+</p>
+<pre>
+        * Skip any kind of validation (usually undesirable)
+        * Validating against the base class (the default)
+        * Validating against the child class (for use with single table inheritance)
+        * Validating against the parent object (for associations)
+        * Define your own validate_urlname method
+</pre>
+<h4>Skipping validation</h4>
+<p>
+To skip validation, use the plugin like so:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :mode =&gt; :multiple, :validate =&gt; false
+        end
+</pre>
+<h4>Validating against the base class or child class</h4>
+<p>
+If you&#8217;re using single table inheritance in ActiveRecord, and your
+models look like this for example:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title
+        end
+        class SpecialArticle &lt; Article
+        end
+        class Draft &lt; Article
+        end
+</pre>
+<p>
+Then by default, a Draft can not have the same url name as a
+SpecialArticle. If you&#8217;d like to change this behaviour, then use the
+<tt>:sti_class</tt> option with <tt>:validate</tt>
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :validate =&gt; :sti_class
+        end
+</pre>
+<p>
+Now Draft and SpecialArticle can have the same url name set.
+<tt>SpecialArticle.find_by_urlname</tt> will find only the SpecialArticle
+with the matching url name, and <tt>Draft.find_by_urlname</tt> will find
+only the Draft with the url name given.
+</p>
+<p>
+<tt>Article.find_by_urlname</tt> will find the first Article with the given
+url name, whereas <tt>Article.find_all_by_urlname</tt> will find both the
+Draft and SpecialArticle objects.
+</p>
+<h4>Validating against the parent object</h4>
+<p>
+Here&#8217;s an example model setup:
+</p>
+<pre>
+        class Person &lt; ActiveRecord::Base
+                has_many :articles
+        end
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title
+                belongs_to :person
+        end
+</pre>
+<p>
+If you would like to validate the url name for an article against the
+parent object, pass the name of the <tt>belongs_to</tt> association as the
+option for <tt>:validate</tt>. Example:
+</p>
+<pre>
+        class Article &lt; ActiveRecord::Base
+          acts_as_urlnameable :title, :validate =&gt; :person
+                belongs_to :person
+        end
+</pre>
+<p>
+Now for the validation to work properly, you must instantiate the new
+article through the association. This is best explained like this:
+</p>
+<pre>
+        # Find two different people
+        bob = Person.find_by_first_name('bob')
+        joe = Person.find_by_first_name('joe')
+        # Have Bob write a new article
+        bobs_article = bob.articles.build(:title =&gt; &quot;My first article&quot;, :body =&gt; &quot;This is my first article&quot;)
+        bobs_article.save      # passes validation and saves ok
+        # Have Joe write a new article
+        joes_article = joe.articles.build(:title =&gt; &quot;My first article&quot;, :body =&gt; &quot;This is my first article&quot;)
+        joes_article.save              # passes validation and saves ok
+        # Find Bob's first article
+        bob.articles.find_by_urlname('my_first_article')
+        # Find Joe's first article
+        joe.articles.find_by_urlname('my_first_article')
+</pre>
+<p>
+Both articles validate because the validation is scoped against the owner.
+Bob and Joe can both have articles known as &#8216;my_first_article&#8217;,
+and the finder method will find only their own articles.
+<tt>Article.find_all_by_urlname(&#8216;my_first_article&#8217;)</tt> will
+find both articles.
+</p>
+<h4>Custom validation</h4>
+<p>
+You can also define your own validate_urlname method in the class for
+custom validation, like so:
+</p>
+<pre>
+        class Person &lt; ActiveRecord::Base
+          acts_as_urlnameable :first_name
+                protected
+                def validate_urlname
+                        if Person.find_by_urlname(attr_to_urlname)
+                                errors.add(:urlname, 'is not available.')
+                        elsif attr_to_urlname == 'bob'
+                                errors.add_to_base('You might be Bob, and I hate Bob.')
+                        end
+                end
+        end
+</pre>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>