RubyGems - comfortable_mexican_sofa - Versions diffs - 1.0.43 → 1.0.44 - Mend

comfortable_mexican_sofa 1.0.43 → 1.0.44

Files changed (18) hide show

data/Gemfile +3 -3
data/Gemfile.lock +2 -2
data/README.md +116 -101
data/VERSION +1 -1
data/comfortable_mexican_sofa.gemspec +13 -6
data/config/initializers/comfortable_mexican_sofa.rb +2 -1
data/db/cms_seeds/example.local/layouts/default.yml +8 -0
data/db/cms_seeds/example.local/layouts/nested.yml +6 -0
data/db/cms_seeds/example.local/pages/child.yml +10 -0
data/db/cms_seeds/example.local/pages/child/subchild.yml +14 -0
data/db/cms_seeds/example.local/pages/index.yml +11 -0
data/db/cms_seeds/example.local/snippets/example.yml +4 -0
data/doc/page_editing.png +0 -0
data/doc/sofa.png +0 -0
data/lib/generators/README +2 -2
data/lib/generators/cms_generator.rb +4 -0
metadata +13 -6
data/doc/README_FOR_APP +0 -95

data/Gemfile CHANGED

@@ -6,13 +6,13 @@ gem 'paperclip',      '>=2.3.8'
 gem 'mime-types',     :require => 'mime/types'
 # If you wish to use sqlite in production
-# gem 'sqlite3-ruby',   :require => 'sqlite3'
+# gem 'sqlite3'
 group :development do
-  gem 'sqlite3-ruby',   :require => 'sqlite3'
+  gem 'sqlite3'
 end
 group :test do
-  gem 'sqlite3-ruby',   :require => 'sqlite3'
+  gem 'sqlite3'
   gem 'jeweler', '>=1.4.0'
 end

data/Gemfile.lock CHANGED

@@ -68,7 +68,7 @@ GEM
       rake (>= 0.8.7)
       thor (~> 0.14.4)
     rake (0.8.7)
-    sqlite3-ruby (1.3.2)
+    sqlite3 (1.3.3)
     thor (0.14.6)
     treetop (1.4.9)
       polyglot (>= 0.3.1)
@@ -83,4 +83,4 @@ DEPENDENCIES
   mime-types
   paperclip (>= 2.3.8)
   rails (>= 3.0.3)
-  sqlite3-ruby
+  sqlite3

data/README.md CHANGED

@@ -1,11 +1,7 @@
-Comfortable Mexican Sofa (CMS)
-==============================
+Comfortable Mexican Sofa (MicroCMS)
+===================================
-What is this?
--------------
-ComfortableMexicanSofa is a micro CMS implemented as a Rails 3.* engine. This CMS is not a full-blown application like RadiantCMS. It's more like the ComatoseCMS, only more modern and infinitely more powerful and flexible. ComfortableMexicanSofa can function as a stand-alone installation, but it's designed to be used as an extension to your Rails application. If you have any (static) content that needs to be managed this CMS will handle it.
-This CMS also allows high level of integration. You can easily use page content anywhere within your app, and even use page content as renderable templates from inside your controllers. You may also reuse CMS's admin interface for your own admin backend.
+ComfortableMexicanSofa is a tiny and powerful micro CMS for your Rails 3 application. This CMS is a plugin for your application, not the other way around. Implemented as an Engine so installation is no different than for any other plugin out there.
 Installation
 ------------
@@ -19,134 +15,153 @@ Then from the Rails project's root run:
     rails g cms
     rake db:migrate
