radiant 0.8.2 → 0.9.0.rc2

data/vendor/extensions/german_language_pack/german_language_pack_extension.rb

@@ -0,0 +1,9 @@
+class GermanLanguagePackExtension < Radiant::Extension
+  version "1.0"
+  description "Provides a German translation for the Radiant admin interface"
+  url "http://yourwebsite.com/fr"
+
+  def activate
+
+  end
+end

data/vendor/extensions/german_language_pack/lib/tasks/i18n_de_extension_tasks.rake

@@ -0,0 +1,28 @@
+namespace :radiant do
+  namespace :extensions do
+    namespace :de do
+      
+      desc "Runs the migration of the I18n De extension"
+      task :migrate => :environment do
+        require 'radiant/extension_migrator'
+        if ENV["VERSION"]
+          I18nDeExtension.migrator.migrate(ENV["VERSION"].to_i)
+        else
+          I18nDeExtension.migrator.migrate
+        end
+      end
+      
+      desc "Copies public assets of the I18n De to the instance public/ directory."
+      task :update => :environment do
+        is_svn_or_dir = proc {|path| path =~ /\.svn/ || File.directory?(path) }
+        puts "Copying assets from I18nDeExtension"
+        Dir[I18nDeExtension.root + "/public/**/*"].reject(&is_svn_or_dir).each do |file|
+          path = file.sub(I18nDeExtension.root, '')
+          directory = File.dirname(path)
+          mkdir_p RAILS_ROOT + directory, :verbose => false
+          cp file, RAILS_ROOT + path, :verbose => false
+        end
+      end  
+    end
+  end
+end

data/vendor/extensions/italian_language_pack/README

@@ -0,0 +1,3 @@
+= I18n It
+
+Description goes here

data/vendor/extensions/italian_language_pack/Rakefile

