trusty-cms 3.8.2 → 3.8.3

data/lib/generators/instance/templates/instance_generate

@@ -1,6 +0,0 @@
-#!/usr/bin/env ruby
-require File.expand_path('../../config/boot',  __FILE__)
-require 'generators/generator_base_extension'
-
-Rails::Generator::Base.prepend_sources(Rails::Generator::PathSource.new(:builtin, "#{TrustyCms.root}/lib/generators"))
-require 'commands/generate'

data/lib/generators/instance/templates/instance_radiant_config.rb

@@ -1,16 +0,0 @@
-TrustyCms.config do |config|
-  # this file can be used to set defaults, options and validation rules for local configuration settings.
-  # core settings are defined in TRUSTY_CMS_ROOT/config/initializers/radiant_config.rb and by the corresponding
-  # file in each radiant extension. You probably don't need to add anything here, but in case you do:
-
-  # config.define 'site.show_footer?', :default => "true"
-  # config.define 'S3.bucket', :default => "key", :allow_change => false
-
-  # you can also use this file to set config values (by environment, for example):
-
-  # if Rails.env == 'production'
-  #   config['cache.duration'] = 86400
-  # else
-  #   config['cache.duration'] = 0
-  # end
-end

data/lib/generators/instance/templates/instance_rakefile

@@ -1,3 +0,0 @@
-require File.join(File.dirname(__FILE__), 'config', 'boot')
-
-import File.join(TRUSTY_CMS_ROOT, 'Rakefile')

data/lib/generators/instance/templates/instance_routes.rb

@@ -1 +0,0 @@
-load File.join(TRUSTY_CMS_ROOT, "config", "routes.rb")

data/lib/generators/language_extension/USAGE

@@ -1,27 +0,0 @@
-Description:
-    The language_extension generator creates stubs for a new TrustyCms translation.
-
-    The generator takes an language abbreviation as its argument.  The extension name may be
-    given as a language abbreviation 'en' or a localized abbreviation 'en-GB' and should not 
-    be prefixed with 'i18n' or suffixed with 'Extension'.
-
-    The generator creates an extension directory in vendor/extensions that includes
-    i18n_<extension_name>_extension.rb, README and Rakefile files as well as lib, task,
-    and test directories.
-
-Example:
-    ./script/generate language_extension fr 
-
-    This will create:
-    vendor/extensions/i18n_fr/config/locales/fr.yml
-    vendor/extensions/i18n_fr/lib/tasks
-    vendor/extensions/i18n_fr/README
-    vendor/extensions/i18n_fr/i18n_fr_extension.rb
-    vendor/extensions/i18n_fr/lib/tasks/i18n_fr_extension_tasks.rake
-    vendor/extensions/i18n_fr/spec/controllers
-    vendor/extensions/i18n_fr/spec/models
-    vendor/extensions/i18n_fr/spec/views
-    vendor/extensions/i18n_fr/spec/helpers
-    vendor/extensions/i18n_fr/Rakefile
-    vendor/extensions/i18n_fr/spec/spec_helper.rb
-    vendor/extensions/i18n_fr/spec/spec.opts

data/lib/generators/language_extension/language_extension_generator.rb