-At this point you should have database structure created, some assets copied to /public directory and [initializer](https://github.com/twg/comfortable-mexican-sofa/blob/master/config/initializers/comfortable_mexican_sofa.rb) set up.
 Usage
 -----
-Now you should be able to navigate to http://yoursite/cms-admin
+After finishing installation you should be able to navigate to http://yoursite/cms-admin
-### Step 1: Create Layout
-Before creating pages and populating them with content we need to create a layout. Layout is the template of your pages. It defines some reusable content (like header and footer, for example) and places where the content goes. A very simple layout can look like this:
+Default username and password is 'username' and 'password'. You probably want to change it right away. Admin credentials (among other things) can be found and changed in the cms initializer: [/config/initializers/comfortable\_mexican\_sofa.rb](https://github.com/twg/comfortable-mexican-sofa/blob/master/config/initializers/comfortable_mexican_sofa.rb)
+Before creating pages and populating them with content we need to create a layout. A layout is the template of your pages; it defines some reusable content (like header and footer, for example) and places where the content goes. A very simple layout can look like this:
     <html>
       <body>
-        <h1>My Awesome Site</h1>
-        {{ cms:page:content }}
+        <h1>{{ cms:page:header:string }}</h1>
+        {{ cms:page:content:text }}
       </body>
     </html>
-So there's your layout and the `{{cms:page:content}}` defines a place where renderable `content` will go. There's just a handful of tags that you can use.
-Layout may also be linked to the `application layout`. As a result cms page content will end up inside `<%= yeild %>` of your application layout.
+Once you have a layout, you may start creating pages and populating content. It's that easy.
+![Sofa's Page Edit View](https://github.com/twg/comfortable-mexican-sofa/raw/master/doc/page_editing.png)
-#### Page Blocks
-pieces of content that will be output on the page:
+CMS Tags
+--------
+There are a number of cms tags that define where the content goes and how it's populated. **Page** and **Field** tags are used during layout creation. **Snippet**, **Helper** and **Partial** tags can be peppered pretty much anywhere. Tag is structured like so:
+    {{ cms:page:content:text }}
+        \    \     \      \
+         \    \     \      ‾ tag format or extra attributes
+          \    \     ‾‾‾‾‾‾‾ label/slug/path for the tag,
+           \    ‾‾‾‾‾‾‾‾‾‾‾‾ tag type (page, field, snippet, helper, partial)
+            ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾ cms tag identifier
+Here's a number of tag variations:
+    # Page tags are pieces of text content that will get rendered on the page. Format defines how form field
+    # gets rendered in the page editing/creation section of the admin area.
+    {{ cms:page:some_label:text }}
+    {{ cms:page:some_label }}             # shorthand for above. 'text' is default format for pages
+    {{ cms:page:some_label:string }}      # in admin area text field is displayed instead of textarea
+    {{ cms:page:some_label:datetime }}    # similarly, datetime widget in the admin area
+    {{ cms:page:some_label:integer }}     # a number field
+    {{ cms:page:some_label:rich_text }}   # TinyMCE wysiwyg editor will be used to edit this content
+    # Field tags are pieces of text content that are NOT rendered on the page. They can be accessed via
+    # your application's layout / helpers / partials etc. Useful for populating this like <meta> tags.
+    # Field formats are exactly the same as for Page tags.
+    {{ cms:field:some_label:string }}
+    {{ cms:field:some_label }}            # same as above. 'string' is default format for fields
+    # Snippet tags are bits or reusable content that can be used anywhere. Imagine creating content like
+    # a sharing widget, or business address that you want to randomly use across your site.
-    {{ cms:page:some_label:text }}      # will render a text area during page creation
-                                        # alternatively you may use: {{ cms:page:some_label }}
-    {{ cms:page:some_label:string }}    # will render a text field during page creation
-    {{ cms:page:some_label:datetime }}  # datetime select widget
-    {{ cms:page:some_label:integer }}   # a number field
+    {{ cms:snippet:some_label }}
+    # Helper is a wrapper for your regular helpers. Normally you cannot have IRB in CMS content, so there are
+    # tags that allow calling helpers and partials.
+    {{ cms:helper:method_name }}          # same as <%= method_name() %>
+    {{ cms:helper:method_name:x:y:z }}    # same as <%= method_name('x', 'y', 'z') %>
+    # Partial tags are wrappers just like above helper ones.
+    {{ cms:partial:path/to/partial }}     # same as <%= render :partial => 'path/to/partial' %>
+    {{ cms:partial:path/to/partial:a:b }} # same as <%= render :partial => 'path/to/partial',
+                                          #   :locals => { :param_1 => 'a', :param_1 => 'b' } %>
+Multiple Sites
+--------------
+Sofa is able to manage multiple sites from the same application. For instance: 'site-a.example.com' and 'site-b.example.com' will have distinct set of layouts, pages, snippets, etc. To enable multi-site functionality make sure you have this setting in the initializer: `config.auto_manage_sites = false`. When this setting is set to `true`, Sofa assumes there's only one site and will manage hostname associated with it automatically.
+Integrating CMS with your app
+-----------------------------
+Comfortable Mexican Sofa is a plugin, so it allows you to easily access content it manages. Here's some things you can do.
-#### Page Fields
-pieces of content that are not rendered. They are useful for hidden values you want to use inside your app. `@cms_page` instance variable is available when you need to access field values.
+You can use your existing application layout. When creating CMS layouts there's an option to use an application layout. Suddenly all CMS pages using that layout will be rendered through <%= yield %> of your application layout.
-    {{ cms:field:some_label:text }}     # text area for the page creation form
-    {{ cms:field:some_label:string }}   # same as {{ cms:field:some_label }}, this is a text field
-    {{ cms:field:some_label:datetime }} # datetime
-    {{ cms:field:some_label:integer }}  # a number field
+You can use CMS pages as regular views:
+    def show
+      @dinosaur = Dinosaur.find(params[:id])
+      # CMS page probably should have either helper or partial tag to display @dinosaur details
+      render :cms_page => '/dinosaur
+    end
+Actually, you don't need to explicitly render a CMS page like that. Sofa will try to rescue a TemplateNotFound by providing a matching CMS page.
-#### Snippets
-bits of reusable content that can be used in pages and layouts
+You can access **Page** or **Field** tag content directly from your application (layouts/helpers/partials) via `cms_page_content` method. This is how you can pull things like meta tags into your application layout.
-    {{ cms:snippet:snippet_slug }}
+    # if @cms_page is available (meaning Sofa is doing the rendering)
+    cms_page_content(:page_or_field_label)
-#### Helpers
-are tags that map to your view helpers methods
+    # anywhere else
+    cms_page_content(:page_or_field_label, CmsPage.find_by_slug(...))
-    {{ cms:helper:method_name }}        # gets translated to <%= method_name( ) %>
-    {{ cms:helper:method_name:x:y:z }}  # gets translated to <%= method_name('x', 'y', 'z') %>
+Similarly you can access **Snippet** content:
-#### Partials
-are exactly that. You don't want to do IRB inside CMS so there's a handy tag:
+    cms_snippet_content(:snippet_slug)
-    {{ cms:partial:path/to/partial }}     # gets translated to <%= render :partial => 'path/to/partial' %>
-    {{ cms:partial:path/to/partial:x:y }} # gets translated to <%= render :partial => 'path/to/partial',
-                                          # :locals => { :param_1 => 'x', :param_2 => 'y'} %>
-### Step 2: Create Page
-Now you're ready to create a page. Based on how you defined your layout, you should have form inputs ready to be populated.
-Save a page, and it will be accessible from the public side.
+Extending Admin Area
+--------------------
-Integrating CMS with your app
------------------------------
-Unlike most CMS solutions, Sofa is here only to help. Your application is more important. There are few useful ways you can use CMS functionality from your application.
+If you wish, you can re-use Sofa's admin area for things you need to administer in your application. To do this, first you will need to make your admin controllers to inherit from CmsAdmin::BaseController. This way, your admin views will be using Sofa's admin layout and it's basic HttpAuth.
+    class Admin::CategoriesController < CmsAdmin::BaseController
+      # your code goes here
+    end
+From your views you can user `cms_form_for` method to re-use Sofa's FormBuilder. There are also some existing styles for tables, will\_paginate helpers, etc. Take a look in [/public/stylesheets/comfortable\_mexican\_sofa/content.css](https://github.com/twg/comfortable-mexican-sofa/blob/master/public/stylesheets/comfortable_mexican_sofa/content.css)
-* When CMS renders a page, you automatically have access to `@cms_page` variable.
-* CMS can take over the rendering of views for your application. For example, http://your-app.local/books hits books\_controller#index and if you don't have a view setup CMS will try to serve a page with '/books' path. You can even force your controller to render a particular page like this: `render :cms_page => '/books'`
+You will probably want to add a navigation link on the left side, and for that you will want to use ViewHook functionality. Create a partial that has a link to your admin area and declare in in Sofa's initializer: `ComfortableMexicanSofa::ViewHooks.add(:navigation, '/admin/navigation')`. Similarly you can add extra stylesheets, etc into admin area in the same way.
+Do you have other authentication system in place (like Devise, AuthLogic, etc) and wish to use that? For that, you will need to create a module that does the authentication check and make Comfortable Mexican Sofa use it. For example:
+    module CmsDeviseAuth
+      def authenticate
+        unless current_user && current_user.admin?
+          redirect_to new_user_session_path
+        end
+      end
+    end
+You can put this module in /config/initializers/comfortable\_mexican\_sofa.rb and change authentication method: `config.authentication = 'CmsDeviseAuth'`. Now to access Sofa's admin area users will be authenticated against your existing authentication system.
 Working with fixtures
 ---------------------
-During development it's often more convenient to work with files that can be source controlled, versus putting content in the database and then manage database dump. Thankfully Sofa makes working with fixtures easy.
+Comfortable Mexican Sofa has fixtures, functionality that helps manage content during development phase. It's very different from Rails seeds as Sofa's fixtures are loaded with each page load. The database is completely bypassed when fixtures are active. This way, you can source-control content before going live, disabling fixtures and dumping everything into the database.
-### Setting up Fixtures
-First of all you need to set a path where fixture files will be found:
+First, you will need to set a path where fixture files will be found (inside Sofa's initializer):
-    # in config/initializers/comfortable_mexican_sofa.rb
     if Rails.env.development? || Rails.env.test?
       ComfortableMexicanSofa.config.seed_data_path = File.expand_path('db/cms_seeds', Rails.root)
     end
-This is an example of the file/folder structure for fixtures:
-    your-site.local/
-      - layouts/
-        - default_layout.yml
-      - pages
-        - index.yml
-        - help.yml
-        - help/
-          - more_help.yml
-      - snippets
-        - random_snippet.yml
-Then it's a matter of populating the content. Few rules to remember:
-- root page is always index.yml
-- sections of the page are defined by cms\_block\_attributes
-- parent pages are identified by full_path (slug for layouts)
-- folder structure reflects tree structure of the site
+If you ran `rails g cms`, you should find an example set of fixtures in /db/cms\_seeds directory. Please note that seeds are nested in the folder that is the hostname of your site. Each file is an YAML representation of a database entry for that layout/page/snippet.
-Example fixture files for a [layout](https://github.com/twg/comfortable-mexican-sofa/blob/master/test/cms_seeds/test.host/layouts/nested.yml), [page](https://github.com/twg/comfortable-mexican-sofa/blob/master/test/cms_seeds/test.host/pages/child/subchild.yml) and [snippet](https://github.com/twg/comfortable-mexican-sofa/blob/master/test/cms_seeds/test.host/snippets/default.yml)
-**Note:** If ComfortableMexicanSofa.config.seed\_data\_path is set no content is loaded from database. Only fixture files are used.
-### Importing fixtures into database
-Now that you have all those fixture files, how do we get them into database? Easy:
-    rake comfortable_mexican_sofa:import:all FROM=your-site.local TO=your-site.com SEED_PATH=/path/to/fixtures
+There's a rake task that makes moving fixtures into database (and vice-versa) easy:
-PATH is optional if seed\_data\_path configuration option is set.
-### Exporting database data into fixtures
-If you need to pull down database content into fixtures it's done as follows:
+    # from fixtures into database
+    rake comfortable_mexican_sofa:import:all FROM=your-site.local TO=your-site.com SEED_PATH=/path/to/fixtures
+    # from database to fixtures
     rake comfortable_mexican_sofa:export:all FROM=your-site.com TO=your-site.local SEED_PATH=/path/to/fixtures
-During import/export it will prompt you if there are any files/database entries that are going to be overwritten
-Admin Area Integration
-----------------------
-Sofa has a wonderful admin area. Why would you want to make your own layout, styling and so on if you can reuse what CMS has.
+What else?
+----------
+Versioning control will be eventually implemented. Also I'd love to hear ideas how this CMS can be improved. But feel free to just fork and hack away.
-You can easily make your controllers use layouts and CMS authentication like this:
+![Looks pretty comfortable to me. No idea what makes it Mexican.](https://github.com/twg/comfortable-mexican-sofa/raw/master/doc/sofa.png)
-    class Admin::UsersController < CmsAdmin::BaseController
-      # ...
-    end
-To add your own tabs to the admin area you can use hooks:
-    # in config/initializers/comfortable_mexican_sofa.rb
-    ComfortableMexicanSofa::ViewHooks.add(:navigation, '/path/to/view/partial')
-    ComfortableMexicanSofa::ViewHooks.add(:html_head, '/path/to/view/partial')
+ComfortableMexicanSofa is released under the [MIT license](https://github.com/twg/comfortable-mexican-sofa/raw/master/LICENSE) and is copyright 2009-11 Oleg Khabarov, [The Working Group Inc](http://www.twg.ca)

data/VERSION CHANGED

	@@ -1 +1 @@
1	- 1.0.43
1	+ 1.0.44

data/comfortable_mexican_sofa.gemspec CHANGED

@@ -5,11 +5,11 @@
 Gem::Specification.new do |s|
   s.name = %q{comfortable_mexican_sofa}
-  s.version = "1.0.43"
+  s.version = "1.0.44"
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Oleg Khabarov", "The Working Group Inc"]
-  s.date = %q{2011-02-03}
+  s.date = %q{2011-02-07}
   s.description = %q{}
   s.email = %q{oleg@theworkinggroup.ca}
   s.extra_rdoc_files = [
@@ -77,9 +77,16 @@ Gem::Specification.new do |s|
     "config/initializers/paperclip.rb",
     "config/locales/en.yml",
     "config/routes.rb",
+    "db/cms_seeds/example.local/layouts/default.yml",
+    "db/cms_seeds/example.local/layouts/nested.yml",
+    "db/cms_seeds/example.local/pages/child.yml",
+    "db/cms_seeds/example.local/pages/child/subchild.yml",
+    "db/cms_seeds/example.local/pages/index.yml",
+    "db/cms_seeds/example.local/snippets/example.yml",
     "db/migrate/01_create_cms.rb",
     "db/seeds.rb",
-    "doc/README_FOR_APP",
+    "doc/page_editing.png",
+    "doc/sofa.png",
     "lib/comfortable_mexican_sofa.rb",
     "lib/comfortable_mexican_sofa/acts_as_tree.rb",
     "lib/comfortable_mexican_sofa/cms_tag.rb",
@@ -287,7 +294,7 @@ Gem::Specification.new do |s|
       s.add_runtime_dependency(%q<active_link_to>, [">= 0.0.6"])
       s.add_runtime_dependency(%q<paperclip>, [">= 2.3.8"])
       s.add_runtime_dependency(%q<mime-types>, [">= 0"])
-      s.add_development_dependency(%q<sqlite3-ruby>, [">= 0"])
+      s.add_development_dependency(%q<sqlite3>, [">= 0"])
       s.add_runtime_dependency(%q<rails>, [">= 3.0.3"])
       s.add_runtime_dependency(%q<active_link_to>, [">= 0.0.6"])
       s.add_runtime_dependency(%q<paperclip>, [">= 2.3.8"])
@@ -296,7 +303,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<active_link_to>, [">= 0.0.6"])
       s.add_dependency(%q<paperclip>, [">= 2.3.8"])
       s.add_dependency(%q<mime-types>, [">= 0"])
-      s.add_dependency(%q<sqlite3-ruby>, [">= 0"])
+      s.add_dependency(%q<sqlite3>, [">= 0"])
       s.add_dependency(%q<rails>, [">= 3.0.3"])
       s.add_dependency(%q<active_link_to>, [">= 0.0.6"])
       s.add_dependency(%q<paperclip>, [">= 2.3.8"])
@@ -306,7 +313,7 @@ Gem::Specification.new do |s|
     s.add_dependency(%q<active_link_to>, [">= 0.0.6"])
     s.add_dependency(%q<paperclip>, [">= 2.3.8"])
     s.add_dependency(%q<mime-types>, [">= 0"])
-    s.add_dependency(%q<sqlite3-ruby>, [">= 0"])
+    s.add_dependency(%q<sqlite3>, [">= 0"])
     s.add_dependency(%q<rails>, [">= 3.0.3"])
     s.add_dependency(%q<active_link_to>, [">= 0.0.6"])
     s.add_dependency(%q<paperclip>, [">= 2.3.8"])

data/config/initializers/comfortable_mexican_sofa.rb CHANGED

@@ -15,7 +15,8 @@ ComfortableMexicanSofa.configure do |config|
   #   config.admin_route_redirect = '/cms-admin/pages'
   # Location of YAML files that can be used to render pages instead of pulling
-  # data from the database. Not active if not specified.
+  # data from the database. Not active if not specified. Containing folder name
+  # should be the hostname of the site. Example: my-app.local
   #   config.seed_data_path = File.expand_path('db/cms_seeds', Rails.root)
   # Let CMS handle site creation and management. Enabled by default.

data/db/cms_seeds/example.local/layouts/default.yml ADDED

@@ -0,0 +1,8 @@
+label: Default Layout
+slug: default
+content: |-
+  <html>
+    <body>
+      {{ cms:page:content }}
+    </body>
+  </html>

data/db/cms_seeds/example.local/layouts/nested.yml ADDED

@@ -0,0 +1,6 @@
+label: Nested Layout
+slug: nested
+parent: default
+content: |-
+  <div class='left'> {{ cms:page:left }} </div>
+  <div class='left'> {{ cms:page:right }} </div>

data/db/cms_seeds/example.local/pages/child.yml ADDED

@@ -0,0 +1,10 @@
+label: Child Page
+parent: /
+cms_layout: default
+full_path: /child
+slug: child
+cms_blocks_attributes:
+  -
+    label: content
+    content: |-
+      Child Page Content

data/db/cms_seeds/example.local/pages/child/subchild.yml ADDED

@@ -0,0 +1,14 @@
+label: Sub-Child Page
+parent: /child
+cms_layout: nested
+full_path: /child/subchild
+slug: subchild
+cms_blocks_attributes:
+  -
+    label: left
+    content: |-
+      Sub Child Page Left Content
+  -
+    label: right
+    content: |-
+      Sub Child Page Right Content

data/db/cms_seeds/example.local/pages/index.yml ADDED

@@ -0,0 +1,11 @@
+label: Home Page
+parent:
+cms_layout: default
+full_path: /
+slug:
+cms_blocks_attributes:
+  -
+    label: content
+    content: |-
+      Home Page Content
+      {{ cms:snippet:example }}

data/db/cms_seeds/example.local/snippets/example.yml ADDED

@@ -0,0 +1,4 @@
+label: Example Snippet
+slug: example
+content: |-
+  Content for Example Snippet

data/doc/page_editing.png ADDED

Binary file

data/doc/sofa.png ADDED

Binary file

data/lib/generators/README CHANGED

@@ -13,5 +13,5 @@ Hey! Everything is almost done. Please don't forget to
   * run migrations -> `rake db:migrate`
-After that go to http://your-awesome-app/cms-admin to start
-populating content.
+After that go to http://your-awesome-app/cms-admin to start populating content.
+Default username and password are: username // password

data/lib/generators/cms_generator.rb CHANGED

@@ -27,6 +27,10 @@ class CmsGenerator < Rails::Generators::Base
     directory 'public/images/comfortable_mexican_sofa', 'public/images/comfortable_mexican_sofa'
   end
+  def generate_cms_seeds
+    directory 'db/cms_seeds', 'db/cms_seeds'
+  end
   def show_readme
     readme 'lib/generators/README'
   end

metadata CHANGED

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments:
   - 1
   - 0
-  - 43
-  version: 1.0.43
+  - 44
+  version: 1.0.44
 platform: ruby
 authors:
 - Oleg Khabarov
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
-date: 2011-02-03 00:00:00 -05:00
+date: 2011-02-07 00:00:00 -05:00
 default_executable:
 dependencies:
 - !ruby/object:Gem::Dependency
@@ -77,7 +77,7 @@ dependencies:
   prerelease: false
   version_requirements: *id004
 - !ruby/object:Gem::Dependency
-  name: sqlite3-ruby
+  name: sqlite3
   requirement: &id005 !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -204,9 +204,16 @@ files:
 - config/initializers/paperclip.rb
 - config/locales/en.yml
 - config/routes.rb
+- db/cms_seeds/example.local/layouts/default.yml
+- db/cms_seeds/example.local/layouts/nested.yml
+- db/cms_seeds/example.local/pages/child.yml
+- db/cms_seeds/example.local/pages/child/subchild.yml
+- db/cms_seeds/example.local/pages/index.yml
+- db/cms_seeds/example.local/snippets/example.yml
 - db/migrate/01_create_cms.rb
 - db/seeds.rb
-- doc/README_FOR_APP
+- doc/page_editing.png
+- doc/sofa.png
 - lib/comfortable_mexican_sofa.rb
 - lib/comfortable_mexican_sofa/acts_as_tree.rb
 - lib/comfortable_mexican_sofa/cms_tag.rb
@@ -377,7 +384,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      hash: 3545665435183444768
+      hash: -4033881371897976307
       segments:
       - 0
       version: "0"

data/doc/README_FOR_APP DELETED

@@ -1,95 +0,0 @@
-:type can be 'string', 'text', ('rich_text', 'datetime')
-< cms:page:default >
-< cms:page:label:type >   # page content that gets rendered
-< cms:field:label:type >  # page content that not rendered, but accessible via @cms_page object
-< cms:snippet:label >     # snippet content that gets rendered
-< cms:partial:path >      # interface to Rails partial
-??? pages need to be aware of tags inside of them
-MAYBE: allow html escaping based on tag definition
-Example:
---------
-parent layout:
-    <cms:field:css/>
-    <cms:field:meta_keywords/>
-    <cms:field:google_tracking/>
-    <cms:page:header>
-    <cms:page:content>   <- child layout content goes here
-    <cms:page:footer>
-child layout
-    <cms:page:left>
-    <cms:page:image:file>
-    <cms:page:right>
-Repeatable partials:
---------------------
-Stored as a serialized array data
-    <cms:group:person>
-      <person:name:string/>
-      <person:bio/>
-    </cms:group:person>
--- Person ---
-Blah: [      ]
-Meh:  [      ]
-+ add more person
--- Car ---
-Something: [     ]
-+ add more car
-File Upload Field
------------------
-< cms:page:avatar:file >
-!!! this allows uploading of files and attaches them to an Asset system. Content stores ID of the asset.
-< cms:group:person:face:file >   <- this will make many files, how to link???
-< cms:group:person:name >
-STI?? [ merging CmsTag class with CmsPageContent AR class ]
------------------------------------------------------------
-CmsPageContent <- generic old 'cms_block'
-CmsPageStringContent
-CmsPageTextContent
-CmsPageFileContent ???
-CmsGroupContent
-CmsFieldStringContent < CmsPageContent
-IRB Escaping
-------------
-< cms:partial:blsh> -> "<%= render blah %>" <-------- this is OK
-<%= blah %>                                   <-------- this is NOT OK
-Can run irb escaping after pages and snippets are expanded.
-Partials are injected later and should not be escaped.
-Rendering Process
------------------
-Layout
-  => Form
-    -> render form, with possible db content
-    -> save form
-  => Page
-    -> get defined tags
-    -> replace tags with content from db
-Page