@@ -0,0 +1,123 @@
+# 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? RADIANT_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/radiant/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 'rake/rdoctask'
+require 'rake/testtask'
+
+rspec_base = File.expand_path(RADIANT_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 RADIANT_ROOT constant so specs will load the environment
+Object.send(:remove_const, :RADIANT_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 it extension.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'I18nItExtension'
+  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 it 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/vendor/extensions/italian_language_pack/config/locales/it.yml

@@ -0,0 +1,184 @@
+---
+it: 
+  account: 'Account'
+  activerecord:
+    errors:
+      messages:
+        blank: 'obbligatorio' # required
+        invalid: 'formato non valido' #invalid_format
+        not_a_number: "dev'essere un numero" # must be number
+        taken: 'già utilizzato' # name_in_use
+        too_long: '{{count}} caratteri al massimo' # character_limit
+        too_short: '{{count}} caratteri al minimo' # character_minimum
+      models:
+        page:
+          attributes:
+            slug:
+              taken: 'slug già utilizzato' # slug_in_use
+        user:
+          attributes:
+            email:
+              invalid: 'indirizzo email non valido' # invalid_email
+            login:
+              taken: 'login già utilizzato' # login already in use
+            password:
+              confirmation: 'conferma password' # password_confirmation
+  add_child: 'Aggiungi pagina figlia'
+  add_part: 'Aggiungi parte'
+  add_tab: "Aggiungi tab"   
+  admin: "Amministratore" 
+  available_tags: "Tag disponibili"
+  available_tags_for: 'Tag disponibili per {{name}}'
+  body: "Body"  
+  breadcrumb: 'Traccia'
+  buttons:
+    create: "Crea {{name}}"     
+    save_and_continue: "Salva e continua"
+    save_changes: "Salva le modifiche"  
+  cancel: "Annulla"
+  change: 'Cambia'
+  close: "Chiudi"
+  content: 'Contenuto'
+  content_type: "Content-Type (tipo)"    
+  creating_status: 'Creo {{model}}…'
+  date:
+    abbr_day_names: [Do, Lu, Ma, Me, Gi, Ve, Sa]
+    abbr_month_names: [~, Gen, Feb, Mar, Apr, Mag, Giu, Lug, Ago, Set, Ott, Nov, Dic]
+    day_names: [Domenica, Lunedì, Martedì, Mercoledì, Giovedì, Venerdì, Sabato]
+    formats:
+      default: "%d.%m.%Y"
+      long: "%e. %B %Y"
+      only_day: "%e"
+      short: "%e. %b"
+    month_names: [~, Gennaio, Febbraio, Marzo, Aprile, Maggio, Giugno, Luglio, Agosto, Settembre, Ottobre, Novembre, Dicembre]
+    order: [:day, :month, :year]
+  delete_layout: "Cancella Layout"  
+  delete_pages: "Cancella {{pages}}"  
+  delete_snippet: 'Cancella Snippet'
+  delete_user: 'Cancella Utente'
+  description: 'Descrizione'
+  design: 'Design'
+  designer: 'Designer'
+  draft: "Bozza"
+  edit_layout: "Modifica Layout"
+  edit_page:  "Modifica Pagina"   
+  edit_snippet: "Modifica Snippet"
+  edit_user: "Modifica Utente"
+  email_address: 'Indirizzo Email'
+  extension: "Estensione"
+  extensions: "Estensioni" 
+  filter: "Filtro"
+  hidden: "Nascosto"
+  hide: 'Nascondi' 
+  keywords: 'Parole chiave'
+  language: "Lingua"
+  layout: "Layout"  
+  layouts: "Layout"
+  log_out: "Uscita"
+  logged_in_as: 'Accesso come'
+  login: "Login" 
+  modify: "Modifica" 
+  more: "Più"
+  name: "Nome"
+  new_layout: "Nuovo Layout"    
+  new_page: "Nuova Pagina"
+  new_password: 'Nuova Password'
+  new_snippet: "Nuovo Snippet"
+  new_user: "Nuovo Utente"  
+  no_pages: "Nessuna pagina" 
+  notes: "Note"    
+  optional: "Facoltativo"
+  or: "o"
+  page: "Pagina"     
+  page_page: 'Parte di pagina'
+  page_title: "Titolo"  
+  page_type: "Tipo di pagina"
+  pages: "Pagine"
+  pages_controller:
+    removed_many: "Le pagine sono state rimosse"   
+    removed_one: "La pagina è stata rimossa"  
+    saved: "Pagina salvata"  
+  password: "Password" 
+  password_confirmation: "Conferma password"
+  personal: 'Personale'
+  personal_preferences: 'Preferenze personali'
+  please_login: 'Prego identificarsi'
+  powered_by: 'Realizzato con'
+  preferences: "Preferenze" 
+  preferences_controller:
+    error_updating: "Errore nella modifica preferenze"   
+    updated: "Preferenze modificate"
+  published: "Pubblicato" 
+  published_at: "Pubblicato il" 
+  published_on: "Pubblicato il" 
+  reference:  "Riferimento"
+  remember_me: "Memorizza informazioni"  
+  remove: 'Rimuovi'
+  remove_layout: "Rimuovi Layout" 
+  remove_page: 'Rimuovi Pagina'
+  remove_pages: "Rimuovi {{pages}}" 
+  remove_tab: "Rimuovi tab"  
+  remove_user: 'Rimuovi utente'
+  required: "Obbligatorio"  
+  resource_controller:
+    not_found: "{{humanized_model_name}} non trovato."
+    removed: "{{humanized_model_name}} rimosso."  
+    saved: "{{humanized_model_name}} salvato."
+    update_conflict: "{{humanized_model_name}} è stato modificato dopo il salvataggio, è possibile che delle modifiche siano perse." 
+    validation_errors: "Dati non validi. Prego controllare l'esattezza e completezza dei dati."
+  reviewed: "Riveduto"
+  roles: "Ruoli"    
+  saving_changes: "Salvataggio modifiche"
+  saving_preferences: "Salvataggio preferenze"
+  scheduled: "Scheduled"
+  search_tags: 'Ricerca Tag:'
+  select:
+    inherit: "<ereditato da>"
+    none: "<nessuno>" 
+    normal: "<normale>"
+    default: '<mancanza>'
+  settings: 'Opzioni'
+  slug: 'Slug'
+  snippet: "Snippet"   
+  snippets: "Snippet"
+  status: "Stato"
+    # Warnings and info text:
+  testing: Testing
+  text:
+    layouts:
+      remove_warning: "Confermi la <strong class='warning'>cancellazione</strong> del layout salvato?"  
+    pages: 
+      remove_warning: "Confermi la <strong class='warning'>cancellazione</strong> delle pagine {{pages}}?" 
+    snippets:
+      remove_warning: "Confermi la <strong class='warning'>cancellazione</strong> dei frammenti (snippet) salvati?"   
+    users: 
+      remove_warning: "Vuoi <strong class='warning'>cancellare per sempre</strong> l'utente sottoelencato?"
+  this_file_language: "Italiano" 
+  time:
+    am: 'AM'
+    formats:
+      datetime:
+        formats:
+          default: "%Y-%m-%dT%H:%M:%S%Z"
+      default: "%a %b %d %H:%M:%S %Z %Y"   
+      long: "%B %d, %Y %H:%M"
+      only_second: "%S"
+      short: "%d %b %H:%M"
+      time: "%H:%M"
+      timestamp: "%I:%M <small>%p</small> on %B %d, %Y" 
+    pm: 'PM'
+  timestamp:
+    at: "alle"
+    by: "da"
+    last_updated: "Ultima modifica"
+  user: "Utente"
+  username: "Nome Utente"
+  users: "Utenti"      
+  users_controller:
+    cannot_delete_self: "Non puoi rimuovere te stesso!"  
+  version: "Versione"  
+  view_site: "Mostra sito"
+  website: "Sito Web"
+  welcome_controller:
+    invalid_user: "Utente o password non validi"   
+    logged_out: "Uscita effettuata"  

data/vendor/extensions/italian_language_pack/config/locales/it_available_tags.yml

@@ -0,0 +1,553 @@
+---
+it:
+  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:*
+
+      <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 Radiant 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.
+