@@ -1,71 +0,0 @@
-class LanguageExtensionGenerator < Rails::Generator::NamedBase
-  default_options :with_test_unit => false
-
-  attr_reader :extension_path, :extension_file_name, :localization_name
-
-  def initialize(runtime_args, runtime_options = {})
-    super
-    @extension_file_name = "#{file_name}_language_pack_extension"
-    @extension_path = "vendor/extensions/#{file_name}_language_pack"
-    @localization_name = localization_name
-  end
-
-  def manifest
-    record do |m|
-      m.directory "#{extension_path}/config/locales"
-      m.directory "#{extension_path}/lib/tasks"
-
-      m.template 'README',                "#{extension_path}/README"
-      m.template 'extension.rb',          "#{extension_path}/#{extension_file_name}.rb"
-      # m.template 'tasks.rake',            "#{extension_path}/lib/tasks/#{extension_file_name}_tasks.rake"
-      m.template 'lang.yml',              "#{extension_path}/config/locales/#{localization_name}.yml"
-      m.template 'available_tags.yml',    "#{extension_path}/config/locales/#{localization_name}_available_tags.yml"
-      m.template 'lib.rb',                "#{extension_path}/lib/radiant-#{file_name}_language_pack-extension.rb"
-      m.template 'gemspec.rb',            "#{extension_path}/radiant-#{file_name}_language_pack-extension.gemspec"
-    end
-
-  end
-
-  def class_name
-    super.to_name.gsub(' ', '') + 'LanguagePackExtension'
-  end
-
-  def extension_name
-    class_name.to_name('Extension')
-  end
-
-  def author_info
-    @author_info ||= begin
-      Git.global_config
-    rescue NameError
-      {}
-    end
-  end
-
-  def homepage
-    author_info['github.user'] ? "http://github.com/#{author_info['github.user']}/radiant-#{file_name}-extension" : "http://example.com/#{file_name}"
-  end
-
-  def author_email
-    author_info['user.email'] || 'your email'
-  end
-
-  def author_name
-    author_info['user.name'] || 'Your Name'
-  end
-
-  def add_options!(opt)
-    # opt.separator ''
-    # opt.separator 'Options:'
-    # opt.on("--with-test-unit",
-    #        "Use Test::Unit for this extension instead of RSpec") { |v| options[:with_test_unit] = v }
-  end
-
-  def localization_name
-    file_name.split('_')[1] ? "#{file_name.split('_')[0]}-#{file_name.split('_')[1].upcase}" : file_name
-  end
-
-  def copy_files
-    FileUtils.cp("#{TRUSTY_CMS_ROOT}/config/locales/en_available_tags.yml","#{TRUSTY_CMS_ROOT}/#{extension_path}/config/locales/#{localization_name}_available_tags.yml")
-  end
-end

data/lib/generators/language_extension/templates/README

@@ -1,3 +0,0 @@
-= <%= extension_name %>
-
-Description goes here

data/lib/generators/language_extension/templates/RSpecRakefile

@@ -1,123 +0,0 @@
-# I think this is the one that should be moved to the extension Rakefile template
-
-# In rails 1.2, plugins aren't available in the path until they're loaded.
-# Check to see if the rspec plugin is installed first and require
-# it if it is.  If not, use the gem version.
-
-# Determine where the RSpec plugin is by loading the boot
-unless defined? TRUSTY_CMS_ROOT
-  ENV["Rails.env"] = "test"
-  case
-  when ENV["RADIANT_ENV_FILE"]
-    require File.dirname(ENV["RADIANT_ENV_FILE"]) + "/boot"
-  when File.dirname(__FILE__) =~ %r{vendor/trusty_cms/vendor/extensions}
-    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../../../")}/config/boot"
-  else
-    require "#{File.expand_path(File.dirname(__FILE__) + "/../../../")}/config/boot"
-  end
-end
-
-require 'rake'
-require 'rdoc/task'
-require 'rake/testtask'
-
-rspec_base = File.expand_path(TRUSTY_CMS_ROOT + '/vendor/plugins/rspec/lib')
-$LOAD_PATH.unshift(rspec_base) if File.exist?(rspec_base)
-require 'spec/rake/spectask'
-require 'cucumber'
-require 'cucumber/rake/task'
-
-# Cleanup the TRUSTY_CMS_ROOT constant so specs will load the environment
-Object.send(:remove_const, :TRUSTY_CMS_ROOT)
-
-extension_root = File.expand_path(File.dirname(__FILE__))
-
-task :default => :spec
-task :stats => "spec:statsetup"
-
-desc "Run all specs in spec directory"
-Spec::Rake::SpecTask.new(:spec) do |t|
-  t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
-  t.spec_files = FileList['spec/**/*_spec.rb']
-end
-
-task :features => 'spec:integration'
-
-namespace :spec do
-  desc "Run all specs in spec directory with RCov"
-  Spec::Rake::SpecTask.new(:rcov) do |t|
-    t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
-    t.spec_files = FileList['spec/**/*_spec.rb']
-    t.rcov = true
-    t.rcov_opts = ['--exclude', 'spec', '--rails']
-  end
-  
-  desc "Print Specdoc for all specs"
-  Spec::Rake::SpecTask.new(:doc) do |t|
-    t.spec_opts = ["--format", "specdoc", "--dry-run"]
-    t.spec_files = FileList['spec/**/*_spec.rb']
-  end
-
-  [:models, :controllers, :views, :helpers].each do |sub|
-    desc "Run the specs under spec/#{sub}"
-    Spec::Rake::SpecTask.new(sub) do |t|
-      t.spec_opts = ['--options', "\"#{extension_root}/spec/spec.opts\""]
-      t.spec_files = FileList["spec/#{sub}/**/*_spec.rb"]
-    end
-  end
-  
-  desc "Run the Cucumber features"
-  Cucumber::Rake::Task.new(:integration) do |t|
-    t.fork = true
-    t.cucumber_opts = ['--format', (ENV['CUCUMBER_FORMAT'] || 'pretty')]
-    # t.feature_pattern = "#{extension_root}/features/**/*.feature"
-    t.profile = "default"
-  end
-
-  # Setup specs for stats
-  task :statsetup do
-    require 'code_statistics'
-    ::STATS_DIRECTORIES << %w(Model\ specs spec/models)
-    ::STATS_DIRECTORIES << %w(View\ specs spec/views)
-    ::STATS_DIRECTORIES << %w(Controller\ specs spec/controllers)
-    ::STATS_DIRECTORIES << %w(Helper\ specs spec/views)
-    ::CodeStatistics::TEST_TYPES << "Model specs"
-    ::CodeStatistics::TEST_TYPES << "View specs"
-    ::CodeStatistics::TEST_TYPES << "Controller specs"
-    ::CodeStatistics::TEST_TYPES << "Helper specs"
-    ::STATS_DIRECTORIES.delete_if {|a| a[0] =~ /test/}
-  end
-
-  namespace :db do
-    namespace :fixtures do
-      desc "Load fixtures (from spec/fixtures) into the current environment's database.  Load specific fixtures using FIXTURES=x,y"
-      task :load => :environment do
-        require 'active_record/fixtures'
-        ActiveRecord::Base.establish_connection(Rails.env.to_sym)
-        (ENV['FIXTURES'] ? ENV['FIXTURES'].split(/,/) : Dir.glob(File.join(Rails.root, 'spec', 'fixtures', '*.{yml,csv}'))).each do |fixture_file|
-          Fixtures.create_fixtures('spec/fixtures', File.basename(fixture_file, '.*'))
-        end
-      end
-    end
-  end
-end
-
-desc 'Generate documentation for the <%= file_name %> extension.'
-RDoc:Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = '<%= class_name %>'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-# For extensions that are in transition
-desc 'Test the <%= file_name %> extension.'
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = true
-end
-
-# Load any custom rakefiles for extension
-Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/lib/generators/language_extension/templates/Rakefile

@@ -1,25 +0,0 @@
-require 'rake'
-require 'rake/testtask'
-require 'rdoc/task'
-
-desc 'Default: run unit tests.'
-task :default => :test
-
-desc 'Test the <%= file_name %> extension.'
-Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
-  t.pattern = 'test/**/*_test.rb'
-  t.verbose = true
-end
-
-desc 'Generate documentation for the <%= file_name %> extension.'
-RDoc:Task.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = '<%= class_name %>'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-# Load any custom rakefiles for extension
-Dir[File.dirname(__FILE__) + '/tasks/*.rake'].sort.each { |f| require f }

data/lib/generators/language_extension/templates/available_tags.yml

@@ -1,553 +0,0 @@
----
-<%= localization_name %>:
-  desc:
-    author:
-      Renders the name of the author of the current page.
-
-    breadcrumb:
-        Renders the @breadcrumb@ attribute of the current page.
-
-    breadcrumbs:
-      Renders a trail of breadcrumbs to the current page. The separator attribute
-      specifies the HTML fragment that is inserted between each of the breadcrumbs. By
-      default it is set to @>@. The boolean nolinks attribute can be specified to render
-      breadcrumbs in plain text, without any links (useful when generating title tag).
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;breadcrumbs [separator="separator_string"] [nolinks="true"] /></code></pre>
-
-    children-count:
-      Renders the total number of children.
-
-    children-each-child:
-      Page attribute tags inside of this tag refer to the current child. This is occasionally
-      useful if you are inside of another tag (like &lt;r&#58;find&gt;) and need to refer back to the
-      current child.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;child>...</r&#58;child>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-    children-each-header:
-      Renders the tag contents only if the contents do not match the previous header. This
-      is extremely useful for rendering date headers for a list of child pages.
-
-      If you would like to use several header blocks you may use the @name@ attribute to
-      name the header. When a header is named it will not restart until another header of
-      the same name is different.
-
-      Using the @restart@ attribute you can cause other named headers to restart when the
-      present header changes. Simply specify the names of the other headers in a semicolon
-      separated list.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;header [name="header_name"] [restart="name1[;name2;...]"]>
-            ...
-        </r&#58;header>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-    children-each-if_first:
-      Renders the tag contents only if the current page is the first child in the context of
-      a children&#58;each tag
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;if_first >
-            ...
-        </r&#58;if_first>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-
-    children-each-if_last:
-      Renders the tag contents only if the current page is the last child in the context of
-      a children&#58;each tag
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;if_last >
-            ...
-        </r&#58;if_last>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-
-    children-each-unless_first:
-      Renders the tag contents unless the current page is the first child in the context of
-      a children&#58;each tag
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;unless_first >
-            ...
-        </r&#58;unless_first>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-
-    children-each-unless_last:
-      Renders the tag contents unless the current page is the last child in the context of
-      a children&#58;each tag
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each>
-        <r&#58;unless_last >
-            ...
-        </r&#58;unless_last>
-      </r&#58;children&#58;each>
-      </code></pre>
-
-
-    children-each:
-      Cycles through each of the children. Inside this tag all page attribute tags
-      are mapped to the current child page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;each [offset="number"] [limit="number"]
-       [by="published_at|updated_at|created_at|slug|title|keywords|description"]
-       [order="asc|desc"] [status="draft|reviewed|published|hidden|all"]>
-       ...
-      </r&#58;children&#58;each>
-      </code></pre>
-
-    children-first:
-      Returns the first child. Inside this tag all page attribute tags are mapped to
-      the first child. Takes the same ordering options as @<r&#58;children&#58;each>@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;first>...</r&#58;children&#58;first></code></pre>
-
-    children-last:
-      Returns the last child. Inside this tag all page attribute tags are mapped to
-      the last child. Takes the same ordering options as @<r&#58;children&#58;each>@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children&#58;last>...</r&#58;children&#58;last></code></pre>
-
-    children:
-      Gives access to a page's children.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;children>...</r&#58;children></code></pre>
-
-    comment:
-      Nothing inside a set of comment tags is rendered.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;comment>...</r&#58;comment></code></pre>
-
-    content:
-      Renders the main content of a page. Use the @part@ attribute to select a specific
-      page part. By default the @part@ attribute is set to body. Use the @inherit@
-      attribute to specify that if a page does not have a content part by that name that
-      the tag should render the parent's content part. By default @inherit@ is set to
-      @false@. Use the @contextual@ attribute to force a part inherited from a parent
-      part to be evaluated in the context of the child page. By default 'contextual'
-      is set to true.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;content [part="part_name"] [inherit="true|false"] [contextual="true|false"] /></code></pre>
-
-    cycle:
-      Renders one of the passed values based on a global cycle counter.  Use the @reset@
-      attribute to reset the cycle to the beginning.  Use the @name@ attribute to track
-      multiple cycles; the default is @cycle@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;cycle values="first, second, third" [reset="true|false"] [name="cycle"] /></code></pre>
-
-    date:
-      Renders the date based on the current page (by default when it was published or created).
-      The format attribute uses the same formating codes used by the Ruby @strftime@ function. By
-      default it's set to @&#37;A, &#37;B &#37;d, &#37;Y@.  The @for@ attribute selects which date to render.  Valid
-      options are @published_at@, @created_at@, @updated_at@, and @now@. @now@ will render the
-      current date/time, regardless of the  page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;date [format="&#37;A, &#37;B &#37;d, &#37;Y"] [for="published_at"]/></code></pre>
-
-    escape_html:
-      Escapes angle brackets, etc. for rendering in an HTML document.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;escape_html>...</r&#58;escape_html></code></pre>
-
-    find:
-      Inside this tag all page related tags refer to the page found at the @url@ attribute.
-      @url@s may be relative or absolute paths.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;find url="value_to_find">...</r&#58;find></code></pre>
-
-    if_ancestor_or_self:
-      Renders the contained elements if the current contextual page is either the actual page or one of its parents.
-
-      This is typically used inside another tag (like &lt;r&#58;children&#58;each&gt;) to add conditional mark-up if the child element is or descends from the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_ancestor_or_self>...</r&#58;if_ancestor_or_self></code></pre>
-
-    if_children:
-      Renders the contained elements only if the current contextual page has one or
-      more child pages.  The @status@ attribute limits the status of found child pages
-      to the given status, the default is @"published"@. @status="all"@ includes all
-      non-virtual pages regardless of status.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_children [status="published"]>...</r&#58;if_children></code></pre>
-
-    if_content:
-      Renders the containing elements if all of the listed parts exist on a page.
-      By default the @part@ attribute is set to @body@, but you may list more than one
-      part by separating them with a comma. Setting the optional @inherit@ to true will
-      search ancestors independently for each part. By default @inherit@ is set to @false@.
-
-      When listing more than one part, you may optionally set the @find@ attribute to @any@
-      so that it will render the containing elements if any of the listed parts are found.
-      By default the @find@ attribute is set to @all@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_content [part="part_name, other_part"] [inherit="true"] [find="any"]>...</r&#58;if_content></code></pre>
-
-    if_dev:
-      Renders the containing elements only if TrustyCms in is development mode.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_dev>...</r&#58;if_dev></code></pre>
-
-    if_parent:
-      Renders the contained elements only if the current contextual page has a parent, i.e.
-      is not the root page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_parent>...</r&#58;if_parent></code></pre>
-
-    if_self:
-      Renders the contained elements if the current contextual page is also the actual page.
-
-      This is typically used inside another tag (like &lt;r&#58;children&#58;each&gt;) to add conditional mark-up if the child element is the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_self>...</r&#58;if_self></code></pre>
-
-    if_url:
-      Renders the containing elements only if the page's url matches the regular expression
-      given in the @matches@ attribute. If the @ignore_case@ attribute is set to false, the
-      match is case sensitive. By default, @ignore_case@ is set to true.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;if_url matches="regexp" [ignore_case="true|false"]>...</r&#58;if_url></code></pre>
-
-    link:
-      Renders a link to the page. When used as a single tag it uses the page's title
-      for the link name. When used as a double tag the part in between both tags will
-      be used as the link text. The link tag passes all attributes over to the HTML
-      @a@ tag. This is very useful for passing attributes like the @class@ attribute
-      or @id@ attribute. If the @anchor@ attribute is passed to the tag it will
-      append a pound sign (<code>#</code>) followed by the value of the attribute to
-      the @href@ attribute of the HTML @a@ tag--effectively making an HTML anchor.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;link [anchor="name"] [other attributes...] /></code></pre>
-
-      or
-
-      <pre><code><r&#58;link [anchor="name"] [other attributes...]>link text here</r&#58;link></code></pre>
-
-    markdown:
-      Filters its contents with the Markdown filter.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;markdown>** bold text **</r&#58;markdown></code></pre>
-
-      produces
-
-      <pre><code><strong> bold text </strong></code></pre>
-
-    meta-description:
-      Emits the page description field in a meta tag, unless attribute
-      'tag' is set to 'false'.
-
-      *Usage&#58;*
-
-      <pre><code> <r&#58;meta&#58;description [tag="false"] /> </code></pre>
-
-    meta-keywords:
-      Emits the page keywords field in a meta tag, unless attribute
-      'tag' is set to 'false'.
-
-      *Usage&#58;*
-
-      <pre><code> <r&#58;meta&#58;keywords [tag="false"] /> </code></pre>
-
-    meta:
-      The namespace for 'meta' attributes.  If used as a singleton tag, both the description
-      and keywords fields will be output as &lt;meta /&gt; tags unless the attribute 'tag' is set to 'false'.
-
-      *Usage&#58;*
-
-      <pre><code> <r&#58;meta [tag="false"] />
-       <r&#58;meta>
-         <r&#58;description [tag="false"] />
-         <r&#58;keywords [tag="false"] />
-       </r&#58;meta>
-      </code></pre>
-
-    navigation-if_first:
-      Renders the containing elements if the element is the first
-      in the navigation list
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;normal><r&#58;if_first>...</r&#58;if_first></r&#58;normal></code></pre>
-
-    navigation-if_last:
-      Renders the containing elements if the element is the last
-      in the navigation list
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;normal><r&#58;if_last>...</r&#58;if_last></r&#58;normal></code></pre>
-
-    navigation:
-      Renders a list of links specified in the @urls@ attribute according to three
-      states&#58;
-
-      * @normal@ specifies the normal state for the link
-      * @here@ specifies the state of the link when the url matches the current
-         page's URL
-      * @selected@ specifies the state of the link when the current page matches
-         is a child of the specified url
-      # @if_last@ renders its contents within a @normal@, @here@ or
-        @selected@ tag if the item is the last in the navigation elements
-      # @if_first@ renders its contents within a @normal@, @here@ or
-        @selected@ tag if the item is the first in the navigation elements
-
-      The @between@ tag specifies what should be inserted in between each of the links.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;navigation urls="[Title&#58; url | Title&#58; url | ...]">
-        <r&#58;normal><a href="<r&#58;url />"><r&#58;title /></a></r&#58;normal>
-        <r&#58;here><strong><r&#58;title /></strong></r&#58;here>
-        <r&#58;selected><strong><a href="<r&#58;url />"><r&#58;title /></a></strong></r&#58;selected>
-        <r&#58;between> | </r&#58;between>
-      </r&#58;navigation>
-      </code></pre>
-
-    page:
-      Causes the tags referring to a page's attributes to refer to the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;page>...</r&#58;page></code></pre>
-
-    parent:
-      Page attribute tags inside this tag refer to the parent of the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;parent>...</r&#58;parent></code></pre>
-
-    random:
-      Randomly renders one of the options specified by the @option@ tags.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;random>
-        <r&#58;option>...</r&#58;option>
-        <r&#58;option>...</r&#58;option>
-        ...
-      <r&#58;random>
-      </code></pre>
-
-    rfc1123_date:
-      Outputs the published date using the format mandated by RFC 1123. (Ideal for RSS feeds.)
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;rfc1123_date /></code></pre>
-
-    slug:
-        Renders the @slug@ attribute of the current page.
-
-    smarty_pants:
-      Filters its contents with the SmartyPants filter.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;smarty_pants>"A revolutionary quotation."</r&#58;smarty_pants></code></pre>
-
-      produces
-
-      <pre><code>&#8220;A revolutionary quotation.&#8221;</code></pre>
-
-    snippet:
-      Renders the snippet specified in the @name@ attribute within the context of a page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;snippet name="snippet_name" /></code></pre>
-
-      When used as a double tag, the part in between both tags may be used within the
-      snippet itself, being substituted in place of @<r&#58;yield/>@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;snippet name="snippet_name">Lorem ipsum dolor...</r&#58;snippet></code></pre>
-
-    status:
-      Prints the page's status as a string.  Optional attribute 'downcase'
-      will cause the status to be all lowercase.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;status [downcase='true'] /></code></pre>
-
-    textile:
-      Filters its contents with the Textile filter.
-
-      *Usage*&#58;
-
-      <pre><code><r&#58;textile>
-      * First
-      * Second
-      </r&#58;textile></code></pre>
-
-      produces&#58;
-
-      <pre><code><ul>
-        <li>First</li>
-        <li>Second</li>
-      </ul></code></pre>
-
-    title:
-        Renders the @title@ attribute of the current page.
-
-    unless_ancestor_or_self:
-      Renders the contained elements unless the current contextual page is either the actual page or one of its parents.
-
-      This is typically used inside another tag (like &lt;r&#58;children&#58;each&gt;) to add conditional mark-up unless the child element is or descends from the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_ancestor_or_self>...</r&#58;unless_ancestor_or_self></code></pre>
-
-    unless_children:
-      Renders the contained elements only if the current contextual page has no children.
-      The @status@ attribute limits the status of found child pages to the given status,
-      the default is @"published"@. @status="all"@ includes all non-virtual pages
-      regardless of status.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_children [status="published"]>...</r&#58;unless_children></code></pre>
-
-    unless_content:
-      The opposite of the @if_content@ tag. It renders the contained elements if all of the
-      specified parts do not exist. Setting the optional @inherit@ to true will search
-      ancestors independently for each part. By default @inherit@ is set to @false@.
-
-      When listing more than one part, you may optionally set the @find@ attribute to @any@
-      so that it will not render the containing elements if any of the listed parts are found.
-      By default the @find@ attribute is set to @all@.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_content [part="part_name, other_part"] [inherit="false"] [find="any"]>...</r&#58;unless_content></code></pre>
-
-    unless_dev:
-      The opposite of the @if_dev@ tag.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_dev>...</r&#58;unless_dev></code></pre>
-
-    unless_parent:
-      Renders the contained elements only if the current contextual page has no parent, i.e.
-      is the root page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_parent>...</r&#58;unless_parent></code></pre>
-
-    unless_self:
-      Renders the contained elements unless the current contextual page is also the actual page.
-
-      This is typically used inside another tag (like &lt;r&#58;children&#58;each&gt;) to add conditional mark-up unless the child element is the current page.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_self>...</r&#58;unless_self></code></pre>
-
-    unless_url:
-      The opposite of the @if_url@ tag.
-
-      *Usage&#58;*
-
-      <pre><code><r&#58;unless_url matches="regexp" [ignore_case="true|false"]>...</r&#58;unless_url></code></pre>
-
-    url:
-      Renders the @url@ attribute of the current page.
-
-    yield:
-      Used within a snippet as a placeholder for substitution of child content, when
-      the snippet is called as a double tag.
-
-      *Usage (within a snippet)&#58;*
-
-      <pre><code>
-      <div id="outer">
-        <p>before</p>
-        <r&#58;yield/>
-        <p>after</p>
-      </div>
-      </code></pre>
-
-      If the above snippet was named "yielding", you could call it from any Page,
-      Layout or Snippet as follows&#58;
-
-      <pre><code><r&#58;snippet name="yielding">Content within</r&#58;snippet></code></pre>
-
-      Which would output the following&#58;
-
-      <pre><code>
-      <div id="outer">
-        <p>before</p>
-        Content within
-        <p>after</p>
-      </div>
-      </code></pre>
-
-      When called in the context of a Page or a Layout, @<r&#58;yield/>@ outputs nothing.
-